@voyantjs/core 0.1.0

package/LICENSE

@@ -0,0 +1,109 @@
+# Functional Source License, Version 1.1, Apache 2.0 Future License
+
+## Abbreviation
+
+FSL-1.1-Apache-2.0
+
+## Notice
+
+Copyright 2026 PixelMakers Studio SRL
+
+## Terms and Conditions
+
+### Licensor ("We")
+
+The party offering the Software under these Terms and Conditions.
+
+### The Software
+
+The "Software" is each version of the software that we make available under
+these Terms and Conditions, as indicated by our inclusion of these Terms and
+Conditions with the Software.
+
+### License Grant
+
+Subject to your compliance with this License Grant and the Patents,
+Redistribution and Trademark clauses below, we hereby grant you the right to
+use, copy, modify, create derivative works, publicly perform, publicly
+display and redistribute the Software for any Permitted Purpose identified
+below.
+
+### Permitted Purpose
+
+A Permitted Purpose is any purpose other than a Competing Use. A Competing
+Use means making the Software available to others in a commercial product or
+service that:
+
+1. substitutes for the Software;
+
+2. substitutes for any other product or service we offer using the Software
+   that exists as of the date we make the Software available; or
+
+3. offers the same or substantially similar functionality as the Software.
+
+Permitted Purposes specifically include using the Software:
+
+1. for your internal use and access;
+
+2. for non-commercial education;
+
+3. for non-commercial research; and
+
+4. in connection with professional services that you provide to a licensee
+   using the Software in accordance with these Terms and Conditions.
+
+### Patents
+
+To the extent your use for a Permitted Purpose would necessarily infringe
+our patents, the license grant above includes a license under our patents.
+If you make a claim against any party that the Software infringes or
+contributes to the infringement of any patent, then your patent license to
+the Software ends immediately.
+
+### Redistribution
+
+The Terms and Conditions apply to all copies, modifications and derivatives
+of the Software.
+
+If you redistribute any copies, modifications or derivatives of the
+Software, you must include a copy of or a link to these Terms and Conditions
+and not remove any copyright notices provided in or with the Software.
+
+### Disclaimer
+
+THE SOFTWARE IS PROVIDED "AS IS" AND WITHOUT WARRANTIES OF ANY KIND, EXPRESS
+OR IMPLIED, INCLUDING WITHOUT LIMITATION WARRANTIES OF FITNESS FOR A
+PARTICULAR PURPOSE, MERCHANTABILITY, TITLE OR NON-INFRINGEMENT.
+
+IN NO EVENT WILL WE HAVE ANY LIABILITY TO YOU ARISING OUT OF OR RELATED TO
+THE SOFTWARE, INCLUDING INDIRECT, SPECIAL, INCIDENTAL OR CONSEQUENTIAL
+DAMAGES, EVEN IF WE HAVE BEEN INFORMED OF THEIR POSSIBILITY IN ADVANCE.
+
+### Trademarks
+
+Except for displaying the License Details and identifying us as the origin
+of the Software, you have no right under these Terms and Conditions to use
+our trademarks, trade names, service marks or product names.
+
+---
+
+## Grant of Future License
+
+We hereby irrevocably grant you an additional license to use the Software
+under the Apache License, Version 2.0 that is effective on the second
+anniversary of the date we make the Software available. On or after that
+date, you may use the Software under the Apache License, Version 2.0, in
+which case the following will apply:
+
+Licensed under the Apache License, Version 2.0 (the "License"); you may not
+use this file except in compliance with the License.
+
+You may obtain a copy of the License at
+
+http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
+WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
+License for the specific language governing permissions and limitations
+under the License.

package/README.md

@@ -0,0 +1,41 @@
+# @voyantjs/core
+
+Module system and framework primitives for Voyant. Transport-agnostic — provides the contracts, registry, container, event bus, links, query, workflows, plugins, and config shape that every Voyant module and transport adapter builds on.
+
+## Install
+
+```bash
+pnpm add @voyantjs/core
+```
+
+## Usage
+
+```typescript
+import { defineModule } from "@voyantjs/core/module"
+import { defineLink } from "@voyantjs/core/links"
+import { definePlugin } from "@voyantjs/core/plugin"
+import { defineVoyantConfig } from "@voyantjs/core/config"
+import { createWorkflow, step } from "@voyantjs/core/workflows"
+```
+
+## Exports
+
+| Entry | Description |
+| --- | --- |
+| `.` | Barrel re-exports |
+| `./module` | `Module`, `defineModule` |
+| `./registry` | Module registry |
+| `./container` | `createContainer` dependency container |
+| `./events` | `createEventBus` in-process event bus |
+| `./hooks` | Lifecycle hook contracts |
+| `./orchestration` | `JobRunner` interface for background jobs |
+| `./links` | Module Links — `defineLink`, `generateLinkTableSql`, `LinkService` |
+| `./query` | Cross-module reads — `queryGraph`, `createQueryContext` |
+| `./workflows` | In-process saga primitive with compensation |
+| `./plugin` | Plugin bundles — `definePlugin`, `registerPlugins` |
+| `./config` | `VoyantConfig` manifest shape + `defineVoyantConfig` |
+| `./env` | Environment helpers |
+
+## License
+
+FSL-1.1-Apache-2.0

package/dist/config.d.ts

@@ -0,0 +1,151 @@
+/**
+ * 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.
+ */
+/**
+ * Core runtime settings declared for tooling purposes (connection strings,
+ * cache backend, auth provider). All fields are optional because runtime
+ * wiring lives in template code and environment bindings.
+ */
+export interface ProjectConfig {
+    /** Database connection descriptor. */
+    database?: {
+        /** Environment variable name that holds the connection URL. */
+        urlEnv?: string;
+        /** Adapter to use at runtime. */
+        adapter?: "edge" | "node";
+    };
+    /** Cache backend descriptor. */
+    cache?: {
+        /** Provider name (e.g. "kv", "redis", "memory"). */
+        provider?: string;
+        /** Cloudflare binding name (when using `kv`). */
+        binding?: string;
+    };
+    /** Auth provider descriptor. */
+    auth?: {
+        /** Provider identifier (e.g. "better-auth"). */
+        provider?: string;
+    };
+}
+/**
+ * Admin-dashboard manifest entry. Mirrors Medusa's admin section.
+ */
+export interface AdminConfig {
+    /** Whether the admin dashboard is enabled for this project. */
+    enabled?: boolean;
+    /** URL path the dashboard is mounted at (e.g. "/app"). */
+    path?: string;
+    /** Optional URL the admin dashboard should call back to. */
+    backendUrl?: string;
+}
+/**
+ * A module declaration — either a string identifier (referencing a package
+ * or workspace-local module) or an inline descriptor with options.
+ */
+export type ModuleEntry = string | {
+    /** Module identifier (package name or workspace path). */
+    resolve: string;
+    /** Arbitrary module options consumed by the module factory. */
+    options?: Record<string, unknown>;
+};
+/**
+ * A plugin declaration — mirrors {@link ModuleEntry} but references
+ * distributable plugin bundles (see `@voyantjs/core/plugin`).
+ */
+export type PluginEntry = string | {
+    /** Plugin identifier (package name). */
+    resolve: string;
+    /** Arbitrary plugin options. */
+    options?: Record<string, unknown>;
+};
+/** Supported deployment targets (informational — used by CLI/tooling). */
+export type DeploymentTarget = "cloudflare-worker" | "node" | "vercel" | "bun" | (string & {});
+/**
+ * The top-level voyant.config.ts manifest.
+ *
+ * @see {@link defineVoyantConfig}
+ */
+export interface VoyantConfig {
+    /** Core runtime settings (database, cache, auth). */
+    projectConfig?: ProjectConfig;
+    /** Admin dashboard configuration. */
+    admin?: AdminConfig;
+    /** Modules composed into the application. */
+    modules?: ModuleEntry[];
+    /** Plugins registered alongside core modules. */
+    plugins?: PluginEntry[];
+    /** Feature flags for gradual rollout. */
+    featureFlags?: Record<string, boolean>;
+    /** Deployment target hint consumed by tooling. */
+    deployment?: DeploymentTarget;
+}
+/**
+ * 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
+ * // templates/dmc/voyant.config.ts
+ * import { defineVoyantConfig } from "@voyantjs/core/config"
+ *
+ * export default defineVoyantConfig({
+ *   modules: ["crm", "bookings", "products", "finance", "suppliers"],
+ *   plugins: ["payload-cms", "bokun"],
+ *   deployment: "cloudflare-worker",
+ *   admin: { enabled: true, path: "/app" },
+ * })
+ * ```
+ */
+export declare function defineVoyantConfig<C extends VoyantConfig>(config: C): C;
+/**
+ * A single validation issue detected in a {@link VoyantConfig} manifest.
+ */
+export interface ConfigValidationIssue {
+    /** Dotted path to the offending field (e.g. `modules[0].resolve`). */
+    path: string;
+    /** Human-readable description. */
+    message: string;
+}
+/**
+ * Result returned by {@link validateVoyantConfig}.
+ */
+export interface ConfigValidationResult {
+    /** True when no issues were detected. */
+    ok: boolean;
+    /** List of validation issues (empty when `ok` is true). */
+    issues: ConfigValidationIssue[];
+}
+/**
+ * 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 declare function validateVoyantConfig(config: unknown): ConfigValidationResult;
+/**
+ * Normalize a {@link ModuleEntry} or {@link PluginEntry} into the canonical
+ * `{ resolve, options }` object shape. Accepts string shorthand and inline
+ * descriptors alike.
+ */
+export declare function resolveEntry<E extends ModuleEntry | PluginEntry>(entry: E): {
+    resolve: string;
+    options: Record<string, unknown>;
+};
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,sCAAsC;IACtC,QAAQ,CAAC,EAAE;QACT,+DAA+D;QAC/D,MAAM,CAAC,EAAE,MAAM,CAAA;QACf,iCAAiC;QACjC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAC1B,CAAA;IACD,gCAAgC;IAChC,KAAK,CAAC,EAAE;QACN,oDAAoD;QACpD,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,iDAAiD;QACjD,OAAO,CAAC,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,gCAAgC;IAChC,IAAI,CAAC,EAAE;QACL,gDAAgD;QAChD,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAA;CACF;AAED;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,+DAA+D;IAC/D,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB;AAED;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN;IACE,0DAA0D;IAC1D,OAAO,EAAE,MAAM,CAAA;IACf,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAEL;;;GAGG;AACH,MAAM,MAAM,WAAW,GACnB,MAAM,GACN;IACE,wCAAwC;IACxC,OAAO,EAAE,MAAM,CAAA;IACf,gCAAgC;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAClC,CAAA;AAEL,0EAA0E;AAC1E,MAAM,MAAM,gBAAgB,GAAG,mBAAmB,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAE9F;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,qDAAqD;IACrD,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,qCAAqC;IACrC,KAAK,CAAC,EAAE,WAAW,CAAA;IACnB,6CAA6C;IAC7C,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,iDAAiD;IACjD,OAAO,CAAC,EAAE,WAAW,EAAE,CAAA;IACvB,yCAAyC;IACzC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,kDAAkD;IAClD,UAAU,CAAC,EAAE,gBAAgB,CAAA;CAC9B;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAEvE;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAA;IACZ,kCAAkC;IAClC,OAAO,EAAE,MAAM,CAAA;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,yCAAyC;IACzC,EAAE,EAAE,OAAO,CAAA;IACX,2DAA2D;IAC3D,MAAM,EAAE,qBAAqB,EAAE,CAAA;CAChC;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,OAAO,GAAG,sBAAsB,CAyG5E;AAeD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW,EAC9D,KAAK,EAAE,CAAC,GACP;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAKvD"}

package/dist/config.js

@@ -0,0 +1,168 @@
+/**
+ * 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
+ * // templates/dmc/voyant.config.ts
+ * import { defineVoyantConfig } from "@voyantjs/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.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 (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 module container providing per-request service resolution.
+ *
+ * Modules register services at app boot; routes resolve them per request.
+ * The container 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,28 @@
+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;
+    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,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,39 @@
+/**
+ * Event handler callback invoked when a subscribed event is emitted.
+ */
+export type EventHandler<TData = unknown> = (data: TData) => 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)
+ * - Hatchet — emit enqueues a durable task
+ * - Cloudflare Queues — edge-native
+ *
+ * Event naming convention: `<resource>.<pastTenseAction>` in dot-case.
+ * Examples: `booking.created`, `quote.accepted`, `payment.received`.
+ */
+export interface EventBus {
+    /** Emit an event. Fire-and-forget; subscribers cannot affect the emitter. */
+    emit(event: string, data: unknown): Promise<void>;
+    /** Subscribe to an event by name. Returns an unsubscribe handle. */
+    subscribe(event: string, handler: EventHandler): Subscription;
+}
+/**
+ * Create an in-process event bus.
+ *
+ * Handlers run sequentially in the order they were subscribed. Errors
+ * thrown by a handler are caught and logged but do not block subsequent
+ * handlers from running, matching the "subscribers are fire-and-forget"
+ * contract.
+ */
+export declare function createEventBus(): 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":"AAAA;;GAEG;AACH,MAAM,MAAM,YAAY,CAAC,KAAK,GAAG,OAAO,IAAI,CAAC,IAAI,EAAE,KAAK,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEjF;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,WAAW,IAAI,IAAI,CAAA;CACpB;AAED;;;;;;;;;;GAUG;AACH,MAAM,WAAW,QAAQ;IACvB,6EAA6E;IAC7E,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAEjD,oEAAoE;IACpE,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAAA;CAC9D;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CA+BzC"}

package/dist/events.js

@@ -0,0 +1,42 @@
+/**
+ * Create an in-process event bus.
+ *
+ * Handlers run sequentially in the order they were subscribed. Errors
+ * thrown by a handler are caught and logged but do not block subsequent
+ * handlers from running, matching the "subscribers are fire-and-forget"
+ * contract.
+ */
+export function createEventBus() {
+    const handlers = new Map();
+    return {
+        async emit(event, data) {
+            const set = handlers.get(event);
+            if (!set)
+                return;
+            for (const handler of set) {
+                try {
+                    await handler(data);
+                }
+                catch (err) {
+                    // Subscribers are fire-and-forget — log and continue.
+                    // biome-ignore lint/suspicious/noConsole: runtime diagnostics
+                    console.error(`[events] subscriber error for "${event}":`, err);
+                }
+            }
+        },
+        subscribe(event, handler) {
+            let set = handlers.get(event);
+            if (!set) {
+                set = new Set();
+                handlers.set(event, set);
+            }
+            set.add(handler);
+            return {
+                unsubscribe() {
+                    set?.delete(handler);
+                },
+            };
+        },
+    };
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"AAiCA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAA6B,CAAA;IAErD,OAAO;QACL,KAAK,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI;YACpB,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC/B,IAAI,CAAC,GAAG;gBAAE,OAAM;YAChB,KAAK,MAAM,OAAO,IAAI,GAAG,EAAE,CAAC;gBAC1B,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;gBACrB,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,sDAAsD;oBACtD,8DAA8D;oBAC9D,OAAO,CAAC,KAAK,CAAC,kCAAkC,KAAK,IAAI,EAAE,GAAG,CAAC,CAAA;gBACjE,CAAC;YACH,CAAC;QACH,CAAC;QACD,SAAS,CAAC,KAAK,EAAE,OAAO;YACtB,IAAI,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAA;YAC7B,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAA;gBACf,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAA;YAC1B,CAAC;YACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;YAChB,OAAO;gBACL,WAAW;oBACT,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,CAAA;gBACtB,CAAC;aACF,CAAA;QACH,CAAC;KACF,CAAA;AACH,CAAC"}