@beignet/core 0.0.3 → 0.0.5

package/dist/testing/index.js

@@ -1,5 +1,369 @@
-import { createSystemClock } from "../ports/clock";
-import { createUuidIdGenerator, } from "../ports/id-generator";
+import { createMemoryIdempotencyStore, } from "../idempotency/index.js";
+import { createMemoryMailer } from "../mail/index.js";
+import { createMemoryNotificationPort, } from "../notifications/index.js";
+import { createMemoryOutbox } from "../outbox/index.js";
+import { createMemoryAuditLog, } from "../ports/audit.js";
+import { createMemoryCache } from "../ports/cache.js";
+import { createFrozenClock, createSystemClock, } from "../ports/clock.js";
+import { createUuidIdGenerator, } from "../ports/id-generator.js";
+import { createGate, createMemoryRateLimiter, createMemoryStorage, createNoopLogger, createNoopUnitOfWork, } from "../ports/index.js";
+import { createRecordingEventBus, createRecordingJobDispatcher, createTestActivityContext, createTestSystemActor, createTestUserActor, } from "../ports/testing.js";
+import { createAmbientAuditLog } from "../server/audit-context.js";
+import { clearActiveRequestContext, enterActiveRequestContext, } from "../server/request-context.js";
+/**
+ * Create standard memory/fake Beignet ports for tests.
+ *
+ * Use this as the starting point for use-case and route tests, then layer
+ * app-owned repositories or provider fakes through `base` and `overrides`.
+ *
+ * @param options - Optional app ports, overrides, and Unit of Work behavior.
+ * @returns Ports plus captured state for assertions.
+ */
+export function createTestPorts(options = {}) {
+    const audit = createMemoryAuditLog();
+    const cache = createMemoryCache();
+    const clock = options.clock ?? createFrozenClock();
+    const { bus: eventBus, events } = createRecordingEventBus();
+    const { jobs, dispatchedJobs } = createRecordingJobDispatcher();
+    const idempotency = createMemoryIdempotencyStore();
+    const ids = options.ids ?? createUuidIdGenerator();
+    const logger = createNoopLogger();
+    const mailer = createMemoryMailer();
+    const notifications = createMemoryNotificationPort();
+    const outbox = createMemoryOutbox();
+    const rateLimit = createMemoryRateLimiter();
+    const storage = createMemoryStorage();
+    const defaultPorts = {
+        audit: createAmbientAuditLog(audit),
+        cache,
+        clock,
+        eventBus,
+        gate: createGate({ policies: [] }),
+        idempotency,
+        ids,
+        jobs,
+        logger,
+        mailer,
+        notifications,
+        outbox,
+        rateLimit,
+        storage,
+    };
+    const overrides = completeTestPortOverrides(options.overrides);
+    // The kit's one sanctioned cast: boot-time bases and completed partial
+    // overrides are widened to the app's full Ports shape.
+    const portsWithoutUow = {
+        ...options.base,
+        ...defaultPorts,
+        ...overrides,
+    };
+    const transactionOptions = options.transaction;
+    const flushEventsToOutbox = transactionOptions?.outbox === true;
+    const resolveTransactionPorts = () => {
+        const txPorts = transactionOptions?.ports;
+        if (typeof txPorts === "function") {
+            return txPorts(portsWithoutUow);
+        }
+        return txPorts ?? portsWithoutUow;
+    };
+    const generatedUow = createNoopUnitOfWork(() => {
+        const tx = resolveTransactionPorts();
+        if (flushEventsToOutbox) {
+            // Validate up front so both commit and rollback paths fail loudly.
+            resolveBufferedTransactionEvents(tx);
+        }
+        return tx;
+    }, {
+        afterCommit: async (tx) => {
+            if (flushEventsToOutbox) {
+                await resolveBufferedTransactionEvents(tx).flush(portsWithoutUow.eventBus);
+            }
+            await transactionOptions?.afterCommit?.(tx);
+        },
+        afterRollback: async (error, tx) => {
+            if (flushEventsToOutbox) {
+                resolveBufferedTransactionEvents(tx).clear();
+            }
+            await transactionOptions?.afterRollback?.(error, tx);
+        },
+    });
+    // The kit consumes `uow` directly, so keep the supplied port's identity
+    // instead of the completed override.
+    const uow = options.overrides?.uow ??
+        generatedUow;
+    const ports = {
+        ...portsWithoutUow,
+        uow,
+    };
+    return {
+        ports,
+        audit,
+        eventBus,
+        events,
+        jobs,
+        dispatchedJobs,
+        mailer,
+        notifications,
+        outbox,
+        storage,
+        idempotency,
+        cache,
+        rateLimit,
+        logger,
+        clock,
+        ids,
+        uow,
+    };
+}
+function isPlainObject(value) {
+    if (value === null || typeof value !== "object")
+        return false;
+    const proto = Object.getPrototypeOf(value);
+    return proto === Object.prototype || proto === null;
+}
+function createMissingTestPortMember(portKey, member) {
+    const memberName = `${portKey}.${member}`;
+    const throwMissingMember = () => {
+        throw new Error(`Test port "${memberName}" was called but not provided. Pass it through createTestPorts overrides.`);
+    };
+    Object.defineProperty(throwMissingMember, "name", {
+        value: memberName,
+        configurable: true,
+    });
+    return throwMissingMember;
+}
+function completeTestPortOverride(portKey, value) {
+    // Functions are objects: the function check must run first so
+    // function-valued ports pass through whole.
+    if (typeof value === "function")
+        return value;
+    // Class instances (repositories, Maps, gates built from classes) rely on
+    // internal slots or prototype identity, so only plain objects are completed.
+    if (!isPlainObject(value))
+        return value;
+    return new Proxy(value, {
+        get(target, member, receiver) {
+            if (typeof member === "symbol" ||
+                member === "then" ||
+                member === "constructor" ||
+                member in target) {
+                return Reflect.get(target, member, receiver);
+            }
+            return createMissingTestPortMember(portKey, member);
+        },
+    });
+}
+function completeTestPortOverrides(overrides) {
+    const completed = {};
+    for (const [key, value] of Object.entries(overrides ?? {})) {
+        if (value === undefined)
+            continue;
+        completed[key] = completeTestPortOverride(key, value);
+    }
+    return completed;
+}
+function resolveBufferedTransactionEvents(tx) {
+    const events = tx && typeof tx === "object"
+        ? tx.events
+        : undefined;
+    const recorder = events;
+    if (!recorder ||
+        typeof recorder.flush !== "function" ||
+        typeof recorder.clear !== "function") {
+        throw new Error("createTestPorts transaction.outbox requires tx.events to be a buffered domain event recorder. " +
+            "Add events: createDomainEventRecorder() or createOutboxEventRecorder(...) to transaction.ports.");
+    }
+    return recorder;
+}
+/**
+ * Create a repeatable app context factory for use-case and route tests.
+ *
+ * The factory adds actor, tenant, request ID, trace ID, ports, and auth fields,
+ * and attaches a live `ctx.gate` automatically when `ports.gate` exposes
+ * `bind(...)`. The gate is attached after all `extra` and override fields are
+ * merged, so it always authorizes against the final context identity.
+ *
+ * @param options - Default context values.
+ * @returns A function that creates one app context.
+ */
+export function createTestContextFactory(options) {
+    return (overrides = {}) => {
+        const ports = overrides.ports ?? resolvePorts(options.ports);
+        const activity = createTestActivityContext({
+            actor: overrides.actor ?? options.actor ?? createTestUserActor(),
+            tenant: overrides.tenant !== undefined ? overrides.tenant : options.tenant,
+            requestId: overrides.requestId ?? options.requestId,
+            traceId: overrides.traceId ?? options.traceId,
+        });
+        const auth = overrides.auth !== undefined ? overrides.auth : (options.auth ?? null);
+        const base = {
+            ...activity,
+            auth,
+            ports,
+        };
+        const fields = attachTestGate(ports, base);
+        const extra = resolveExtra(options.extra, fields);
+        const overrideExtra = resolveExtra(overrides.extra, fields);
+        const merged = {
+            ...fields,
+            ...extra,
+            ...overrideExtra,
+        };
+        if (Object.hasOwn(merged, "gate")) {
+            return merged;
+        }
+        return attachTestGate(ports, merged);
+    };
+}
+function resolvePorts(ports) {
+    return typeof ports === "function" ? ports() : ports;
+}
+function resolveExtra(extra, fields) {
+    return typeof extra === "function" ? extra(fields) : (extra ?? {});
+}
+function attachTestGate(ports, ctx) {
+    const maybeGate = ports.gate;
+    if (!maybeGate)
+        return ctx;
+    // Mirror GatePort.attach: a live, non-enumerable getter that re-binds
+    // against the receiver so in-place identity changes are never stale and
+    // spread copies drop the gate loudly.
+    Object.defineProperty(ctx, "gate", {
+        configurable: true,
+        enumerable: false,
+        get() {
+            return maybeGate.bind(this);
+        },
+    });
+    return ctx;
+}
+const disposeSymbol = Symbol.dispose ?? Symbol.for("Symbol.dispose");
+/**
+ * Create a one-call test context fixture for jobs, listeners, schedules,
+ * notifications, tasks, and use-case tests.
+ *
+ * The fixture builds common memory ports through `createTestPorts(...)`,
+ * assembles an app context with actor, tenant, request ID, trace ID, auth,
+ * and a live bound gate, and enters the ambient request context so ambient
+ * enrichment matches production. Reading an app port that is neither a kit
+ * default nor supplied throws a named error on use.
+ *
+ * @example
+ * ```ts
+ * const makeContext = createTestContext<AppContext>();
+ *
+ * using fixture = makeContext({
+ *   ports: { issues: { create: async (input) => issueRecord(input) } },
+ * });
+ * await runCreateIssue(fixture.ctx);
+ * ```
+ *
+ * @returns A factory that creates one disposable test context fixture.
+ */
+export function createTestContext() {
+    return (options = {}) => {
+        const fixture = createTestPorts({
+            base: options.base,
+            overrides: options.ports,
+            clock: options.clock,
+            ids: options.ids,
+            transaction: options.transaction,
+        });
+        const ports = createUnboundPortGuard(fixture.ports);
+        const activity = createTestActivityContext({
+            actor: options.actor ?? createTestSystemActor("test-system"),
+            tenant: options.tenant,
+            requestId: options.requestId,
+            traceId: options.traceId,
+        });
+        const auth = options.auth !== undefined ? options.auth : null;
+        const base = {
+            ...activity,
+            auth,
+            ports,
+        };
+        const fields = attachTestGate(ports, base);
+        const merged = {
+            ...fields,
+            ...(options.extra ?? {}),
+        };
+        const ctx = (Object.hasOwn(merged, "gate")
+            ? merged
+            : attachTestGate(ports, merged));
+        const ambient = options.ambient ?? true;
+        if (ambient) {
+            enterActiveRequestContext({
+                requestId: activity.requestId,
+                traceId: activity.traceId,
+                actor: activity.actor,
+                tenant: activity.tenant,
+            });
+        }
+        let disposed = false;
+        const dispose = () => {
+            if (!ambient || disposed)
+                return;
+            disposed = true;
+            clearActiveRequestContext();
+        };
+        return {
+            ...fixture,
+            ports,
+            ctx,
+            dispose,
+            [disposeSymbol]: dispose,
+        };
+    };
+}
+function createUnboundPortGuard(ports) {
+    return new Proxy(ports, {
+        get(target, key, receiver) {
+            if (typeof key === "symbol" ||
+                key === "then" ||
+                key === "constructor" ||
+                key in target) {
+                return Reflect.get(target, key, receiver);
+            }
+            throw new Error(`App port "${key}" is not bound in this test context. Pass it through createTestContext ports.`);
+        },
+    });
+}
+/**
+ * Run provider setup against test ports and return the merged ports plus
+ * lifecycle runners.
+ *
+ * Use this in provider tests instead of hand-rolling the setup, port merge,
+ * and lifecycle plumbing around `provider.setup(...)`.
+ *
+ * @param provider - Provider under test.
+ * @param options - Base ports, raw config, and service-context factory.
+ * @returns Merged ports, the raw setup result, and start/stop runners.
+ */
+export async function installProviderForTest(provider, options = {}) {
+    const basePorts = { ...options.ports };
+    const createServiceContext = options.createServiceContext ??
+        (async () => {
+            throw new Error(`Provider "${provider.name}" called createServiceContext during a test install. ` +
+                "Pass createServiceContext to installProviderForTest(...) when the test needs a service context.");
+        });
+    const result = await provider.setup({
+        ports: basePorts,
+        config: options.config,
+        createServiceContext,
+    });
+    const ports = { ...basePorts, ...result.ports };
+    const lifecycleCtx = { ports, createServiceContext };
+    return {
+        ports,
+        result,
+        async start() {
+            await result.start?.(lifecycleCtx);
+        },
+        async stop() {
+            await result.stop?.(lifecycleCtx);
+        },
+    };
+}
 /**
  * Error thrown when a seed fails.
  */
@@ -48,9 +412,9 @@ function assertCount(kind, count) {
     }
 }
 /**
- * Define a typed test data factory with deterministic sequence support.
+ * Create a typed test data factory with deterministic sequence support.
  */
-export function defineFactory(name, options) {
+export function createFactory(name, options) {
     const start = options.start ?? 1;
     const ids = options.ids ?? createUuidIdGenerator();
     const clock = options.clock ?? createSystemClock();
@@ -124,4 +488,62 @@ export async function runSeeds(options) {
         }
     }
 }
+/**
+ * Create a database test harness for app-owned database fixtures.
+ *
+ * The harness does not know about an ORM or database provider. Apps provide
+ * creation, reset, close, and context mapping functions, while Beignet handles
+ * the repetitive test lifecycle around factory sequences and seed execution.
+ */
+export function createDatabaseTestHarness(options) {
+    const sessions = new Set();
+    function resetFactorySequences() {
+        resetFactories(...(options.factories ?? []));
+    }
+    function defaultSeeds() {
+        return options.seeds ?? [];
+    }
+    async function closeSession(session) {
+        if (!sessions.delete(session))
+            return;
+        await options.close?.(session.database);
+    }
+    return {
+        async setup(setupOptions = {}) {
+            resetFactorySequences();
+            const database = await options.create();
+            const ctx = options.ctx(database);
+            const session = {
+                database,
+                ctx,
+                async runSeeds(seeds = defaultSeeds()) {
+                    await runSeeds({ ctx, seeds });
+                },
+                async reset() {
+                    resetFactorySequences();
+                    await options.reset?.(database);
+                },
+                async close() {
+                    await closeSession(session);
+                },
+            };
+            sessions.add(session);
+            try {
+                if (setupOptions.seed) {
+                    const seeds = setupOptions.seed === true ? defaultSeeds() : setupOptions.seed;
+                    await session.runSeeds(seeds);
+                }
+            }
+            catch (error) {
+                await session.close();
+                throw error;
+            }
+            return session;
+        },
+        resetFactories: resetFactorySequences,
+        async cleanup() {
+            await Promise.all(Array.from(sessions, (session) => session.close()));
+        },
+    };
+}
 //# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

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

package/dist/tracing/index.d.ts

@@ -0,0 +1,89 @@
+/**
+ * @beignet/core/tracing
+ *
+ * W3C trace context primitives used to correlate Beignet activity across
+ * requests, use cases, providers, and instrumentation sinks.
+ *
+ * This module is dependency-free so client bundles that import app context
+ * types stay clean.
+ */
+/**
+ * Trace context used to correlate related activity.
+ */
+export interface TraceContext {
+    /**
+     * W3C trace ID.
+     */
+    traceId: string;
+    /**
+     * Current span ID.
+     */
+    spanId: string;
+    /**
+     * Parent span ID when available.
+     */
+    parentSpanId?: string;
+    /**
+     * W3C traceparent header value.
+     */
+    traceparent: string;
+}
+/**
+ * Parsed W3C traceparent header.
+ */
+export interface ParsedTraceparent {
+    /**
+     * W3C trace ID.
+     */
+    traceId: string;
+    /**
+     * Span ID from the traceparent header.
+     */
+    spanId: string;
+    /**
+     * Trace flags from the traceparent header.
+     */
+    traceFlags: string;
+    /**
+     * Normalized traceparent header value.
+     */
+    traceparent: string;
+}
+/**
+ * Input accepted when creating trace context.
+ */
+export interface TraceContextInput {
+    traceId?: string;
+    spanId?: string;
+    parentSpanId?: string;
+    traceparent?: string;
+}
+/**
+ * Create a non-zero W3C trace ID.
+ */
+export declare function createTraceId(): string;
+/**
+ * Create a non-zero W3C span ID.
+ */
+export declare function createSpanId(): string;
+/**
+ * Create a W3C traceparent header value.
+ */
+export declare function createTraceparent(args: {
+    traceId: string;
+    spanId: string;
+    traceFlags?: string;
+}): string;
+/**
+ * Parse and validate a W3C traceparent header value.
+ */
+export declare function parseTraceparent(value: string | null | undefined): ParsedTraceparent | undefined;
+/**
+ * Create trace context from explicit IDs or an existing traceparent.
+ */
+export declare function createTraceContext(input?: TraceContextInput): TraceContext;
+/**
+ * Create child trace context from a parent context.
+ */
+export declare function createChildTraceContext(parent: TraceContextInput): TraceContext;
+//# sourceMappingURL=index.d.ts.map

package/dist/tracing/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tracing/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAsBD;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAMtC;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACtC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,MAAM,CAET;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAC/B,iBAAiB,GAAG,SAAS,CAe/B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,GAAE,iBAAsB,GAC5B,YAAY,CAgBd;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,iBAAiB,GACxB,YAAY,CAMd"}

package/dist/tracing/index.js

@@ -0,0 +1,101 @@
+/**
+ * @beignet/core/tracing
+ *
+ * W3C trace context primitives used to correlate Beignet activity across
+ * requests, use cases, providers, and instrumentation sinks.
+ *
+ * This module is dependency-free so client bundles that import app context
+ * types stay clean.
+ */
+const TRACEPARENT_PATTERN = /^00-([0-9a-f]{32})-([0-9a-f]{16})-([0-9a-f]{2})$/;
+function createHexId(length) {
+    const bytes = new Uint8Array(length / 2);
+    if (typeof crypto !== "undefined" && "getRandomValues" in crypto) {
+        crypto.getRandomValues(bytes);
+        return Array.from(bytes, (byte) => byte.toString(16).padStart(2, "0")).join("");
+    }
+    let value = "";
+    while (value.length < length) {
+        value += Math.floor(Math.random() * 16).toString(16);
+    }
+    return value.slice(0, length);
+}
+function isNonZeroHex(value) {
+    return !/^0+$/.test(value);
+}
+/**
+ * Create a non-zero W3C trace ID.
+ */
+export function createTraceId() {
+    let traceId = createHexId(32);
+    while (!isNonZeroHex(traceId)) {
+        traceId = createHexId(32);
+    }
+    return traceId;
+}
+/**
+ * Create a non-zero W3C span ID.
+ */
+export function createSpanId() {
+    let spanId = createHexId(16);
+    while (!isNonZeroHex(spanId)) {
+        spanId = createHexId(16);
+    }
+    return spanId;
+}
+/**
+ * Create a W3C traceparent header value.
+ */
+export function createTraceparent(args) {
+    return `00-${args.traceId}-${args.spanId}-${args.traceFlags ?? "01"}`;
+}
+/**
+ * Parse and validate a W3C traceparent header value.
+ */
+export function parseTraceparent(value) {
+    if (!value)
+        return undefined;
+    const normalized = value.trim().toLowerCase();
+    const match = TRACEPARENT_PATTERN.exec(normalized);
+    if (!match)
+        return undefined;
+    const [, traceId, spanId, traceFlags] = match;
+    if (!isNonZeroHex(traceId) || !isNonZeroHex(spanId))
+        return undefined;
+    return {
+        traceId,
+        spanId,
+        traceFlags,
+        traceparent: normalized,
+    };
+}
+/**
+ * Create trace context from explicit IDs or an existing traceparent.
+ */
+export function createTraceContext(input = {}) {
+    const parsed = parseTraceparent(input.traceparent);
+    const traceId = input.traceId ?? parsed?.traceId ?? createTraceId();
+    const parentSpanId = input.parentSpanId ?? parsed?.spanId;
+    const spanId = input.spanId ?? createSpanId();
+    return {
+        traceId,
+        spanId,
+        ...(parentSpanId ? { parentSpanId } : {}),
+        traceparent: createTraceparent({
+            traceId,
+            spanId,
+            traceFlags: parsed?.traceFlags,
+        }),
+    };
+}
+/**
+ * Create child trace context from a parent context.
+ */
+export function createChildTraceContext(parent) {
+    return createTraceContext({
+        traceId: parent.traceId,
+        parentSpanId: parent.spanId,
+        traceparent: parent.traceparent,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/tracing/index.js.map

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