@empire-builder-kit/runtime 1.0.0-beta.8 → 1.0.0-rc.1

package/src/api-contract/schema.d.ts

@@ -0,0 +1,81 @@
+export declare const JSON_SCHEMA_2020_12_DIALECT: "https://json-schema.org/draft/2020-12/schema";
+export declare const API_HTTP_HEADER_VALUE_FORMAT: "ebk-http-header-value";
+export declare const API_HTTP_HEADER_VALUE_MAX_LENGTH: number;
+export declare const API_HTTP_HEADER_VALUE_PATTERN: "^[!-~](?:[ -~]*[!-~])?(?![\\s\\S])";
+export declare function isCanonicalApiHttpHeaderValue(value: string): boolean;
+export type JsonSchemaPrimitiveType = 'array' | 'boolean' | 'integer' | 'null' | 'number' | 'object' | 'string';
+export interface JsonSchema202012 {
+    $ref?: string;
+    $schema?: typeof JSON_SCHEMA_2020_12_DIALECT;
+    additionalProperties?: boolean | JsonSchema202012;
+    const?: boolean | null | number | string;
+    description?: string;
+    enum?: readonly (boolean | null | number | string)[];
+    format?: string;
+    items?: JsonSchema202012;
+    maxItems?: number;
+    maxLength?: number;
+    maximum?: number;
+    minItems?: number;
+    minLength?: number;
+    minimum?: number;
+    oneOf?: readonly JsonSchema202012[];
+    pattern?: string;
+    properties?: Readonly<Record<string, JsonSchema202012>>;
+    required?: readonly string[];
+    type?: JsonSchemaPrimitiveType | readonly JsonSchemaPrimitiveType[];
+}
+export interface ApiSchema<T> {
+    readonly jsonSchema: JsonSchema202012;
+    /**
+     * Parses untrusted request input and rejects undeclared object fields.
+     */
+    parse(value: unknown, path?: string): T;
+    /**
+     * Parses a response received by a client while ignoring additive object
+     * fields that an older compatible client does not know.
+     */
+    parseResponse(value: unknown, path?: string): T;
+    /**
+     * Validates a producer response and projects only declared fields.
+     */
+    project(value: unknown, path?: string): T;
+}
+export interface OptionalApiSchema<T> {
+    readonly optional: true;
+    readonly schema: ApiSchema<T>;
+}
+type InferSchema<T> = T extends ApiSchema<infer V> ? V : T extends OptionalApiSchema<infer V> ? V : never;
+type ObjectProperty = ApiSchema<unknown> | OptionalApiSchema<unknown>;
+type RequiredKeys<T extends Record<string, ObjectProperty>> = {
+    [K in keyof T]: T[K] extends OptionalApiSchema<unknown> ? never : K;
+}[keyof T];
+type OptionalKeys<T extends Record<string, ObjectProperty>> = {
+    [K in keyof T]: T[K] extends OptionalApiSchema<unknown> ? K : never;
+}[keyof T];
+export type InferObjectSchema<T extends Record<string, ObjectProperty>> = {
+    [K in RequiredKeys<T>]: InferSchema<T[K]>;
+} & {
+    [K in OptionalKeys<T>]?: InferSchema<T[K]>;
+};
+export declare function apiString(inputOptions?: {
+    enum?: readonly string[];
+    format?: 'uuid' | typeof API_HTTP_HEADER_VALUE_FORMAT;
+    maxLength?: number;
+    minLength?: number;
+}): ApiSchema<string>;
+export declare function apiNumber(inputOptions?: {
+    integer?: boolean;
+    maximum?: number;
+    minimum?: number;
+}): ApiSchema<number>;
+export declare function apiBoolean(): ApiSchema<boolean>;
+export declare function apiLiteral<const T extends boolean | number | string>(literal: T): ApiSchema<T>;
+export declare function apiArray<T>(item: ApiSchema<T>, inputOptions?: {
+    maxItems?: number;
+    minItems?: number;
+}): ApiSchema<T[]>;
+export declare function apiOptional<T>(value: ApiSchema<T>): OptionalApiSchema<T>;
+export declare function apiNullable<T>(value: ApiSchema<T>): ApiSchema<T | null>;
+export declare function apiObject<const T extends Record<string, ApiSchema<unknown> | OptionalApiSchema<unknown>>>(properties: T): ApiSchema<InferObjectSchema<T>>;
+export {};

package/src/api-contract/schema.js

@@ -0,0 +1,313 @@
+import { ApiContractError } from './errors.js';
+export const JSON_SCHEMA_2020_12_DIALECT = 'https://json-schema.org/draft/2020-12/schema';
+export const API_HTTP_HEADER_VALUE_FORMAT = 'ebk-http-header-value';
+export const API_HTTP_HEADER_VALUE_MAX_LENGTH = 8 * 1024;
+export const API_HTTP_HEADER_VALUE_PATTERN = '^[!-~](?:[ -~]*[!-~])?(?![\\s\\S])';
+export function isCanonicalApiHttpHeaderValue(value) {
+    if (value.length < 1 || value.length > API_HTTP_HEADER_VALUE_MAX_LENGTH) {
+        return false;
+    }
+    for (let index = 0; index < value.length; index += 1) {
+        const code = value.charCodeAt(index);
+        if (code < (index === 0 || index === value.length - 1 ? 0x21 : 0x20) ||
+            code > 0x7e) {
+            return false;
+        }
+    }
+    return true;
+}
+const apiSchemaRuntimeBrand = Symbol.for('@empire-builder-kit/runtime/api-schema-v1');
+const reservedObjectPropertyNames = new Set([
+    '__proto__',
+    'constructor',
+    'prototype',
+]);
+function freezeJsonSchema(value) {
+    for (const entry of Object.values(value)) {
+        if (Array.isArray(entry)) {
+            for (const member of entry) {
+                if (member && typeof member === 'object') {
+                    freezeJsonSchema(member);
+                }
+            }
+            Object.freeze(entry);
+        }
+        else if (entry && typeof entry === 'object') {
+            freezeJsonSchema(entry);
+        }
+    }
+    return Object.freeze(value);
+}
+function fail(path, message) {
+    throw new ApiContractError('api-schema-validation-failed', `${path} ${message}`);
+}
+function schema(jsonSchema, parseMode, project) {
+    const apiSchema = {
+        jsonSchema: freezeJsonSchema(jsonSchema),
+        parse: (value, path = 'value') => parseMode(value, path, 'request'),
+        parseMode,
+        parseResponse: (value, path = 'value') => parseMode(value, path, 'response'),
+        project: project !== null && project !== void 0 ? project : ((value, path = 'value') => parseMode(value, path, 'request')),
+    };
+    Object.defineProperty(apiSchema, apiSchemaRuntimeBrand, {
+        enumerable: false,
+        value: true,
+    });
+    return Object.freeze(apiSchema);
+}
+function internal(value) {
+    const candidate = value;
+    if (!value ||
+        typeof value !== 'object' ||
+        candidate[apiSchemaRuntimeBrand] !== true ||
+        typeof candidate.parseMode !== 'function') {
+        throw new ApiContractError('api-contract-invalid', 'API schema composition accepts only EBK API schemas.');
+    }
+    return candidate;
+}
+function validateLengthOption(minimum, maximum, label) {
+    if ((minimum !== undefined &&
+        (!Number.isSafeInteger(minimum) || minimum < 0)) ||
+        (maximum !== undefined &&
+            (!Number.isSafeInteger(maximum) || maximum < 0)) ||
+        (minimum !== undefined && maximum !== undefined && minimum > maximum)) {
+        throw new ApiContractError('api-contract-invalid', `${label} bounds must be ordered non-negative safe integers.`);
+    }
+}
+export function apiString(inputOptions = {}) {
+    var _a, _b, _c, _d;
+    if (!inputOptions ||
+        typeof inputOptions !== 'object' ||
+        Array.isArray(inputOptions)) {
+        throw new ApiContractError('api-contract-invalid', 'String schema options must be a plain record.');
+    }
+    const inputRecord = inputOptions;
+    const inputPrototype = Object.getPrototypeOf(inputOptions);
+    const allowedOptionKeys = new Set([
+        'enum',
+        'format',
+        'maxLength',
+        'minLength',
+    ]);
+    if (inputPrototype !== Object.prototype && inputPrototype !== null) {
+        throw new ApiContractError('api-contract-invalid', 'String schema options must use a plain or null prototype.');
+    }
+    for (const key of Reflect.ownKeys(inputRecord)) {
+        const descriptor = Object.getOwnPropertyDescriptor(inputRecord, key);
+        if (typeof key !== 'string' ||
+            !allowedOptionKeys.has(key) ||
+            !(descriptor === null || descriptor === void 0 ? void 0 : descriptor.enumerable) ||
+            !Object.prototype.hasOwnProperty.call(descriptor, 'value')) {
+            throw new ApiContractError('api-contract-invalid', 'String schema options contain an unsupported field.');
+        }
+    }
+    const options = Object.freeze(Object.assign(Object.assign({}, inputOptions), (inputOptions.enum
+        ? { enum: Object.freeze([...inputOptions.enum]) }
+        : {})));
+    validateLengthOption(options.minLength, options.maxLength, 'String');
+    if (((_a = options.enum) === null || _a === void 0 ? void 0 : _a.length) === 0 ||
+        (options.enum &&
+            (new Set(options.enum).size !== options.enum.length ||
+                options.enum.some((value) => typeof value !== 'string'))) ||
+        (options.format !== undefined &&
+            !['uuid', API_HTTP_HEADER_VALUE_FORMAT].includes(options.format))) {
+        throw new ApiContractError('api-contract-invalid', 'String schema options must be bounded, normalized, and unique.');
+    }
+    const httpHeaderValue = options.format === API_HTTP_HEADER_VALUE_FORMAT;
+    if (httpHeaderValue &&
+        ((options.minLength !== undefined && options.minLength < 1) ||
+            (options.maxLength !== undefined &&
+                options.maxLength > API_HTTP_HEADER_VALUE_MAX_LENGTH) ||
+            ((_b = options.enum) === null || _b === void 0 ? void 0 : _b.some((value) => !isCanonicalApiHttpHeaderValue(value))))) {
+        throw new ApiContractError('api-contract-invalid', 'HTTP header strings must use canonical visible ASCII without surrounding whitespace and stay within 8 KiB.');
+    }
+    const minLength = httpHeaderValue
+        ? ((_c = options.minLength) !== null && _c !== void 0 ? _c : 1)
+        : options.minLength;
+    const maxLength = httpHeaderValue
+        ? ((_d = options.maxLength) !== null && _d !== void 0 ? _d : API_HTTP_HEADER_VALUE_MAX_LENGTH)
+        : options.maxLength;
+    return schema(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ $schema: JSON_SCHEMA_2020_12_DIALECT }, (options.enum ? { enum: [...options.enum] } : {})), (options.format ? { format: options.format } : {})), (maxLength === undefined ? {} : { maxLength })), (minLength === undefined ? {} : { minLength })), (httpHeaderValue ? { pattern: API_HTTP_HEADER_VALUE_PATTERN } : {})), { type: 'string' }), (value, path) => {
+        if (typeof value !== 'string') {
+            return fail(path, 'does not satisfy the declared string schema.');
+        }
+        const length = [...value].length;
+        if ((minLength !== undefined && length < minLength) ||
+            (maxLength !== undefined && length > maxLength) ||
+            (options.enum && !options.enum.includes(value)) ||
+            (options.format === 'uuid' &&
+                !/^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i.test(value)) ||
+            (httpHeaderValue && !isCanonicalApiHttpHeaderValue(value))) {
+            return fail(path, 'does not satisfy the declared string schema.');
+        }
+        return value;
+    });
+}
+export function apiNumber(inputOptions = {}) {
+    var _a, _b;
+    const options = Object.freeze(Object.assign({}, inputOptions));
+    if ((options.minimum !== undefined && !Number.isFinite(options.minimum)) ||
+        (options.maximum !== undefined && !Number.isFinite(options.maximum)) ||
+        (options.minimum !== undefined &&
+            options.maximum !== undefined &&
+            options.minimum > options.maximum)) {
+        throw new ApiContractError('api-contract-invalid', 'Numeric bounds must be ordered finite numbers.');
+    }
+    const minimum = options.integer
+        ? Math.max((_a = options.minimum) !== null && _a !== void 0 ? _a : Number.MIN_SAFE_INTEGER, Number.MIN_SAFE_INTEGER)
+        : options.minimum;
+    const maximum = options.integer
+        ? Math.min((_b = options.maximum) !== null && _b !== void 0 ? _b : Number.MAX_SAFE_INTEGER, Number.MAX_SAFE_INTEGER)
+        : options.maximum;
+    if (minimum !== undefined && maximum !== undefined && minimum > maximum) {
+        throw new ApiContractError('api-contract-invalid', 'Integer bounds must overlap the JavaScript safe-integer domain.');
+    }
+    return schema(Object.assign(Object.assign(Object.assign({ $schema: JSON_SCHEMA_2020_12_DIALECT }, (maximum === undefined ? {} : { maximum })), (minimum === undefined ? {} : { minimum })), { type: options.integer ? 'integer' : 'number' }), (value, path) => {
+        if (typeof value !== 'number' ||
+            !Number.isFinite(value) ||
+            (options.integer && !Number.isSafeInteger(value)) ||
+            (minimum !== undefined && value < minimum) ||
+            (maximum !== undefined && value > maximum)) {
+            return fail(path, 'does not satisfy the declared numeric schema.');
+        }
+        return value;
+    });
+}
+export function apiBoolean() {
+    return schema({ $schema: JSON_SCHEMA_2020_12_DIALECT, type: 'boolean' }, (value, path) => typeof value === 'boolean' ? value : fail(path, 'must be a boolean.'));
+}
+export function apiLiteral(literal) {
+    if (typeof literal === 'number' && !Number.isFinite(literal)) {
+        throw new ApiContractError('api-contract-invalid', 'A numeric literal must be finite.');
+    }
+    return schema({
+        $schema: JSON_SCHEMA_2020_12_DIALECT,
+        const: literal,
+        type: typeof literal,
+    }, (value, path) => value === literal
+        ? literal
+        : fail(path, `must equal ${String(literal)}.`));
+}
+export function apiArray(item, inputOptions = {}) {
+    const options = Object.freeze(Object.assign({}, inputOptions));
+    const itemSchema = internal(item);
+    validateLengthOption(options.minItems, options.maxItems, 'Array');
+    const parseArray = (value, path, mode) => {
+        if (!Array.isArray(value) ||
+            (options.minItems !== undefined && value.length < options.minItems) ||
+            (options.maxItems !== undefined && value.length > options.maxItems)) {
+            return fail(path, 'does not satisfy the declared array schema.');
+        }
+        return value.map((entry, index) => itemSchema.parseMode(entry, `${path}[${index}]`, mode));
+    };
+    return schema(Object.assign(Object.assign(Object.assign({ $schema: JSON_SCHEMA_2020_12_DIALECT, items: itemSchema.jsonSchema }, (options.maxItems === undefined ? {} : { maxItems: options.maxItems })), (options.minItems === undefined ? {} : { minItems: options.minItems })), { type: 'array' }), parseArray, (value, path = 'value') => {
+        if (!Array.isArray(value) ||
+            (options.minItems !== undefined && value.length < options.minItems) ||
+            (options.maxItems !== undefined && value.length > options.maxItems)) {
+            return fail(path, 'does not satisfy the declared array schema.');
+        }
+        return value.map((entry, index) => itemSchema.project(entry, `${path}[${index}]`));
+    });
+}
+export function apiOptional(value) {
+    return Object.freeze({ optional: true, schema: internal(value) });
+}
+export function apiNullable(value) {
+    var _a;
+    const valueSchema = internal(value);
+    if (valueSchema.jsonSchema.type === 'null' ||
+        ((_a = valueSchema.jsonSchema.oneOf) === null || _a === void 0 ? void 0 : _a.some((entry) => entry.type === 'null'))) {
+        throw new ApiContractError('api-contract-invalid', 'Nullable schemas cannot wrap an already-nullable schema.');
+    }
+    return schema({
+        $schema: JSON_SCHEMA_2020_12_DIALECT,
+        oneOf: [valueSchema.jsonSchema, { type: 'null' }],
+    }, (input, path, mode) => input === null ? null : valueSchema.parseMode(input, path, mode), (input, path = 'value') => input === null ? null : valueSchema.project(input, path));
+}
+export function apiObject(properties) {
+    const definitions = Object.freeze(Object.assign(Object.create(null), properties));
+    const names = Object.keys(definitions).sort();
+    if (names.some((name) => reservedObjectPropertyNames.has(name) ||
+        !/^[A-Za-z_][A-Za-z0-9_.-]{0,127}$/.test(name) ||
+        !definitions[name])) {
+        throw new ApiContractError('api-contract-invalid', 'Object schema property names must be safe bounded machine-readable tokens.');
+    }
+    for (const name of names) {
+        const property = definitions[name];
+        if (!property || typeof property !== 'object') {
+            throw new ApiContractError('api-contract-invalid', 'Object schema properties must use EBK API schemas.');
+        }
+        if ('optional' in property) {
+            if (property.optional !== true) {
+                throw new ApiContractError('api-contract-invalid', 'Optional API schema properties are malformed.');
+            }
+            internal(property.schema);
+        }
+        else {
+            internal(property);
+        }
+    }
+    const required = names.filter((name) => !('optional' in definitions[name]));
+    const propertySchemas = Object.assign(Object.create(null), Object.fromEntries(names.map((name) => {
+        const property = definitions[name];
+        return [
+            name,
+            'optional' in property
+                ? property.schema.jsonSchema
+                : property.jsonSchema,
+        ];
+    })));
+    const requireRecord = (value, path) => {
+        if (!value || typeof value !== 'object' || Array.isArray(value)) {
+            return fail(path, 'must be an object.');
+        }
+        return value;
+    };
+    const parseObject = (value, path, mode) => {
+        const record = requireRecord(value, path);
+        if (mode === 'request') {
+            const unknown = Object.keys(record)
+                .filter((name) => !Object.prototype.hasOwnProperty.call(definitions, name))
+                .sort();
+            if (unknown.length > 0) {
+                return fail(path, `contains undeclared fields: ${unknown.join(', ')}.`);
+            }
+        }
+        const result = Object.create(null);
+        for (const name of names) {
+            const property = definitions[name];
+            const optional = 'optional' in property;
+            if (!Object.prototype.hasOwnProperty.call(record, name)) {
+                if (!optional) {
+                    return fail(`${path}.${name}`, 'is required.');
+                }
+                continue;
+            }
+            result[name] = internal(optional ? property.schema : property).parseMode(record[name], `${path}.${name}`, mode);
+        }
+        return result;
+    };
+    return schema({
+        $schema: JSON_SCHEMA_2020_12_DIALECT,
+        additionalProperties: false,
+        properties: propertySchemas,
+        required,
+        type: 'object',
+    }, parseObject, (value, path = 'value') => {
+        const record = requireRecord(value, path);
+        const result = Object.create(null);
+        for (const name of names) {
+            const property = definitions[name];
+            const optional = 'optional' in property;
+            if (!Object.prototype.hasOwnProperty.call(record, name)) {
+                if (!optional) {
+                    return fail(`${path}.${name}`, 'is required.');
+                }
+                continue;
+            }
+            result[name] = (optional ? property.schema : property).project(record[name], `${path}.${name}`);
+        }
+        return result;
+    });
+}
+//# sourceMappingURL=schema.js.map

package/src/api-contract/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../../../packages/runtime/src/api-contract/schema.ts"],"names":[],"mappings":"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"}

package/src/api-contract/server.d.ts

@@ -0,0 +1,77 @@
+import { type RuntimeHttpEvent, type RuntimeHttpJsonHandler } from '../lambda.js';
+import type { Logger } from '../logging.js';
+import type { RequestContext } from '../request-context.js';
+import { type ApiOperationDefinition, type ApiIdempotencyContract, type ApiRequestValue, type ApiResponseValue } from './operation.js';
+export interface ApiAuthorizationInput<Operation extends ApiOperationDefinition, Event extends RuntimeHttpEvent> {
+    context: RequestContext;
+    event: Event;
+    logger: Logger;
+    operation: Operation;
+    request: ApiRequestValue<Operation>;
+    semantics: ApiRequestSemantics;
+}
+export interface ApiRequestSemantics {
+    idempotencyKey?: string;
+    ifMatch?: string;
+}
+export interface ApiServerHandlerInput<Operation extends ApiOperationDefinition, Principal> {
+    context: RequestContext;
+    logger: Logger;
+    operation: Operation;
+    principal: Principal;
+    request: ApiRequestValue<Operation>;
+    semantics: ApiRequestSemantics;
+}
+export interface ApiServerRepresentation<Operation extends ApiOperationDefinition> {
+    etag?: string;
+    response: ApiResponseValue<Operation>;
+}
+export interface ApiServerConditionalWriteInput<Operation extends ApiOperationDefinition, Principal> extends ApiServerHandlerInput<Operation, Principal> {
+    contract: NonNullable<Operation['conditionalWrite']>;
+}
+export interface ApiServerConditionalWriteAdapter<Operation extends ApiOperationDefinition, Principal> {
+    execute(input: ApiServerConditionalWriteInput<Operation, Principal>, execute: () => Promise<ApiResponseValue<Operation>>): Promise<ApiServerRepresentation<Operation>>;
+}
+export interface ApiServerIdempotencyInput<Operation extends ApiOperationDefinition, Principal> extends ApiServerHandlerInput<Operation, Principal> {
+    contract: ApiIdempotencyContract;
+    fingerprint: string;
+    key: string;
+    scope: string;
+}
+export interface ApiServerIdempotencyAdapter<Operation extends ApiOperationDefinition, Principal> {
+    execute(input: ApiServerIdempotencyInput<Operation, Principal>, execute: () => Promise<ApiServerRepresentation<Operation>>): Promise<ApiServerRepresentation<Operation>>;
+    principalScope(input: ApiServerHandlerInput<Operation, Principal>): Promise<string> | string;
+}
+interface ContractHandlerBaseOptions<Operation extends ApiOperationDefinition, Principal> {
+    component: string;
+    handle(input: ApiServerHandlerInput<Operation, Principal>): ApiResponseValue<Operation> | Promise<ApiResponseValue<Operation>>;
+    logger?: Logger;
+    operation: Operation;
+    stage?: string;
+    workspace: string;
+}
+type ConditionalWriteOptions<Operation extends ApiOperationDefinition, Principal> = Operation['conditionalWrite'] extends {
+    kind: 'etag';
+} ? {
+    conditionalWrite: ApiServerConditionalWriteAdapter<Operation, Principal>;
+} : {
+    conditionalWrite?: never;
+};
+type IdempotencyOptions<Operation extends ApiOperationDefinition, Principal> = Operation['idempotency'] extends ApiIdempotencyContract ? {
+    idempotency: ApiServerIdempotencyAdapter<Operation, Principal>;
+} : {
+    idempotency?: never;
+};
+export type CreateContractHttpJsonHandlerOptions<Operation extends ApiOperationDefinition, Event extends RuntimeHttpEvent = RuntimeHttpEvent, Principal = undefined> = Operation['authentication'] extends 'anonymous' ? ContractHandlerBaseOptions<Operation, Principal> & {
+    authorize?: never;
+} & ConditionalWriteOptions<Operation, Principal> & IdempotencyOptions<Operation, Principal> : ContractHandlerBaseOptions<Operation, Principal> & {
+    authorize(input: ApiAuthorizationInput<Operation, Event>): Principal | Promise<Principal>;
+} & ConditionalWriteOptions<Operation, Principal> & IdempotencyOptions<Operation, Principal>;
+export declare const apiServerRuntime: {
+    readonly exportPath: "@empire-builder-kit/runtime/api-server";
+    readonly packageName: "@empire-builder-kit/runtime";
+    readonly responseProfile: "ebk-app-v1";
+};
+export declare function createApiRequestFingerprint(request: unknown): string;
+export declare function createContractHttpJsonHandler<Operation extends ApiOperationDefinition, Event extends RuntimeHttpEvent = RuntimeHttpEvent, Principal = undefined>(options: CreateContractHttpJsonHandlerOptions<Operation, Event, Principal>): RuntimeHttpJsonHandler<Event>;
+export {};