@voyant-travel/core 0.109.0 → 0.110.0

package/dist/custom-fields.d.ts

@@ -0,0 +1,149 @@
+/**
+ * Custom fields — a typed, validated, visibility-aware extension-field registry
+ * for core entities (consolidated-deployments RFC, the "20%": custom fields
+ * without forking).
+ *
+ * The common client ask is "add a few fields to bookings / people / products".
+ * The free-form `metadata` jsonb most entities already carry is the unstructured
+ * escape hatch (Medusa's model); this registry turns a *declared* subset of that
+ * space into fields that are:
+ *   - **validated** on write (type / required / options / custom rule),
+ *   - **visibility-aware** — each field declares whether it surfaces in exports,
+ *     invoices, and search, so those readers can consult the registry instead of
+ *     dumping or hiding everything,
+ *   - **PII-aware** — flagged fields can be encrypted at rest / redacted in logs.
+ *
+ * The registry is **deployment config**: a deployment declares its fields (often
+ * discovered from `src/custom-fields/*` via {@link customFieldsFromGlob}) and the
+ * framework injects the registry into the services that read/write entities.
+ * This module is intentionally dependency-free (no zod / drizzle) so it can live
+ * in `@voyant-travel/core` and be imported anywhere.
+ */
+/**
+ * The supported types a custom field can hold — the canonical superset across
+ * code-declared and runtime (DB-defined) fields (see the custom-fields
+ * unification ADR). Runtime equivalents map in: `varchar`→`text`, `double`→
+ * `number`, `enum`→`select`, `set`→`multiselect`, `address`/`phone`→`json`.
+ */
+export type CustomFieldType = "text" | "number" | "boolean" | "date"
+/** One of `options`. */
+ | "select"
+/** A subset of `options`, stored as `string[]`. */
+ | "multiselect"
+/** Money as `{ amountCents: number, currency: string }` (ISO-4217). */
+ | "monetary"
+/** Arbitrary JSON (object/array) — also the home for `address`/`phone`. */
+ | "json";
+/** A monetary custom-field value: integer minor units + an ISO-4217 currency. */
+export interface CustomFieldMonetaryValue {
+    amountCents: number;
+    currency: string;
+}
+/**
+ * Per-channel visibility. Defaults (when a channel is unset) are deliberately
+ * conservative: visible in exports, hidden from invoices and search.
+ */
+export interface CustomFieldVisibility {
+    /** Surface in data exports (CSV/JSON). Default `true`. */
+    export?: boolean;
+    /** Render on generated invoices. Default `false` (invoices are customer-facing). */
+    invoice?: boolean;
+    /** Index for search. Default `false`. */
+    search?: boolean;
+}
+/** A single custom-field declaration attached to one entity. */
+export interface CustomFieldDefinition {
+    /** Entity the field attaches to, e.g. `"booking"`, `"person"`, `"product"`. */
+    entity: string;
+    /** Stable key within the entity's custom-field namespace (typo-proof). */
+    key: string;
+    type: CustomFieldType;
+    /** Human label — an i18n key or literal. */
+    label: string;
+    /** Reject writes that omit this field. Default `false`. */
+    required?: boolean;
+    /** Allowed values for `type: "select"`. */
+    options?: ReadonlyArray<string>;
+    /** Sensitive data — the deployment should encrypt at rest / redact in logs. */
+    pii?: boolean;
+    visibility?: CustomFieldVisibility;
+    /**
+     * Extra validation beyond type/required/options. Return an error message to
+     * reject, or `null` to accept. Runs only when a value is present.
+     */
+    validate?: (value: unknown) => string | null;
+}
+/** Identity helper for authoring a field with full type-checking. */
+export declare function defineCustomField<T extends CustomFieldDefinition>(definition: T): T;
+/** A resolved, indexed set of custom-field declarations. */
+export interface CustomFieldRegistry {
+    /** All fields declared for `entity`, in declaration order. */
+    forEntity(entity: string): CustomFieldDefinition[];
+    /** A single field by `(entity, key)`, or `undefined`. */
+    field(entity: string, key: string): CustomFieldDefinition | undefined;
+    /** Entities that have at least one field. */
+    entities(): string[];
+    /** Every declared field. */
+    all(): CustomFieldDefinition[];
+}
+/**
+ * Resolve the registry for a request. The unified system's definitions come
+ * from two sources (code-declared + the runtime `custom_field_definitions`
+ * table), and the runtime set is read from the DB — so the registry is resolved
+ * per request from a `db` handle rather than being a boot-time constant. `db` is
+ * `unknown` to keep `core` free of a Drizzle dependency; the deployment's
+ * resolver casts it. See the custom-fields unification ADR.
+ */
+export type CustomFieldRegistryResolver = (db: unknown) => CustomFieldRegistry | Promise<CustomFieldRegistry>;
+/**
+ * Build a {@link CustomFieldRegistry} from declarations. Throws on a duplicate
+ * `(entity, key)` — a collision is a config bug, not something to resolve
+ * silently.
+ */
+export declare function createCustomFieldRegistry(definitions: ReadonlyArray<CustomFieldDefinition>): CustomFieldRegistry;
+/**
+ * Merge custom-field declarations from several sources into one duplicate-free
+ * list (feed it to {@link createCustomFieldRegistry}). On a `(entity, key)`
+ * collision the **earlier** source wins — pass code-declared fields before
+ * runtime/DB-defined ones so the framework contract is authoritative. The
+ * `onShadow` callback (if given) is notified of each dropped collision.
+ *
+ * The unification's single registry is built as
+ * `createCustomFieldRegistry(mergeCustomFieldDefinitions(codeFields, dbFields))`.
+ */
+export declare function mergeCustomFieldDefinitions(sources: ReadonlyArray<ReadonlyArray<CustomFieldDefinition>>, onShadow?: (shadowed: CustomFieldDefinition, winner: CustomFieldDefinition) => void): CustomFieldDefinition[];
+/** Fields of `entity` visible in `channel` (export / invoice / search). */
+export declare function customFieldsVisibleIn(registry: CustomFieldRegistry, entity: string, channel: keyof CustomFieldVisibility): CustomFieldDefinition[];
+/** One field's validation failure. */
+export interface CustomFieldError {
+    key: string;
+    message: string;
+}
+/** The outcome of {@link validateCustomFields}. */
+export interface CustomFieldValidationResult {
+    ok: boolean;
+    /** Validated values, unknown/absent keys dropped. Only meaningful when `ok`. */
+    value: Record<string, unknown>;
+    errors: CustomFieldError[];
+}
+/**
+ * Validate a custom-fields payload for `entity` against the registry. Unknown
+ * keys are rejected (typo-proofing), missing required fields error, present
+ * values are type/options/custom-rule checked. `null`/`undefined` values for a
+ * non-required field are treated as "omitted". Returns the cleaned value and any
+ * errors — callers persist `value` (e.g. into the entity's `custom_fields` or
+ * `metadata` jsonb) only when `ok`.
+ */
+export declare function validateCustomFields(registry: CustomFieldRegistry, entity: string, input: Record<string, unknown> | null | undefined): CustomFieldValidationResult;
+/**
+ * Discover deployment-local custom-field declarations from a Vite
+ * `import.meta.glob` (eager) of `src/custom-fields/*.ts` files — the custom-field
+ * half of the "extend without forking" seam (mirrors `modulesFromGlob` etc.).
+ * Each file's `default` export is a {@link CustomFieldDefinition} or an array of
+ * them; the results flatten into one list to feed
+ * {@link createCustomFieldRegistry}. Empty until a deployment adds one.
+ *
+ * @throws if a matched file has no default export.
+ */
+export declare function customFieldsFromGlob(glob: Record<string, unknown>): CustomFieldDefinition[];
+//# sourceMappingURL=custom-fields.d.ts.map

package/dist/custom-fields.d.ts.map

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

package/dist/custom-fields.js

@@ -0,0 +1,196 @@
+/**
+ * Custom fields — a typed, validated, visibility-aware extension-field registry
+ * for core entities (consolidated-deployments RFC, the "20%": custom fields
+ * without forking).
+ *
+ * The common client ask is "add a few fields to bookings / people / products".
+ * The free-form `metadata` jsonb most entities already carry is the unstructured
+ * escape hatch (Medusa's model); this registry turns a *declared* subset of that
+ * space into fields that are:
+ *   - **validated** on write (type / required / options / custom rule),
+ *   - **visibility-aware** — each field declares whether it surfaces in exports,
+ *     invoices, and search, so those readers can consult the registry instead of
+ *     dumping or hiding everything,
+ *   - **PII-aware** — flagged fields can be encrypted at rest / redacted in logs.
+ *
+ * The registry is **deployment config**: a deployment declares its fields (often
+ * discovered from `src/custom-fields/*` via {@link customFieldsFromGlob}) and the
+ * framework injects the registry into the services that read/write entities.
+ * This module is intentionally dependency-free (no zod / drizzle) so it can live
+ * in `@voyant-travel/core` and be imported anywhere.
+ */
+/** Identity helper for authoring a field with full type-checking. */
+export function defineCustomField(definition) {
+    return definition;
+}
+const VISIBILITY_DEFAULTS = {
+    export: true,
+    invoice: false,
+    search: false,
+};
+/**
+ * Build a {@link CustomFieldRegistry} from declarations. Throws on a duplicate
+ * `(entity, key)` — a collision is a config bug, not something to resolve
+ * silently.
+ */
+export function createCustomFieldRegistry(definitions) {
+    const byEntity = new Map();
+    const seen = new Set();
+    for (const def of definitions) {
+        const id = `${def.entity}.${def.key}`;
+        if (seen.has(id)) {
+            throw new Error(`[voyant-custom-fields] duplicate custom field "${id}"`);
+        }
+        seen.add(id);
+        const list = byEntity.get(def.entity) ?? [];
+        list.push(def);
+        byEntity.set(def.entity, list);
+    }
+    return {
+        forEntity: (entity) => [...(byEntity.get(entity) ?? [])],
+        field: (entity, key) => byEntity.get(entity)?.find((f) => f.key === key),
+        entities: () => [...byEntity.keys()],
+        all: () => [...definitions],
+    };
+}
+/**
+ * Merge custom-field declarations from several sources into one duplicate-free
+ * list (feed it to {@link createCustomFieldRegistry}). On a `(entity, key)`
+ * collision the **earlier** source wins — pass code-declared fields before
+ * runtime/DB-defined ones so the framework contract is authoritative. The
+ * `onShadow` callback (if given) is notified of each dropped collision.
+ *
+ * The unification's single registry is built as
+ * `createCustomFieldRegistry(mergeCustomFieldDefinitions(codeFields, dbFields))`.
+ */
+export function mergeCustomFieldDefinitions(sources, onShadow) {
+    const winners = new Map();
+    for (const source of sources) {
+        for (const def of source) {
+            const id = `${def.entity}.${def.key}`;
+            const existing = winners.get(id);
+            if (existing) {
+                onShadow?.(def, existing);
+                continue;
+            }
+            winners.set(id, def);
+        }
+    }
+    return [...winners.values()];
+}
+/** Fields of `entity` visible in `channel` (export / invoice / search). */
+export function customFieldsVisibleIn(registry, entity, channel) {
+    return registry
+        .forEntity(entity)
+        .filter((f) => f.visibility?.[channel] ?? VISIBILITY_DEFAULTS[channel]);
+}
+function checkType(def, value) {
+    switch (def.type) {
+        case "text":
+            return typeof value === "string" ? null : "must be a string";
+        case "number":
+            return typeof value === "number" && Number.isFinite(value) ? null : "must be a finite number";
+        case "boolean":
+            return typeof value === "boolean" ? null : "must be a boolean";
+        case "date":
+            if (value instanceof Date) {
+                return Number.isNaN(value.getTime()) ? "must be a valid date" : null;
+            }
+            return typeof value === "string" && !Number.isNaN(Date.parse(value))
+                ? null
+                : "must be an ISO date string";
+        case "select":
+            return typeof value === "string" && (def.options ?? []).includes(value)
+                ? null
+                : `must be one of: ${(def.options ?? []).join(", ")}`;
+        case "multiselect": {
+            const allowed = def.options ?? [];
+            if (!Array.isArray(value) ||
+                value.some((v) => typeof v !== "string" || !allowed.includes(v))) {
+                return `must be a subset of: ${allowed.join(", ")}`;
+            }
+            return null;
+        }
+        case "monetary": {
+            const v = value;
+            const ok = typeof value === "object" &&
+                value !== null &&
+                typeof v.amountCents === "number" &&
+                Number.isInteger(v.amountCents) &&
+                typeof v.currency === "string" &&
+                v.currency.length === 3;
+            return ok ? null : "must be { amountCents: integer, currency: 3-letter code }";
+        }
+        case "json":
+            // Arbitrary JSON (incl. address/phone). Reject only `undefined`; `null`
+            // is already handled as "omitted" by the caller.
+            return value === undefined ? "must be a JSON value" : null;
+    }
+}
+/**
+ * Validate a custom-fields payload for `entity` against the registry. Unknown
+ * keys are rejected (typo-proofing), missing required fields error, present
+ * values are type/options/custom-rule checked. `null`/`undefined` values for a
+ * non-required field are treated as "omitted". Returns the cleaned value and any
+ * errors — callers persist `value` (e.g. into the entity's `custom_fields` or
+ * `metadata` jsonb) only when `ok`.
+ */
+export function validateCustomFields(registry, entity, input) {
+    const provided = input ?? {};
+    const fields = registry.forEntity(entity);
+    const known = new Set(fields.map((f) => f.key));
+    const errors = [];
+    const value = {};
+    for (const key of Object.keys(provided)) {
+        if (!known.has(key)) {
+            errors.push({ key, message: `unknown custom field for "${entity}"` });
+        }
+    }
+    for (const def of fields) {
+        const raw = provided[def.key];
+        const absent = raw === null || raw === undefined;
+        if (absent) {
+            if (def.required) {
+                errors.push({ key: def.key, message: "is required" });
+            }
+            continue;
+        }
+        const typeError = checkType(def, raw);
+        if (typeError) {
+            errors.push({ key: def.key, message: typeError });
+            continue;
+        }
+        const customError = def.validate?.(raw);
+        if (customError) {
+            errors.push({ key: def.key, message: customError });
+            continue;
+        }
+        value[def.key] = raw;
+    }
+    return { ok: errors.length === 0, value, errors };
+}
+/**
+ * Discover deployment-local custom-field declarations from a Vite
+ * `import.meta.glob` (eager) of `src/custom-fields/*.ts` files — the custom-field
+ * half of the "extend without forking" seam (mirrors `modulesFromGlob` etc.).
+ * Each file's `default` export is a {@link CustomFieldDefinition} or an array of
+ * them; the results flatten into one list to feed
+ * {@link createCustomFieldRegistry}. Empty until a deployment adds one.
+ *
+ * @throws if a matched file has no default export.
+ */
+export function customFieldsFromGlob(glob) {
+    return Object.entries(glob)
+        .sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0))
+        .flatMap(([path, namespace]) => {
+        const declaration = namespace.default;
+        if (declaration == null) {
+            throw new Error(`[voyant-custom-fields] "${path}" has no default export — ` +
+                "export default defineCustomField(...) (or an array of them)");
+        }
+        return Array.isArray(declaration)
+            ? declaration
+            : [declaration];
+    });
+}
+//# sourceMappingURL=custom-fields.js.map

package/dist/custom-fields.js.map

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

package/dist/index.d.ts

@@ -2,6 +2,8 @@ export type { AdminConfig, AdminRoutesConfig, ConfigValidationIssue, ConfigValid
 export { defineVoyantConfig, resolveEntry, validateVoyantConfig } from "./config.js";
 export type { ModuleContainer } from "./container.js";
 export { createContainer } from "./container.js";
+export type { CustomFieldDefinition, CustomFieldError, CustomFieldMonetaryValue, CustomFieldRegistry, CustomFieldRegistryResolver, CustomFieldType, CustomFieldValidationResult, CustomFieldVisibility, } from "./custom-fields.js";
+export { createCustomFieldRegistry, customFieldsFromGlob, customFieldsVisibleIn, defineCustomField, mergeCustomFieldDefinitions, validateCustomFields, } from "./custom-fields.js";
 export type { Actor, VoyantAuthContext, VoyantCallerType, VoyantPermission, VoyantVariables, } from "./env.js";
 export type { DeliveryResult, EmitOptions, EventBus, EventBusOptions, EventCategory, EventEnvelope, EventHandler, EventMetadata, EventSource, OutboxEventStore, SubscribeOptions, Subscription, } from "./events.js";
 export { createEventBus, generateEventId } from "./events.js";

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,YAAY,EACV,KAAK,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,cAAc,EACd,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,OAAO,EACP,WAAW,EACX,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAClF,YAAY,EACV,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAA;AACjE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,MAAM,EACN,kBAAkB,GACnB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC/D,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC3D,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,WAAW,EACX,iBAAiB,EACjB,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AACpF,YAAY,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAChD,YAAY,EACV,qBAAqB,EACrB,gBAAgB,EAChB,wBAAwB,EACxB,mBAAmB,EACnB,2BAA2B,EAC3B,eAAe,EACf,2BAA2B,EAC3B,qBAAqB,GACtB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,KAAK,EACL,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,GAChB,MAAM,UAAU,CAAA;AACjB,YAAY,EACV,cAAc,EACd,WAAW,EACX,QAAQ,EACR,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,EACZ,aAAa,EACb,WAAW,EACX,gBAAgB,EAChB,gBAAgB,EAChB,YAAY,GACb,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAClC,YAAY,EACV,kBAAkB,EAClB,eAAe,EACf,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,cAAc,EACd,OAAO,EACP,WAAW,EACX,QAAQ,EACR,aAAa,EACb,QAAQ,EACR,YAAY,EACZ,gBAAgB,GACjB,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAClF,YAAY,EACV,wBAAwB,EACxB,oBAAoB,GACrB,MAAM,cAAc,CAAA;AACrB,OAAO,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAA;AACjE,YAAY,EACV,gBAAgB,EAChB,gBAAgB,EAChB,qBAAqB,EACrB,SAAS,EACT,MAAM,EACN,kBAAkB,GACnB,MAAM,aAAa,CAAA;AACpB,YAAY,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAA;AAC/D,YAAY,EACV,MAAM,EACN,iBAAiB,EACjB,sBAAsB,EACtB,UAAU,GACX,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC3D,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,WAAW,GACZ,MAAM,YAAY,CAAA;AACnB,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAC9E,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAC9C,YAAY,EACV,WAAW,EACX,gBAAgB,EAChB,cAAc,EACd,SAAS,EACT,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AACvB,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/dist/index.js

@@ -1,5 +1,6 @@
 export { defineVoyantConfig, resolveEntry, validateVoyantConfig } from "./config.js";
 export { createContainer } from "./container.js";
+export { createCustomFieldRegistry, customFieldsFromGlob, customFieldsVisibleIn, defineCustomField, mergeCustomFieldDefinitions, validateCustomFields, } from "./custom-fields.js";
 export { createEventBus, generateEventId } from "./events.js";
 export { hooks } from "./hooks.js";
 export { defineLink, generateLinkTableSql, resolveLinkFromSpec } from "./links.js";

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAsBhD,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAgBlC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAKlF,OAAO,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAA;AAgBjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAa3D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAW9C,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAEpF,OAAO,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAA;AAWhD,OAAO,EACL,yBAAyB,EACzB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,2BAA2B,EAC3B,oBAAoB,GACrB,MAAM,oBAAoB,CAAA;AAsB3B,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAC7D,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAgBlC,OAAO,EAAE,UAAU,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAKlF,OAAO,EAAE,kCAAkC,EAAE,MAAM,cAAc,CAAA;AAgBjE,OAAO,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAa3D,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAA;AAE9E,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAW9C,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@voyant-travel/core",
-  "version": "0.109.0",
+  "version": "0.110.0",
   "license": "Apache-2.0",
   "type": "module",
   "exports": {
@@ -49,6 +49,11 @@
       "import": "./dist/orchestration.js",
       "default": "./dist/orchestration.js"
     },
+    "./custom-fields": {
+      "types": "./dist/custom-fields.d.ts",
+      "import": "./dist/custom-fields.js",
+      "default": "./dist/custom-fields.js"
+    },
     "./links": {
       "types": "./dist/links.d.ts",
       "import": "./dist/links.js",