@beignet/core 0.0.1

package/dist/openapi/index.js

@@ -0,0 +1,449 @@
+/**
+ * @beignet/core/openapi
+ *
+ * OpenAPI 3.1 generation from Beignet contracts
+ */
+import { z } from "zod";
+import { getContractHeaderSchemas, methodSupportsRequestBody, parsePathTemplate, resolveContract, STANDARD_ERROR_RESPONSE_SCHEMA, } from "../contracts";
+import { createZodIntrospector, } from "./schema-introspector";
+// Re-export the introspector types for consumers who want custom implementations
+export { createZodIntrospector, } from "./schema-introspector";
+/**
+ * Convert an array of contracts to an OpenAPI 3.1 document
+ *
+ * @param contracts - Array of HTTP contracts (ContractBuilder instances or configs)
+ * @param options - OpenAPI generation options
+ * @returns OpenAPI 3.1 document object
+ *
+ * @example
+ * ```ts
+ * import { contractsToOpenAPI } from "@beignet/core/openapi";
+ * import { getTodo, listTodos } from "./contracts";
+ *
+ * const spec = contractsToOpenAPI(
+ *   [getTodo, listTodos],
+ *   {
+ *     title: "Todo API",
+ *     version: "1.0.0",
+ *     servers: [{ url: "https://api.example.com" }],
+ *   }
+ * );
+ * ```
+ */
+export function contractsToOpenAPI(contracts, options) {
+    const paths = {};
+    const components = {
+        schemas: {},
+        securitySchemes: options.securitySchemes ?? {},
+    };
+    const state = {
+        components,
+        jsonMediaType: options.jsonMediaType ?? "application/json",
+        introspector: options.schemaIntrospector ?? createZodIntrospector(),
+    };
+    for (const contract of contracts) {
+        const config = resolveContract(contract);
+        addContractToPaths(config, paths, state);
+    }
+    const openapi = {
+        openapi: "3.1.0",
+        info: {
+            title: options.title,
+            version: options.version,
+            description: options.description,
+        },
+        servers: options.servers,
+        paths,
+        components: Object.keys(components.schemas ?? {}).length > 0 ||
+            Object.keys(components.securitySchemes ?? {}).length > 0
+            ? components
+            : undefined,
+        security: options.security,
+    };
+    return openapi;
+}
+// =============================================================================
+// OpenAPI Generation Helpers
+// =============================================================================
+/**
+ * Add a single contract to the paths object
+ */
+function addContractToPaths(contract, paths, state) {
+    const pathKey = parsePathTemplate(contract.path).openApiPath;
+    if (!paths[pathKey]) {
+        paths[pathKey] = {};
+    }
+    const pathItem = paths[pathKey];
+    const meta = contract.metadata?.openapi;
+    const operation = {
+        operationId: meta?.operationId ?? contract.name,
+        summary: meta?.summary,
+        description: meta?.description,
+        tags: meta?.tags,
+        deprecated: meta?.deprecated,
+        externalDocs: meta?.externalDocs,
+        security: meta?.security,
+        parameters: [],
+        responses: {},
+    };
+    addPathParams(contract, operation, state);
+    addQueryParams(contract, operation, state);
+    addHeaderParams(contract, operation, state);
+    addRequestBody(contract, operation, state);
+    addResponses(contract, operation, state);
+    // Clean up empty parameters array
+    if (operation.parameters?.length === 0) {
+        delete operation.parameters;
+    }
+    const methodKey = contract.method.toLowerCase();
+    pathItem[methodKey] = operation;
+}
+function addParameter(operation, parameter) {
+    if (!operation.parameters) {
+        operation.parameters = [];
+    }
+    const existingIndex = operation.parameters.findIndex((existing) => existing.in === parameter.in && existing.name === parameter.name);
+    if (existingIndex >= 0) {
+        operation.parameters[existingIndex] = parameter;
+        return;
+    }
+    operation.parameters.push(parameter);
+}
+/**
+ * Add path parameters from contract to operation.
+ */
+function addPathParams(contract, operation, state) {
+    const pathKeys = parsePathTemplate(contract.path).keys;
+    if (!contract.pathParams) {
+        for (const key of pathKeys) {
+            addParameter(operation, {
+                name: key,
+                in: "path",
+                required: true,
+                schema: { type: "string" },
+            });
+        }
+        return;
+    }
+    const shape = state.introspector.getShape(contract.pathParams);
+    if (!shape) {
+        if (pathKeys.length > 0) {
+            throw new Error(`Unable to introspect pathParams for contract "${contract.name}" at "${contract.path}". OpenAPI path parameters must match the path template.`);
+        }
+        return;
+    }
+    const shapeKeys = Object.keys(shape);
+    const missingKeys = pathKeys.filter((key) => !shapeKeys.includes(key));
+    const extraKeys = shapeKeys.filter((key) => !pathKeys.includes(key));
+    if (missingKeys.length > 0 || extraKeys.length > 0) {
+        const details = [
+            missingKeys.length > 0
+                ? `missing pathParams keys: ${missingKeys.join(", ")}`
+                : undefined,
+            extraKeys.length > 0
+                ? `extra pathParams keys: ${extraKeys.join(", ")}`
+                : undefined,
+        ]
+            .filter(Boolean)
+            .join("; ");
+        throw new Error(`Path parameters for contract "${contract.name}" must match "${contract.path}" (${details}).`);
+    }
+    for (const key of pathKeys) {
+        const field = shape[key];
+        const paramSchemaRef = zodToSchemaRef(field, `${contract.name}_path_${key}`, state, "input");
+        const description = state.introspector.getDescription(field);
+        const param = {
+            name: key,
+            in: "path",
+            required: true,
+            schema: paramSchemaRef,
+            description,
+        };
+        addParameter(operation, param);
+    }
+}
+/**
+ * Add query parameters from contract to operation.
+ */
+function addQueryParams(contract, operation, state) {
+    if (!contract.query)
+        return;
+    const shape = state.introspector.getShape(contract.query);
+    if (!shape)
+        return;
+    for (const key of Object.keys(shape)) {
+        const originalField = shape[key];
+        const optional = state.introspector.isOptional(originalField);
+        let description = state.introspector.getDescription(originalField);
+        const field = originalField;
+        // If outer optional didn't have description, check inner type
+        if (!description && optional) {
+            description = state.introspector.getDescription(field);
+        }
+        const paramSchemaRef = zodToSchemaRef(field, `${contract.name}_query_${key}`, state, "input");
+        const param = {
+            name: key,
+            in: "query",
+            required: !optional,
+            schema: paramSchemaRef,
+            description,
+        };
+        addParameter(operation, param);
+    }
+}
+/**
+ * Add header parameters from contract to operation.
+ */
+function addHeaderParams(contract, operation, state) {
+    const headerSchemas = getContractHeaderSchemas(contract.headers);
+    for (const headerSchema of headerSchemas) {
+        const shape = state.introspector.getShape(headerSchema);
+        if (!shape)
+            continue;
+        for (const key of Object.keys(shape)) {
+            const originalField = shape[key];
+            const optional = state.introspector.isOptional(originalField);
+            const description = state.introspector.getDescription(originalField);
+            const paramSchemaRef = zodToSchemaRef(originalField, `${contract.name}_header_${key}`, state, "input");
+            addParameter(operation, {
+                name: key,
+                in: "header",
+                required: !optional,
+                schema: paramSchemaRef,
+                description,
+            });
+        }
+    }
+}
+/**
+ * Add request body from contract to operation
+ */
+function addRequestBody(contract, operation, state) {
+    if (!contract.body)
+        return;
+    if (!methodSupportsRequestBody(contract.method)) {
+        throw new Error(`Request bodies are not supported for ${contract.method} contracts. Use POST, PUT, or PATCH for contract request bodies.`);
+    }
+    const schemaRef = zodToSchemaRef(contract.body, `${contract.name}_body`, state, "input");
+    const description = state.introspector.getDescription(contract.body);
+    operation.requestBody = {
+        required: true,
+        description,
+        content: {
+            [state.jsonMediaType]: {
+                schema: schemaRef,
+            },
+        },
+    };
+}
+/**
+ * Add responses from contract to operation
+ */
+function addResponses(contract, operation, state) {
+    // Process all responses (both success and error status codes)
+    for (const [statusKey, zodSchema] of Object.entries(contract.responses)) {
+        const status = statusKey; // Keep as string
+        const catalogErrors = getCatalogErrorsForStatus(contract, Number(status));
+        // null schema means void/empty response (e.g. .responses({ 204: null }))
+        const hasSchema = zodSchema != null;
+        const schemaRef = hasSchema
+            ? catalogErrors.length > 0 && zodSchema === STANDARD_ERROR_RESPONSE_SCHEMA
+                ? catalogErrorResponseSchemaRef(catalogErrors, `${contract.name}_response_${status}`, state)
+                : schemaToSchemaRef(zodSchema, `${contract.name}_response_${status}`, state, "output")
+            : undefined;
+        const described = hasSchema
+            ? state.introspector.getDescription(zodSchema)
+            : undefined;
+        let description;
+        if (described) {
+            description = described;
+        }
+        else if (catalogErrors.length === 1) {
+            description = catalogErrors[0].message;
+        }
+        else if (catalogErrors.length > 1) {
+            description = catalogErrors.map((error) => error.message).join("; ");
+        }
+        else if (status === "200") {
+            description = "OK";
+        }
+        else if (status === "201") {
+            description = "Created";
+        }
+        else if (status === "204") {
+            description = "No Content";
+        }
+        else if (status === "400") {
+            description = "Bad Request";
+        }
+        else if (status === "401") {
+            description = "Unauthorized";
+        }
+        else if (status === "403") {
+            description = "Forbidden";
+        }
+        else if (status === "404") {
+            description = "Not Found";
+        }
+        else if (status === "500") {
+            description = "Internal Server Error";
+        }
+        else {
+            description = `HTTP ${status}`;
+        }
+        const examples = examplesFromCatalogErrors(catalogErrors);
+        operation.responses[status] = {
+            description,
+            content: !hasSchema || status === "204"
+                ? undefined
+                : {
+                    [state.jsonMediaType]: {
+                        schema: schemaRef,
+                        ...(examples ? { examples } : {}),
+                    },
+                },
+        };
+    }
+}
+function getCatalogErrorsForStatus(contract, status) {
+    const errors = contract.metadata?.errors;
+    if (typeof errors !== "object" || errors === null)
+        return [];
+    return Object.entries(errors)
+        .map(([key, error]) => {
+        if (typeof error !== "object" ||
+            error === null ||
+            typeof error.code !== "string" ||
+            typeof error.status !== "number" ||
+            typeof error.message !== "string") {
+            return undefined;
+        }
+        const catalogError = {
+            key,
+            code: error.code,
+            status: error.status,
+            message: error.message,
+        };
+        const details = error.details;
+        if (details !== undefined) {
+            catalogError.details = details;
+        }
+        return catalogError;
+    })
+        .filter((error) => error !== undefined && error.status === status);
+}
+function catalogErrorResponseSchemaRef(errors, nameHint, state) {
+    const schema = errors.length === 1
+        ? catalogErrorResponseSchema(errors[0], nameHint, state)
+        : {
+            oneOf: errors.map((error) => catalogErrorResponseSchema(error, `${nameHint}_${error.key}`, state)),
+        };
+    if (!state.components.schemas) {
+        state.components.schemas = {};
+    }
+    const schemaName = normalizeSchemaName(nameHint, state);
+    if (!state.components.schemas[schemaName]) {
+        state.components.schemas[schemaName] = schema;
+    }
+    return { $ref: `#/components/schemas/${schemaName}` };
+}
+function catalogErrorResponseSchema(error, nameHint, state) {
+    return {
+        type: "object",
+        properties: {
+            code: { type: "string", const: error.code },
+            message: { type: "string" },
+            ...(error.details
+                ? {
+                    details: schemaToSchemaRef(error.details, `${nameHint}_details`, state, "output"),
+                }
+                : { details: {} }),
+            requestId: { type: "string" },
+        },
+        required: ["code", "message"],
+    };
+}
+function examplesFromCatalogErrors(errors) {
+    if (errors.length === 0)
+        return undefined;
+    return Object.fromEntries(errors.map((error) => [
+        normalizeExampleKey(error.key),
+        {
+            summary: error.message,
+            value: {
+                code: error.code,
+                message: error.message,
+            },
+        },
+    ]));
+}
+function normalizeExampleKey(key) {
+    const normalized = key.replace(/[^A-Za-z0-9._-]/g, "_");
+    return normalized || "error";
+}
+/**
+ * Convert a Zod schema to a JSON Schema reference, registering it in components
+ */
+function zodToSchemaRef(schema, nameHint, state, io) {
+    // Ensure schemas object exists
+    if (!state.components.schemas) {
+        state.components.schemas = {};
+    }
+    const schemaName = normalizeSchemaName(nameHint, state);
+    if (!state.components.schemas[schemaName]) {
+        const jsonSchema = z.toJSONSchema(schema, {
+            target: "draft-2020-12",
+            unrepresentable: "any",
+            io,
+        });
+        // Remove $schema as it's not needed in OpenAPI
+        delete jsonSchema.$schema;
+        state.components.schemas[schemaName] = jsonSchema;
+    }
+    return { $ref: `#/components/schemas/${schemaName}` };
+}
+function schemaToSchemaRef(schema, nameHint, state, io) {
+    if (schema === STANDARD_ERROR_RESPONSE_SCHEMA) {
+        return standardErrorResponseSchemaRef(nameHint, state);
+    }
+    return zodToSchemaRef(schema, nameHint, state, io);
+}
+function standardErrorResponseSchemaRef(nameHint, state) {
+    if (!state.components.schemas) {
+        state.components.schemas = {};
+    }
+    const schemaName = normalizeSchemaName(nameHint, state);
+    if (!state.components.schemas[schemaName]) {
+        state.components.schemas[schemaName] = {
+            type: "object",
+            properties: {
+                code: { type: "string" },
+                message: { type: "string" },
+                details: {},
+                requestId: { type: "string" },
+            },
+            required: ["code", "message"],
+        };
+    }
+    return { $ref: `#/components/schemas/${schemaName}` };
+}
+/**
+ * Normalize schema name for use in components.
+ * Appends a counter suffix only when the base name already exists.
+ */
+function normalizeSchemaName(name, state) {
+    const base = name.replace(/[^A-Za-z0-9]/g, "_");
+    // Check if base name is already used
+    if (!state.components.schemas?.[base]) {
+        return base;
+    }
+    // Find a unique name by appending a counter
+    let counter = 1;
+    let uniqueName = `${base}_${counter}`;
+    while (state.components.schemas[uniqueName]) {
+        counter++;
+        uniqueName = `${base}_${counter}`;
+    }
+    return uniqueName;
+}
+//# sourceMappingURL=index.js.map

package/dist/openapi/index.js.map

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

package/dist/openapi/schema-introspector.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Schema introspection adapter.
+ *
+ * Abstracts the details of reading metadata from a schema library (e.g. Zod)
+ * so that the OpenAPI generator is not directly coupled to `_def` internals.
+ *
+ * A default Zod implementation is provided via `createZodIntrospector()`.
+ * To support a different schema library, implement this interface.
+ */
+export interface SchemaIntrospector {
+    /**
+     * Extract the shape (field name → field schema) from an object schema.
+     * Returns undefined if the schema is not an object type or cannot be inspected.
+     */
+    getShape(schema: unknown): Record<string, unknown> | undefined;
+    /**
+     * Extract the user-supplied `.describe()` string from a schema.
+     */
+    getDescription(schema: unknown): string | undefined;
+    /**
+     * Return true if the schema represents an optional wrapper.
+     */
+    isOptional(schema: unknown): boolean;
+    /**
+     * If the schema is an optional wrapper, return the inner (unwrapped) schema.
+     * Otherwise return the original schema unchanged.
+     */
+    unwrapOptional(schema: unknown): unknown;
+}
+/**
+ * Create a schema introspector for Zod schemas.
+ *
+ * This accesses Zod's internal `_def` property, which is a common pattern in
+ * Zod ecosystem libraries but may break with major Zod updates. Each helper
+ * gracefully returns a safe default if the structure is unexpected.
+ */
+export declare function createZodIntrospector(): SchemaIntrospector;
+//# sourceMappingURL=schema-introspector.d.ts.map

package/dist/openapi/schema-introspector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-introspector.d.ts","sourceRoot":"","sources":["../../src/openapi/schema-introspector.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAE/D;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAAC;IAEpD;;OAEG;IACH,UAAU,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;IAErC;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,kBAAkB,CAkE1D"}

package/dist/openapi/schema-introspector.js

@@ -0,0 +1,67 @@
+/**
+ * Create a schema introspector for Zod schemas.
+ *
+ * This accesses Zod's internal `_def` property, which is a common pattern in
+ * Zod ecosystem libraries but may break with major Zod updates. Each helper
+ * gracefully returns a safe default if the structure is unexpected.
+ */
+export function createZodIntrospector() {
+    return {
+        getShape(schema) {
+            if (!schema || typeof schema !== "object")
+                return undefined;
+            const schemaDef = schema?._def;
+            if (!schemaDef || typeof schemaDef !== "object")
+                return undefined;
+            if (!("shape" in schemaDef))
+                return undefined;
+            let shape;
+            if (typeof schemaDef.shape === "function") {
+                shape = schemaDef.shape();
+            }
+            else if (typeof schemaDef.shape === "object") {
+                shape = schemaDef.shape;
+            }
+            if (!shape || typeof shape !== "object")
+                return undefined;
+            return shape;
+        },
+        getDescription(schema) {
+            if (!schema || typeof schema !== "object")
+                return undefined;
+            const directDescription = schema
+                .description;
+            if (typeof directDescription === "string") {
+                return directDescription;
+            }
+            const schemaDef = schema?._def;
+            if (!schemaDef || typeof schemaDef !== "object")
+                return undefined;
+            const description = schemaDef.description;
+            return typeof description === "string" ? description : undefined;
+        },
+        isOptional(schema) {
+            if (!schema || typeof schema !== "object")
+                return false;
+            const schemaWithOptional = schema;
+            if (typeof schemaWithOptional.isOptional === "function") {
+                return schemaWithOptional.isOptional();
+            }
+            const schemaDef = schema?._def;
+            if (!schemaDef || typeof schemaDef !== "object")
+                return false;
+            const def = schemaDef;
+            return def.typeName === "ZodOptional" || def.type === "optional";
+        },
+        unwrapOptional(schema) {
+            const schemaDef = schema?._def;
+            const def = schemaDef;
+            if (def?.typeName !== "ZodOptional" && def?.type !== "optional") {
+                return schema;
+            }
+            const innerType = def?.innerType;
+            return innerType ?? schema;
+        },
+    };
+}
+//# sourceMappingURL=schema-introspector.js.map

package/dist/openapi/schema-introspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema-introspector.js","sourceRoot":"","sources":["../../src/openapi/schema-introspector.ts"],"names":[],"mappings":"AAiCA;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB;IACnC,OAAO;QACL,QAAQ,CAAC,MAAe;YACtB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAE5D,MAAM,SAAS,GAAI,MAAkC,EAAE,IAAI,CAAC;YAC5D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAElE,IAAI,CAAC,CAAC,OAAO,IAAI,SAAS,CAAC;gBAAE,OAAO,SAAS,CAAC;YAE9C,IAAI,KAAc,CAAC;YACnB,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBAC1C,KAAK,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;YAC5B,CAAC;iBAAM,IAAI,OAAO,SAAS,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;gBAC/C,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC;YAC1B,CAAC;YAED,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAE1D,OAAO,KAAgC,CAAC;QAC1C,CAAC;QAED,cAAc,CAAC,MAAe;YAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAE5D,MAAM,iBAAiB,GAAI,MAAoC;iBAC5D,WAAW,CAAC;YACf,IAAI,OAAO,iBAAiB,KAAK,QAAQ,EAAE,CAAC;gBAC1C,OAAO,iBAAiB,CAAC;YAC3B,CAAC;YAED,MAAM,SAAS,GAAI,MAAkC,EAAE,IAAI,CAAC;YAC5D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,OAAO,SAAS,CAAC;YAElE,MAAM,WAAW,GAAI,SAAqC,CAAC,WAAW,CAAC;YACvE,OAAO,OAAO,WAAW,KAAK,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,CAAC;QAED,UAAU,CAAC,MAAe;YACxB,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAExD,MAAM,kBAAkB,GAAG,MAE1B,CAAC;YACF,IAAI,OAAO,kBAAkB,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;gBACxD,OAAO,kBAAkB,CAAC,UAAU,EAAE,CAAC;YACzC,CAAC;YAED,MAAM,SAAS,GAAI,MAAkC,EAAE,IAAI,CAAC;YAC5D,IAAI,CAAC,SAAS,IAAI,OAAO,SAAS,KAAK,QAAQ;gBAAE,OAAO,KAAK,CAAC;YAE9D,MAAM,GAAG,GAAG,SAAoC,CAAC;YACjD,OAAO,GAAG,CAAC,QAAQ,KAAK,aAAa,IAAI,GAAG,CAAC,IAAI,KAAK,UAAU,CAAC;QACnE,CAAC;QAED,cAAc,CAAC,MAAe;YAC5B,MAAM,SAAS,GAAI,MAAkC,EAAE,IAAI,CAAC;YAC5D,MAAM,GAAG,GAAG,SAAgD,CAAC;YAC7D,IAAI,GAAG,EAAE,QAAQ,KAAK,aAAa,IAAI,GAAG,EAAE,IAAI,KAAK,UAAU,EAAE,CAAC;gBAChE,OAAO,MAAM,CAAC;YAChB,CAAC;YAED,MAAM,SAAS,GAAG,GAAG,EAAE,SAAS,CAAC;YACjC,OAAO,SAAS,IAAI,MAAM,CAAC;QAC7B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/ports/audit.d.ts

@@ -0,0 +1,58 @@
+export type ActivityActorType = "anonymous" | "service" | "system" | "user";
+export type AuditOutcome = "success" | "failure";
+export type ActivityMetadataValue = ActivityMetadataValue[] | boolean | null | number | string | {
+    [key: string]: ActivityMetadataValue | undefined;
+};
+export type ActivityMetadata = Record<string, ActivityMetadataValue | undefined>;
+export interface ActivityActor {
+    type: ActivityActorType;
+    id?: string;
+    displayName?: string;
+    metadata?: ActivityMetadata;
+}
+export interface ActivityTenant {
+    id: string;
+    slug?: string;
+    metadata?: ActivityMetadata;
+}
+export interface ActivityResource {
+    type: string;
+    id?: string;
+    name?: string;
+    metadata?: ActivityMetadata;
+}
+export interface AuditLogEntry {
+    action: string;
+    actor: ActivityActor;
+    occurredAt: Date;
+    outcome: AuditOutcome;
+    metadata?: ActivityMetadata;
+    message?: string;
+    requestId?: string;
+    resource?: ActivityResource;
+    tenant?: ActivityTenant;
+    traceId?: string;
+}
+export type AuditLogEntryInput = Omit<AuditLogEntry, "occurredAt" | "outcome"> & {
+    occurredAt?: Date;
+    outcome?: AuditOutcome;
+};
+export interface AuditLogPort {
+    record(entry: AuditLogEntryInput): Promise<void> | void;
+}
+export interface MemoryAuditLogPort extends AuditLogPort {
+    entries: AuditLogEntry[];
+}
+export interface AuditLogOptions {
+    redact?: (entry: AuditLogEntry) => AuditLogEntry;
+}
+export declare function createAnonymousActor(options?: Omit<ActivityActor, "type">): ActivityActor;
+export declare function createServiceActor(id: string, options?: Omit<ActivityActor, "type" | "id">): ActivityActor;
+export declare function createSystemActor(id?: string, options?: Omit<ActivityActor, "type" | "id">): ActivityActor;
+export declare function createUserActor(id: string, options?: Omit<ActivityActor, "type" | "id">): ActivityActor;
+export declare function createTenant(id: string, options?: Omit<ActivityTenant, "id">): ActivityTenant;
+export declare function normalizeAuditLogEntry(entry: AuditLogEntryInput): AuditLogEntry;
+export declare function redactAuditLogEntry(entry: AuditLogEntry): AuditLogEntry;
+export declare function createRedactedAuditLog(audit: AuditLogPort, options?: AuditLogOptions): AuditLogPort;
+export declare function createMemoryAuditLog(entries?: AuditLogEntry[], options?: AuditLogOptions): MemoryAuditLogPort;
+//# sourceMappingURL=audit.d.ts.map

package/dist/ports/audit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/ports/audit.ts"],"names":[],"mappings":"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"}