src/function_registry.ts

// Copyright 2021 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//      http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

import {
  HttpFunction,
  CloudEventFunction,
  HandlerFunction,
  CloudEventFunctionWithCallback,
} from './functions';
import {SignatureType} from './types';

interface RegisteredFunction<T> {
  signatureType: SignatureType;
  userFunction: HandlerFunction<T>;
}

/**
 * Singleton map to hold the registered functions
 */
// eslint-disable-next-line @typescript-eslint/no-explicit-any
const registrationContainer = new Map<string, RegisteredFunction<any>>();

/**
 * Helper method to store a registered function in the registration container
 */
const register = <T = unknown, U = unknown>(
  functionName: string,
  signatureType: SignatureType,
  userFunction: HandlerFunction<T>,
): void => {
  if (!isValidFunctionName(functionName)) {
    throw new Error(`Invalid function name: ${functionName}`);
  }

  registrationContainer.set(functionName, {
    signatureType,
    userFunction,
  });
};

/**
 * Returns true if the function name is valid
 * - must contain only alphanumeric, numbers, or dash characters
 * - must be <= 63 characters
 * - must start with a letter
 * - must end with a letter or number
 * @param functionName - The function name
 * @returns true if the function name is valid
 */
export const isValidFunctionName = (functionName: string): boolean => {
  // Validate function name with alpha characters, and dashes
  const regex = /^[A-Za-z](?:[-_A-Za-z0-9]{0,61}[A-Za-z0-9])?$/;
  return regex.test(functionName);
};

/**
 * Get a declaratively registered function
 * @param functionName - The name with which the function was registered
 * @returns The registered function and signature type or undefined no function matching
 * the provided name has been registered
 */
export const getRegisteredFunction = (
  functionName: string,
  // eslint-disable-next-line @typescript-eslint/no-explicit-any
): RegisteredFunction<any> | undefined => {
  return registrationContainer.get(functionName);
};

/**
 * Register a function that responds to HTTP requests.
 * @param functionName - The name of the function
 * @param handler - The function to invoke when handling HTTP requests
 * @public
 */
export const http = (functionName: string, handler: HttpFunction): void => {
  register(functionName, 'http', handler);
};

/**
 * Register a function that handles CloudEvents.
 * @param functionName - The name of the function
 * @param handler - The function to trigger when handling CloudEvents
 * @public
 */
export const cloudEvent = <T = unknown>(
  functionName: string,
  handler: CloudEventFunction<T> | CloudEventFunctionWithCallback<T>,
): void => {
  register(functionName, 'cloudevent', handler);
};