@voyant-travel/core 0.109.0

package/dist/config.js

@@ -0,0 +1,251 @@
+/**
+ * Voyant configuration manifest.
+ *
+ * `voyant.config.ts` is a **manifest**, not a runtime config — it exists to
+ * power tooling (CLI generators, registry resolution, `voyant db:sync-links`,
+ * deployment scripts). Runtime composition of modules, plugins, and
+ * middleware still happens in code via `createApp({ modules, plugins, ... })`.
+ *
+ * Shape mirrors Medusa's `defineConfig` so users familiar with that
+ * ecosystem can transfer their mental model directly.
+ */
+/**
+ * Identity helper that returns the config as-is.
+ *
+ * Exists purely so authors can write `defineVoyantConfig({ ... })` and get
+ * type inference + IDE help without casting. Does not perform runtime
+ * validation — malformed manifests will surface at CLI/tooling consumption
+ * time via {@link validateVoyantConfig}.
+ *
+ * @example
+ * ```ts
+ * // starters/operator/voyant.config.ts
+ * import { defineVoyantConfig } from "@voyant-travel/core/config"
+ *
+ * export default defineVoyantConfig({
+ *   modules: ["crm", "bookings", "products", "finance", "suppliers"],
+ *   plugins: ["payload-cms", "bokun"],
+ *   deployment: "cloudflare-worker",
+ *   admin: { enabled: true, path: "/app" },
+ * })
+ * ```
+ */
+export function defineVoyantConfig(config) {
+    return config;
+}
+/**
+ * Lightweight structural validation for a {@link VoyantConfig} manifest.
+ *
+ * Checks only shape/identity: field types, non-empty identifiers, no
+ * duplicate module/plugin names. It does **not** resolve package names or
+ * check that referenced modules exist on disk — that is CLI/tooling
+ * territory.
+ *
+ * Returns a result object rather than throwing so callers can choose how
+ * to surface issues (pretty printing, aggregating, etc.).
+ */
+export function validateVoyantConfig(config) {
+    const issues = [];
+    if (config === null || typeof config !== "object") {
+        return {
+            ok: false,
+            issues: [{ path: "", message: "Config must be an object." }],
+        };
+    }
+    const cfg = config;
+    if (cfg.modules !== undefined) {
+        if (!Array.isArray(cfg.modules)) {
+            issues.push({ path: "modules", message: "Expected an array." });
+        }
+        else {
+            const seen = new Set();
+            cfg.modules.forEach((entry, index) => {
+                const name = extractEntryName(entry);
+                if (!name) {
+                    issues.push({
+                        path: `modules[${index}]`,
+                        message: "Module entry must be a non-empty string or an object with a `resolve` string.",
+                    });
+                    return;
+                }
+                if (seen.has(name)) {
+                    issues.push({
+                        path: `modules[${index}]`,
+                        message: `Duplicate module "${name}".`,
+                    });
+                }
+                seen.add(name);
+            });
+        }
+    }
+    if (cfg.plugins !== undefined) {
+        if (!Array.isArray(cfg.plugins)) {
+            issues.push({ path: "plugins", message: "Expected an array." });
+        }
+        else {
+            const seen = new Set();
+            cfg.plugins.forEach((entry, index) => {
+                const name = extractEntryName(entry);
+                if (!name) {
+                    issues.push({
+                        path: `plugins[${index}]`,
+                        message: "Plugin entry must be a non-empty string or an object with a `resolve` string.",
+                    });
+                    return;
+                }
+                if (seen.has(name)) {
+                    issues.push({
+                        path: `plugins[${index}]`,
+                        message: `Duplicate plugin "${name}".`,
+                    });
+                }
+                seen.add(name);
+            });
+        }
+    }
+    if (cfg.extensions !== undefined) {
+        if (!Array.isArray(cfg.extensions)) {
+            issues.push({ path: "extensions", message: "Expected an array." });
+        }
+        else {
+            const seen = new Set();
+            cfg.extensions.forEach((entry, index) => {
+                const name = extractEntryName(entry);
+                if (!name) {
+                    issues.push({
+                        path: `extensions[${index}]`,
+                        message: "Extension entry must be a non-empty string or an object with a `resolve` string.",
+                    });
+                    return;
+                }
+                if (seen.has(name)) {
+                    issues.push({ path: `extensions[${index}]`, message: `Duplicate extension "${name}".` });
+                }
+                seen.add(name);
+            });
+        }
+    }
+    if (cfg.additionalSchemas !== undefined) {
+        if (!Array.isArray(cfg.additionalSchemas)) {
+            issues.push({ path: "additionalSchemas", message: "Expected an array." });
+        }
+        else {
+            const seen = new Set();
+            cfg.additionalSchemas.forEach((entry, index) => {
+                const name = extractEntryName(entry);
+                if (!name) {
+                    issues.push({
+                        path: `additionalSchemas[${index}]`,
+                        message: "additionalSchemas entry must be a non-empty string or an object with a `resolve` string.",
+                    });
+                    return;
+                }
+                if (seen.has(name)) {
+                    issues.push({
+                        path: `additionalSchemas[${index}]`,
+                        message: `Duplicate additionalSchemas entry "${name}".`,
+                    });
+                }
+                seen.add(name);
+            });
+        }
+    }
+    if (cfg.schemas !== undefined) {
+        if (!Array.isArray(cfg.schemas)) {
+            issues.push({ path: "schemas", message: "Expected an array of file-path strings." });
+        }
+        else {
+            cfg.schemas.forEach((entry, index) => {
+                if (typeof entry !== "string" || entry.trim().length === 0) {
+                    issues.push({
+                        path: `schemas[${index}]`,
+                        message: "schemas entry must be a non-empty file-path string.",
+                    });
+                }
+            });
+        }
+    }
+    if (cfg.admin !== undefined) {
+        if (cfg.admin === null || typeof cfg.admin !== "object" || Array.isArray(cfg.admin)) {
+            issues.push({ path: "admin", message: "Expected an object." });
+        }
+        else {
+            const admin = cfg.admin;
+            if (admin.enabled !== undefined && typeof admin.enabled !== "boolean") {
+                issues.push({ path: "admin.enabled", message: "Expected a boolean." });
+            }
+            if (admin.path !== undefined && typeof admin.path !== "string") {
+                issues.push({ path: "admin.path", message: "Expected a string." });
+            }
+            if (admin.backendUrl !== undefined && typeof admin.backendUrl !== "string") {
+                issues.push({ path: "admin.backendUrl", message: "Expected a string." });
+            }
+            if (admin.routes !== undefined) {
+                if (admin.routes === null ||
+                    typeof admin.routes !== "object" ||
+                    Array.isArray(admin.routes)) {
+                    issues.push({ path: "admin.routes", message: "Expected an object." });
+                }
+                else {
+                    const routes = admin.routes;
+                    for (const field of [
+                        "dir",
+                        "apiUrlModule",
+                        "apiUrlExport",
+                        "fetcherModule",
+                        "fetcherExport",
+                    ]) {
+                        if (routes[field] !== undefined && typeof routes[field] !== "string") {
+                            issues.push({ path: `admin.routes.${field}`, message: "Expected a string." });
+                        }
+                    }
+                }
+            }
+        }
+    }
+    if (cfg.featureFlags !== undefined) {
+        if (cfg.featureFlags === null ||
+            typeof cfg.featureFlags !== "object" ||
+            Array.isArray(cfg.featureFlags)) {
+            issues.push({ path: "featureFlags", message: "Expected an object of booleans." });
+        }
+        else {
+            for (const [key, value] of Object.entries(cfg.featureFlags)) {
+                if (typeof value !== "boolean") {
+                    issues.push({
+                        path: `featureFlags.${key}`,
+                        message: "Expected a boolean.",
+                    });
+                }
+            }
+        }
+    }
+    if (cfg.deployment !== undefined && typeof cfg.deployment !== "string") {
+        issues.push({ path: "deployment", message: "Expected a string." });
+    }
+    return { ok: issues.length === 0, issues };
+}
+function extractEntryName(entry) {
+    if (typeof entry === "string") {
+        return entry.trim().length > 0 ? entry : null;
+    }
+    if (entry !== null && typeof entry === "object" && "resolve" in entry) {
+        const resolve = entry.resolve;
+        if (typeof resolve === "string" && resolve.trim().length > 0) {
+            return resolve;
+        }
+    }
+    return null;
+}
+/**
+ * Normalize a {@link ModuleEntry} or {@link PluginEntry} into the canonical
+ * `{ resolve, options }` object shape. Accepts string shorthand and inline
+ * descriptors alike.
+ */
+export function resolveEntry(entry) {
+    if (typeof entry === "string") {
+        return { resolve: entry, options: {} };
+    }
+    return { resolve: entry.resolve, options: entry.options ?? {} };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/container.d.ts

@@ -0,0 +1,20 @@
+/**
+ * A lightweight shared app/runtime container for explicit service resolution.
+ *
+ * Routes, workflows, subscribers, and bootstraps use this container to resolve
+ * app-owned runtime services. It is intentionally minimal (Map-based) — for
+ * richer DI (scoping, factory lifetimes) a template can wrap or replace it.
+ */
+export interface ModuleContainer {
+    /** Register a service by name. Overwrites any existing registration. */
+    register(name: string, service: unknown): void;
+    /** Resolve a service by name. Throws if not registered. */
+    resolve<T>(name: string): T;
+    /** Check if a service is registered. */
+    has(name: string): boolean;
+}
+/**
+ * Create a new module container backed by an in-memory Map.
+ */
+export declare function createContainer(): ModuleContainer;
+//# sourceMappingURL=container.d.ts.map

package/dist/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAA;IAE9C,2DAA2D;IAC3D,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,CAAC,CAAA;IAE3B,wCAAwC;IACxC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAA;CAC3B;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,eAAe,CAiBjD"}

package/dist/container.js

@@ -0,0 +1,21 @@
+/**
+ * Create a new module container backed by an in-memory Map.
+ */
+export function createContainer() {
+    const services = new Map();
+    return {
+        register(name, service) {
+            services.set(name, service);
+        },
+        resolve(name) {
+            if (!services.has(name)) {
+                throw new Error(`Service "${name}" is not registered in the container`);
+            }
+            return services.get(name);
+        },
+        has(name) {
+            return services.has(name);
+        },
+    };
+}
+//# sourceMappingURL=container.js.map

package/dist/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../src/container.ts"],"names":[],"mappings":"AAkBA;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAmB,CAAA;IAE3C,OAAO;QACL,QAAQ,CAAC,IAAI,EAAE,OAAO;YACpB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAA;QAC7B,CAAC;QACD,OAAO,CAAI,IAAY;YACrB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,MAAM,IAAI,KAAK,CAAC,YAAY,IAAI,sCAAsC,CAAC,CAAA;YACzE,CAAC;YACD,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAM,CAAA;QAChC,CAAC;QACD,GAAG,CAAC,IAAI;YACN,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;QAC3B,CAAC;KACF,CAAA;AACH,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,29 @@
+export type VoyantCallerType = "session" | "api_key" | "internal";
+/**
+ * Who the request represents. Routes under `/v1/admin/*` expect `"staff"`;
+ * `/v1/public/*` expects customer/partner/supplier actors.
+ *
+ * When unset, middleware treats the request as `"staff"` to preserve
+ * backwards compatibility with internal-only deployments.
+ */
+export type Actor = "staff" | "customer" | "partner" | "supplier";
+export interface VoyantAuthContext {
+    userId?: string;
+    sessionId?: string;
+    organizationId?: string | null;
+    callerType?: VoyantCallerType;
+    actor?: Actor;
+    scopes?: string[] | null;
+    isInternalRequest?: boolean;
+    apiTokenId?: string;
+    apiKeyId?: string;
+    email?: string | null;
+}
+export interface VoyantPermission {
+    resource: string;
+    action: string;
+}
+export type VoyantVariables = VoyantAuthContext & {
+    db: unknown;
+};
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjE;;;;;;GAMG;AACH,MAAM,MAAM,KAAK,GAAG,OAAO,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,CAAA;AAEjE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,UAAU,CAAC,EAAE,gBAAgB,CAAA;IAC7B,KAAK,CAAC,EAAE,KAAK,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,GAAG,IAAI,CAAA;IACxB,iBAAiB,CAAC,EAAE,OAAO,CAAA;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAA;IAChB,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,MAAM,eAAe,GAAG,iBAAiB,GAAG;IAChD,EAAE,EAAE,OAAO,CAAA;CACZ,CAAA"}

package/dist/env.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":""}

package/dist/events.d.ts

@@ -0,0 +1,177 @@
+/**
+ * High-level classification for public event consumers.
+ *
+ * - `domain` events represent business milestones that other modules or
+ *   external integrations may reasonably care about.
+ * - `internal` events are service/process signals that remain useful for
+ *   subscribers, diagnostics, and automation, but are not part of the core
+ *   business language.
+ */
+export type EventCategory = "domain" | "internal";
+/**
+ * Where an event was emitted from. This helps consumers understand whether
+ * an event originated from a workflow boundary, a lower-level service, or a
+ * transport/runtime edge.
+ */
+export type EventSource = "workflow" | "service" | "route" | "subscriber" | "system";
+/**
+ * Optional metadata attached to an emitted event.
+ *
+ * Templates and adapters may extend this with runtime-specific fields such as
+ * correlation identifiers or delivery handles.
+ */
+export interface EventMetadata {
+    category?: EventCategory;
+    source?: EventSource;
+    correlationId?: string;
+    causationId?: string;
+    [key: string]: unknown;
+}
+/**
+ * Standard event envelope delivered to subscribers.
+ */
+export interface EventEnvelope<TData = unknown, TMetadata extends EventMetadata | undefined = EventMetadata | undefined> {
+    /** Event name, following the `<resource>.<pastTenseAction>` convention. */
+    name: string;
+    /** Business payload emitted by the caller. */
+    data: TData;
+    /** Optional metadata for source/taxonomy/tracing. */
+    metadata?: TMetadata;
+    /** ISO timestamp indicating when the event was emitted. */
+    emittedAt: string;
+}
+/**
+ * Event handler callback invoked when a subscribed event is emitted.
+ */
+export type EventHandler<TData = unknown, TMetadata extends EventMetadata | undefined = EventMetadata | undefined> = (event: EventEnvelope<TData, TMetadata>) => Promise<void> | void;
+/**
+ * Subscription handle returned from {@link EventBus.subscribe}.
+ *
+ * Call `unsubscribe()` to remove the handler.
+ */
+export interface Subscription {
+    unsubscribe(): void;
+}
+/**
+ * Abstract event bus interface. Implementations live in templates or plugins.
+ *
+ * Adapter examples:
+ * - In-process (default, ships with core)
+ * - Cloudflare Queues — edge-native
+ * - Postgres-backed durable queue — for refund-saga-grade durability
+ *
+ * Event naming convention: `<resource>.<pastTenseAction>` in dot-case.
+ * Examples: `booking.created`, `quote.accepted`, `payment.received`.
+ */
+/**
+ * Per-subscription options.
+ */
+export interface SubscribeOptions {
+    /**
+     * Inline handlers complete before `emit()` resolves even when the
+     * emitter supplies a deferral scheduler (see {@link EmitOptions}).
+     * Use for the rare subscriber whose side effects must be visible to
+     * the code that follows the emit (e.g. read-after-write within the
+     * same request). Default `false` — handlers are deferrable.
+     */
+    inline?: boolean;
+}
+/**
+ * Per-emit options. Call sites normally omit this; runtime adapters
+ * (e.g. `@voyant-travel/hono`'s request-scoped bus) supply `schedule` so
+ * deferrable handlers run after the HTTP response instead of blocking
+ * it.
+ */
+export interface EmitOptions {
+    /**
+     * Receives a single promise covering all deferrable (non-`inline`)
+     * handlers for this emit. When provided, `emit()` resolves after the
+     * `inline` handlers only; the scheduler owns keeping the runtime
+     * alive for the rest (Workers: `executionCtx.waitUntil`). When
+     * omitted, all handlers complete before `emit()` resolves.
+     */
+    schedule?: (pending: Promise<unknown>) => void;
+    /**
+     * Transactional-outbox store for this emit. When present, the
+     * envelope is persisted BEFORE any handler runs; after all handlers
+     * settle the row is completed (every handler succeeded) or failed
+     * (at least one error/timeout — the store schedules the retry).
+     * A `null` return from `insert` means the event was already captured
+     * (duplicate `metadata.eventId`) and delivery is skipped entirely.
+     */
+    store?: OutboxEventStore;
+}
+/**
+ * Minimal persistence contract the event bus needs for durable emits.
+ * `@voyant-travel/db/outbox` provides the Postgres implementation; the bus
+ * itself stays storage-agnostic.
+ */
+export interface OutboxEventStore {
+    /**
+     * Persist the envelope before delivery. Returns the stored record id,
+     * or `null` when an event with the same `metadata.eventId` already
+     * exists (the original capture owns delivery).
+     */
+    insert(envelope: EventEnvelope): Promise<{
+        id: string;
+    } | null>;
+    /** Every handler succeeded — mark delivered. */
+    complete(id: string): Promise<void>;
+    /**
+     * At least one handler failed or timed out. The store owns retry
+     * scheduling (backoff) and dead-lettering.
+     */
+    fail(id: string, error: string): Promise<void>;
+}
+/** Outcome of delivering one envelope to all its subscribers. */
+export interface DeliveryResult {
+    /** Handlers invoked. */
+    attempted: number;
+    /** Handlers that threw or timed out. */
+    failed: number;
+    errors: string[];
+}
+/** Stable, unique event id for envelope metadata / outbox dedup. */
+export declare function generateEventId(): string;
+export interface EventBusOptions {
+    /**
+     * Per-handler timeout in milliseconds. A handler that exceeds it is
+     * logged and no longer awaited — it is NOT cancelled (JS can't), so
+     * it may still finish in the background. Defaults to 15s, which
+     * bounds how long one slow third-party subscriber (CMS sync,
+     * e-invoicing API) can hold an emit. Set `false` to disable.
+     */
+    handlerTimeoutMs?: number | false;
+}
+export interface EventBus {
+    /** Emit an event. Fire-and-forget; subscribers cannot affect the emitter. */
+    emit<TData, TMetadata extends EventMetadata | undefined = EventMetadata | undefined>(event: string, data: TData, metadata?: TMetadata, options?: EmitOptions): Promise<void>;
+    /** Subscribe to an event by name. Returns an unsubscribe handle. */
+    subscribe<TData, TMetadata extends EventMetadata | undefined = EventMetadata | undefined>(event: string, handler: EventHandler<TData, TMetadata>, options?: SubscribeOptions): Subscription;
+    /**
+     * Deliver an existing envelope to ALL its subscribers (inline and
+     * deferrable alike), reporting per-handler failures instead of only
+     * logging them. Used by outbox drains for redelivery — it does NOT
+     * persist anything. Optional so third-party bus implementations
+     * remain assignable; drains fall back to `emit` (fire-and-forget,
+     * counted as success) when absent.
+     */
+    deliver?(envelope: EventEnvelope): Promise<DeliveryResult>;
+}
+/**
+ * Create an in-process event bus.
+ *
+ * Handlers run **in parallel** — they are independent observers by
+ * contract, so one slow subscriber doesn't serialize behind another.
+ * Errors thrown by a handler are caught and logged and never affect the
+ * emitter or sibling handlers ("subscribers are fire-and-forget").
+ * Each handler is bounded by {@link EventBusOptions.handlerTimeoutMs}.
+ *
+ * When the emitter passes {@link EmitOptions.schedule}, handlers not
+ * marked `inline` are handed to the scheduler as one promise and
+ * `emit()` resolves without waiting for them — this is how the HTTP
+ * runtime moves subscriber work (third-party syncs, notifications)
+ * after the response.
+ */
+export declare function createEventBus(options?: EventBusOptions): EventBus;
+//# sourceMappingURL=events.d.ts.map

package/dist/events.d.ts.map

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