@mantajs/core 0.1.6 → 0.2.0-beta.0

package/dist/index.js

@@ -0,0 +1,53 @@
+// @mantajs/core — Public API
+//
+// Everything is a define*():
+//   import { defineModel, defineService, defineCommand, ... } from '@mantajs/core'
+//
+// Helpers used inside define*():
+//   field.text(), field.number(), defineService()
+//
+// Step (workflow unit):
+//   step.MODULE.create(), step.action(), step.emit()
+export { InMemoryCacheAdapter, InMemoryDatabaseAdapter, InMemoryEventBusAdapter, InMemoryFileAdapter, InMemoryHttpAdapter, InMemoryJobScheduler, InMemoryLockingAdapter, InMemoryNotificationAdapter, InMemoryRelationalQuery, InMemoryRepository, InMemoryRepositoryFactory, InMemoryTransaction, MockAuthGateway, MockAuthModuleService, MockAuthPort, TestLogger, } from './adapters';
+// ── Agent (AI step) ──────────────────────────────
+export { defineAgent } from './ai';
+export { createApp, createTestMantaApp, getRequestContext, MantaAppBuilder, runInRequestContext } from './app';
+// ── Commands (CQRS tool-first) ───────────────────
+export { CommandRegistry, defineCommand, defineCommandGraph, dmlToZod, generateEntityCommands, generateLinkCommands, generateModuleCommands, getCommandScope, isCommandAllowed, isModuleAllowed, QUERY_TOOL_SCHEMA, zodToJsonSchema, } from './command';
+// ── Config ───────────────────────────────────────
+export { AuthConfigSchema, AuthSessionConfigSchema, BootConfigSchema, BUILT_IN_PRESETS, ConfigManager, cloudflarePreset, DatabaseConfigSchema, defineConfig, definePreset, devPreset, EventsConfigSchema, FlagRouter, HttpConfigSchema, LoadedConfigSchema, QueryConfigSchema, RateLimitConfigSchema, SessionCookieConfigSchema, SPA_DEFAULTS, vercelPreset, } from './config';
+export { ContextRegistry } from './context';
+export { ArrayProperty, AutoIncrementProperty, BaseProperty, BaseProperty as DmlProperty, BigNumberProperty, BooleanProperty, ComputedProperty, DateTimeProperty, EnumProperty, FloatProperty, JSONProperty, NullableModifier, NumberProperty, PrimaryKeyModifier, TextProperty, } from './dml';
+export { DmlEntity } from './dml/entity';
+export { fromZodSchema } from './dml/from-zod';
+export { generateDrizzleSchema, parseDmlEntity } from './dml/generator';
+// ── DML (Data Modeling Language) ─────────────────
+export { defineModel, field, model } from './dml/model';
+export { belongsTo } from './dml/relations/belongs-to';
+export { hasMany } from './dml/relations/has-many';
+export { hasOne, hasOneWithFK } from './dml/relations/has-one';
+// ── Errors ───────────────────────────────────────
+export { MantaError, PermanentSubscriberError, permanentSubscriberFailure } from './errors/manta-error';
+export { MessageAggregator } from './events';
+// ── Job ──────────────────────────────────────────
+export { defineJob } from './job';
+// ── Link ─────────────────────────────────────────
+export { clearLinkRegistry, createModelProxy, defineLink, getRegisteredLinks, many, REMOTE_LINK, registerLink, } from './link';
+export { defineMiddleware, defineMiddlewares, ERROR_STATUS_MAP, mapErrorToStatus } from './middleware';
+export { Module } from './module'; // internal — used by plugin-medusa shim
+export { ModuleVersionChecker } from './module/versioning';
+// ── Naming conventions ──────────────────────────
+export { pluralize, toCamel, toKebab, toPascal, toSnake, toTableKey, validateCamelCase, validatePascalCase, } from './naming';
+export { ContainerRegistrationKeys, InMemoryProgressChannel, InMemoryQueueAdapter } from './ports';
+// ── Query ────────────────────────────────────────
+export { defineQuery, defineQueryGraph, extendQueryGraph, getEntityFilter, isEntityAllowed, QueryRegistry, QueryService, } from './query';
+// ── Service ──────────────────────────────────────
+export { buildEventNamesFromModelName, createService, defineService, instantiateServiceDescriptor, isServiceDescriptor, } from './service';
+export { checkAutoDiscovery, checkEventNameAutoGeneration, checkLinkLocations, checkRouteConflicts, checkUnboundedRelations, getEntityThreshold, } from './strict-mode';
+// ── Subscriber ───────────────────────────────────
+export { defineSubscriber, makeIdempotent, registerSubscriber } from './subscriber';
+// ── User ────────────────────────────────────────
+export { defineUserModel } from './user';
+export { generateAllUserRoutes, getPublicPaths } from './user/auto-routes';
+export { CancelledError, createForEach, createOrphanReaperJob, createProgress, createStep, createWorkflow, DEFAULT_ORPHAN_REAP_LIMIT, DEFAULT_ORPHAN_THRESHOLD_MS, defineWorkflow, ENTITY_TAG, emitEventStep, ORPHAN_REAPER_JOB_NAME, ORPHAN_REAPER_SCHEDULE, step, WORKFLOW_ORPHANED_CODE, WorkflowManager, } from './workflows';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/job/index.d.ts

@@ -0,0 +1,52 @@
+import type { MantaApp } from '../app';
+import type { MantaCommands } from '../command/types';
+import type { IDatabasePort, INotificationPort } from '../ports';
+import type { ILoggerPort } from '../ports/logger';
+/**
+ * Scoped context passed to job handlers — same shape as subscriber scope.
+ * - `command` — CQRS command callables (with autocomplete from codegen)
+ * - `log` — logger instance
+ */
+export interface JobScope {
+    command: MantaCommands;
+    log: ILoggerPort;
+    /** Fully booted app, for advanced jobs that need framework ports. */
+    app: MantaApp;
+    /** Database port. Use this instead of importing a concrete database adapter. */
+    db?: IDatabasePort;
+    /** Notification port. Use this instead of importing a concrete email/SMS SDK. */
+    notification?: INotificationPort;
+}
+/**
+ * Typed job definition.
+ */
+export interface JobDefinition<TResult = unknown> {
+    __type: 'job';
+    name: string;
+    schedule: string;
+    handler: (scope: JobScope) => Promise<TResult>;
+}
+/**
+ * Define a scheduled job.
+ * Handler receives `{ command, log }` — same scope as subscribers.
+ *
+ * @example
+ * defineJob('cleanup-drafts', '0 3 * * *', async ({ command }) => {
+ *   await command.cleanupDraftProducts({ olderThanDays: 30 })
+ * })
+ */
+export declare function defineJob<TResult = unknown>(name: string, schedule: string, handler: (scope: JobScope) => Promise<TResult>): JobDefinition<TResult>;
+/**
+ * Define a scheduled job using config object.
+ *
+ * @example
+ * defineJob({
+ *   name: 'cleanup-drafts',
+ *   schedule: '0 3 * * *',
+ *   handler: async ({ command }) => {
+ *     await command.cleanupDraftProducts({ olderThanDays: 30 })
+ *   },
+ * })
+ */
+export declare function defineJob<TResult = unknown>(config: Omit<JobDefinition<TResult>, '__type'>): JobDefinition<TResult>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/job/index.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,QAAQ,CAAA;AACtC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAErD,OAAO,KAAK,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAElD;;;;GAIG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,aAAa,CAAA;IACtB,GAAG,EAAE,WAAW,CAAA;IAChB,qEAAqE;IACrE,GAAG,EAAE,QAAQ,CAAA;IACb,gFAAgF;IAChF,EAAE,CAAC,EAAE,aAAa,CAAA;IAClB,iFAAiF;IACjF,YAAY,CAAC,EAAE,iBAAiB,CAAA;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,OAAO,GAAG,OAAO;IAC9C,MAAM,EAAE,KAAK,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;IAChB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAG,OAAO,EACzC,IAAI,EAAE,MAAM,EACZ,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,OAAO,CAAC,GAC7C,aAAa,CAAC,OAAO,CAAC,CAAA;AAEzB;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,OAAO,GAAG,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA"}

package/dist/job/index.js

@@ -0,0 +1,31 @@
+// Job definition — typed cron scheduler that dispatches commands
+//
+// Jobs receive { command, log } — same scope as subscribers.
+// Every mutation goes through a command (compensation, retry, audit trail).
+//
+// Usage:
+//   defineJob('cleanup-drafts', '0 3 * * *', async ({ command }) => {
+//     await command.cleanupDraftProducts({ olderThanDays: 30 })
+//   })
+import { MantaError } from '../errors/manta-error';
+// ── Implementation ──────────────────────────────────────────────────
+export function defineJob(nameOrConfig, schedule, handler) {
+    if (typeof nameOrConfig === 'object') {
+        const config = nameOrConfig;
+        if (!config.name)
+            throw new MantaError('INVALID_DATA', 'Job name is required');
+        if (!config.schedule)
+            throw new MantaError('INVALID_DATA', 'Job schedule (cron expression) is required');
+        if (typeof config.handler !== 'function')
+            throw new MantaError('INVALID_DATA', 'Job handler must be a function');
+        return { ...config, __type: 'job' };
+    }
+    if (!nameOrConfig)
+        throw new MantaError('INVALID_DATA', 'Job name is required');
+    if (!schedule)
+        throw new MantaError('INVALID_DATA', 'Job schedule (cron expression) is required');
+    if (typeof handler !== 'function')
+        throw new MantaError('INVALID_DATA', 'Job handler must be a function');
+    return { __type: 'job', name: nameOrConfig, schedule, handler };
+}
+//# sourceMappingURL=index.js.map

package/dist/job/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/job/index.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,EAAE;AACF,6DAA6D;AAC7D,4EAA4E;AAC5E,EAAE;AACF,SAAS;AACT,sEAAsE;AACtE,gEAAgE;AAChE,OAAO;AAIP,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AA2DlD,uEAAuE;AACvE,MAAM,UAAU,SAAS,CACvB,YAA6D,EAC7D,QAAiB,EACjB,OAA+C;IAE/C,IAAI,OAAO,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrC,MAAM,MAAM,GAAG,YAAY,CAAA;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI;YAAE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAA;QAC9E,IAAI,CAAC,MAAM,CAAC,QAAQ;YAAE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAA;QACxG,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU;YAAE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAA;QAChH,OAAO,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,KAAc,EAAE,CAAA;IAC9C,CAAC;IAED,IAAI,CAAC,YAAY;QAAE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,sBAAsB,CAAC,CAAA;IAC/E,IAAI,CAAC,QAAQ;QAAE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,4CAA4C,CAAC,CAAA;IACjG,IAAI,OAAO,OAAO,KAAK,UAAU;QAAE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,gCAAgC,CAAC,CAAA;IAEzG,OAAO,EAAE,MAAM,EAAE,KAAc,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAA;AAC1E,CAAC"}

package/dist/link/index.d.ts

@@ -0,0 +1,97 @@
+/**
+ * A reference to a DML entity, produced by createModelProxy().
+ */
+export interface ModelRef {
+    __modelRef: true;
+    entityName: string;
+}
+/**
+ * A "many" reference — wraps a ModelRef to indicate the "many" side of a relation.
+ */
+export interface ManyRef extends ModelRef {
+    __many: true;
+}
+/**
+ * Typed model proxy — provides autocomplete for all entities in the app.
+ * MantaGeneratedEntities is populated by codegen (.manta/types/types.ts).
+ * Falls back to Record<string, ModelRef> when codegen hasn't run.
+ */
+export type ModelProxy = {
+    [K in keyof MantaGeneratedEntities]: ModelRef;
+} & Record<string, ModelRef>;
+/**
+ * Resolved link with computed table name, cardinality, and cascade rules.
+ */
+export interface ResolvedLink {
+    __type: 'link';
+    leftEntity: string;
+    rightEntity: string;
+    leftModule?: string;
+    rightModule?: string;
+    tableName: string;
+    leftFk: string;
+    rightFk: string;
+    cardinality: '1:1' | '1:N' | 'M:N';
+    cascadeLeft: boolean;
+    cascadeRight: boolean;
+    extraColumns?: Record<string, unknown>;
+    isReadOnlyLink?: boolean;
+    /**
+     * When true, this is an intra-module link with 1:1 or 1:N cardinality.
+     * The framework adds a FK column directly on the child entity instead of creating a pivot table.
+     * Set by the bootstrap when both entities belong to the same module.
+     */
+    isDirectFk?: boolean;
+}
+/**
+ * Entity name type — autocompletes from MantaGeneratedEntities (codegen).
+ */
+type EntityNameArg = keyof MantaGeneratedEntities | (string & {});
+/**
+ * Wrap a ModelRef or entity name to indicate "many" cardinality.
+ *
+ * @example
+ * many('inventory_item')
+ * many(model.inventory_item)  // legacy callback form
+ */
+export declare function many(refOrName: ModelRef | EntityNameArg): ManyRef;
+/**
+ * Create a Proxy where any property access returns a ModelRef.
+ *
+ * @example
+ * const m = createModelProxy()
+ * m.Product  // → { __modelRef: true, entityName: 'Product' }
+ */
+export declare function createModelProxy(): ModelProxy;
+/**
+ * Define a cross-module link.
+ *
+ * @example
+ * // String form (preferred)
+ * defineLink('product', many('variant'))
+ * defineLink('product', 'collection', { sortOrder: field.number() })
+ *
+ * // Legacy callback form
+ * defineLink((m) => [m.product, many(m.variant)])
+ */
+export declare function defineLink(leftOrCallback: EntityNameArg | ManyRef | ((model: ModelProxy) => [ModelRef | ManyRef, ModelRef | ManyRef]), rightOrExtraColumns?: EntityNameArg | ModelRef | ManyRef | Record<string, unknown>, extraColumns?: Record<string, unknown>): ResolvedLink;
+/**
+ * Register a pre-built ResolvedLink directly into the registry.
+ * Used by plugins that build links from external discovery (e.g. Medusa compat).
+ */
+export declare function registerLink(resolved: ResolvedLink): ResolvedLink;
+/**
+ * Get all registered links.
+ */
+export declare function getRegisteredLinks(): readonly ResolvedLink[];
+/**
+ * Clear the link registry (for testing).
+ */
+export declare function clearLinkRegistry(): void;
+/**
+ * REMOTE_LINK constant — used as a reference marker in link definitions
+ * to indicate a remote/external module link.
+ */
+export declare const REMOTE_LINK: unique symbol;
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/link/index.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,UAAU,EAAE,IAAI,CAAA;IAChB,UAAU,EAAE,MAAM,CAAA;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,OAAQ,SAAQ,QAAQ;IACvC,MAAM,EAAE,IAAI,CAAA;CACb;AAED;;;;GAIG;AACH,MAAM,MAAM,UAAU,GAAG;KACtB,CAAC,IAAI,MAAM,sBAAsB,GAAG,QAAQ;CAC9C,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAA;AAI5B;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAA;IACd,UAAU,EAAE,MAAM,CAAA;IAClB,WAAW,EAAE,MAAM,CAAA;IACnB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,WAAW,EAAE,KAAK,GAAG,KAAK,GAAG,KAAK,CAAA;IAClC,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,EAAE,OAAO,CAAA;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAID;;GAEG;AACH,KAAK,aAAa,GAAG,MAAM,sBAAsB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEjE;;;;;;GAMG;AACH,wBAAgB,IAAI,CAAC,SAAS,EAAE,QAAQ,GAAG,aAAa,GAAG,OAAO,CAKjE;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,UAAU,CAM7C;AAgBD;;;;;;;;;;GAUG;AACH,wBAAgB,UAAU,CACxB,cAAc,EAAE,aAAa,GAAG,OAAO,GAAG,CAAC,CAAC,KAAK,EAAE,UAAU,KAAK,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,EAC3G,mBAAmB,CAAC,EAAE,aAAa,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAClF,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACrC,YAAY,CA0Hd;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,YAAY,CAGjE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,SAAS,YAAY,EAAE,CAE5D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;GAGG;AACH,eAAO,MAAM,WAAW,eAAkC,CAAA"}

package/dist/link/index.js

@@ -0,0 +1,185 @@
+// SPEC-012 — defineLink() for cross-module relations
+// Callback API only: defineLink((m) => [m.Product, many(m.Variant)])
+import { MantaError } from '../errors/manta-error';
+/**
+ * Wrap a ModelRef or entity name to indicate "many" cardinality.
+ *
+ * @example
+ * many('inventory_item')
+ * many(model.inventory_item)  // legacy callback form
+ */
+export function many(refOrName) {
+    if (typeof refOrName === 'string') {
+        return { __modelRef: true, entityName: refOrName, __many: true };
+    }
+    return { ...refOrName, __many: true };
+}
+/**
+ * Create a Proxy where any property access returns a ModelRef.
+ *
+ * @example
+ * const m = createModelProxy()
+ * m.Product  // → { __modelRef: true, entityName: 'Product' }
+ */
+export function createModelProxy() {
+    return new Proxy({}, {
+        get(_, prop) {
+            return { __modelRef: true, entityName: prop };
+        },
+    });
+}
+function isModelRef(value) {
+    return typeof value === 'object' && value !== null && '__modelRef' in value && value.__modelRef === true;
+}
+function isManyRef(value) {
+    return isModelRef(value) && '__many' in value && value.__many === true;
+}
+// ── Registry ────────────────────────────────────────────
+const LINK_REGISTRY = [];
+// ── defineLink ──────────────────────────────────────────
+/**
+ * Define a cross-module link.
+ *
+ * @example
+ * // String form (preferred)
+ * defineLink('product', many('variant'))
+ * defineLink('product', 'collection', { sortOrder: field.number() })
+ *
+ * // Legacy callback form
+ * defineLink((m) => [m.product, many(m.variant)])
+ */
+export function defineLink(leftOrCallback, rightOrExtraColumns, extraColumns) {
+    let left;
+    let right;
+    let extra;
+    if (typeof leftOrCallback === 'function') {
+        // Legacy callback form
+        const proxy = createModelProxy();
+        [left, right] = leftOrCallback(proxy);
+        extra = rightOrExtraColumns;
+    }
+    else {
+        // String form: defineLink('product', 'variant') or defineLink('product', many('variant'))
+        // Also handle: defineLink(many('customer'), many('customer_group'))
+        if (isModelRef(leftOrCallback)) {
+            left = leftOrCallback;
+        }
+        else {
+            left = { __modelRef: true, entityName: leftOrCallback };
+        }
+        if (typeof rightOrExtraColumns === 'string') {
+            right = { __modelRef: true, entityName: rightOrExtraColumns };
+        }
+        else if (isModelRef(rightOrExtraColumns)) {
+            right = rightOrExtraColumns;
+        }
+        else {
+            throw new MantaError('INVALID_DATA', 'defineLink: second argument must be an entity name string or many()');
+        }
+        extra = extraColumns;
+    }
+    if (!isModelRef(left) || !isModelRef(right)) {
+        throw new MantaError('INVALID_DATA', 'defineLink callback must return an array of two ModelRef values');
+    }
+    // Validate entity names: must be camelCase (e.g. 'customer', 'customerGroup'), not snake_case
+    for (const ref of [left, right]) {
+        const name = ref.entityName;
+        if (name.includes('_')) {
+            const camel = name.toLowerCase().replace(/_([a-z])/g, (_, c) => c.toUpperCase());
+            throw new MantaError('INVALID_DATA', `defineLink: entity name "${name}" must be camelCase. Use "${camel}" instead of "${name}".`);
+        }
+        if (name.includes('-')) {
+            const camel = name.toLowerCase().replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+            throw new MantaError('INVALID_DATA', `defineLink: entity name "${name}" must be camelCase. Use "${camel}" instead of "${name}".`);
+        }
+    }
+    const leftEntity = left.entityName;
+    const rightEntity = right.entityName;
+    if (leftEntity === rightEntity) {
+        throw new MantaError('INVALID_DATA', `defineLink: both sides reference the same entity "${leftEntity}". Self-links are not supported.`);
+    }
+    // Check for duplicates
+    const duplicate = LINK_REGISTRY.find((l) => l.leftEntity === leftEntity && l.rightEntity === rightEntity);
+    if (duplicate) {
+        throw new MantaError('DUPLICATE_ERROR', `Link between "${leftEntity}" and "${rightEntity}" is already defined (table: "${duplicate.tableName}"). Each entity pair can only have one link.`);
+    }
+    // Infer cardinality
+    const leftMany = isManyRef(left);
+    const rightMany = isManyRef(right);
+    let cardinality;
+    if (leftMany && rightMany) {
+        cardinality = 'M:N';
+    }
+    else if (leftMany || rightMany) {
+        cardinality = '1:N';
+    }
+    else {
+        cardinality = '1:1';
+    }
+    // Auto-cascade rules:
+    // 1:1 — deleting either side cascades to the other entity
+    // 1:N — deleting the "one" side cascades to the "many" side, not the reverse
+    // M:N — no entity cascade (pivot rows always cleaned up regardless)
+    let cascadeLeft;
+    let cascadeRight;
+    if (cardinality === '1:1') {
+        cascadeLeft = true;
+        cascadeRight = true;
+    }
+    else if (cardinality === '1:N') {
+        // "one" side cascades to "many" side
+        // If right is many → left is one → cascadeLeft=true (deleting left cascades to right)
+        // If left is many → right is one → cascadeRight=true (deleting right cascades to left)
+        cascadeLeft = rightMany;
+        cascadeRight = leftMany;
+    }
+    else {
+        cascadeLeft = false;
+        cascadeRight = false;
+    }
+    // DB names use snake_case: 'customerGroup' → 'customer_group'
+    const leftSnake = leftEntity.replace(/([a-z])([A-Z])/g, '$1_$2').toLowerCase();
+    const rightSnake = rightEntity.replace(/([a-z])([A-Z])/g, '$1_$2').toLowerCase();
+    const tableName = `${leftSnake}_${rightSnake}`;
+    const resolved = {
+        __type: 'link',
+        leftEntity,
+        rightEntity,
+        tableName,
+        leftFk: `${leftSnake}_id`,
+        rightFk: `${rightSnake}_id`,
+        cardinality,
+        cascadeLeft,
+        cascadeRight,
+        extraColumns: extra,
+    };
+    LINK_REGISTRY.push(resolved);
+    return resolved;
+}
+// ── Public registry API ─────────────────────────────────
+/**
+ * Register a pre-built ResolvedLink directly into the registry.
+ * Used by plugins that build links from external discovery (e.g. Medusa compat).
+ */
+export function registerLink(resolved) {
+    LINK_REGISTRY.push(resolved);
+    return resolved;
+}
+/**
+ * Get all registered links.
+ */
+export function getRegisteredLinks() {
+    return LINK_REGISTRY;
+}
+/**
+ * Clear the link registry (for testing).
+ */
+export function clearLinkRegistry() {
+    LINK_REGISTRY.length = 0;
+}
+/**
+ * REMOTE_LINK constant — used as a reference marker in link definitions
+ * to indicate a remote/external module link.
+ */
+export const REMOTE_LINK = Symbol.for('manta:remote_link');
+//# sourceMappingURL=index.js.map

package/dist/link/index.js.map

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

package/dist/middleware/define-middleware.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Middleware request object — minimal interface for the handler.
+ */
+export interface MiddlewareRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string | string[] | undefined>;
+    /** Verify auth for a given context. Returns the auth entity or null. */
+    verifyAuth: (contextName: string) => Promise<{
+        entity: Record<string, unknown>;
+        actorType: string;
+        actorId: string;
+    } | null>;
+    /** Parsed body (if POST/PUT/PATCH). */
+    body?: unknown;
+    /** Parsed query parameters. */
+    query?: Record<string, unknown>;
+}
+/**
+ * What defineMiddleware() returns — a per-context middleware definition.
+ */
+export interface MiddlewareDefinition {
+    handler: (req: MiddlewareRequest, next: () => Promise<unknown>) => Promise<unknown>;
+    __type: 'middleware';
+}
+/**
+ * Define a per-context middleware override.
+ *
+ * Place the file in `src/middleware/{context}.ts` to override the auto-generated
+ * middleware for that context. The auto-generated middleware (from defineUser)
+ * handles JWT verification and actor_type checking. Use defineMiddleware to add
+ * custom logic on top (RBAC, rate limiting, etc.).
+ *
+ * @example
+ * ```typescript
+ * // src/middleware/admin.ts
+ * import { defineMiddleware, MantaError } from '@mantajs/core'
+ *
+ * export default defineMiddleware(async (req, next) => {
+ *   const auth = await req.verifyAuth('admin')
+ *   if (!auth) throw new MantaError('UNAUTHORIZED')
+ *
+ *   // Custom RBAC logic
+ *   const user = auth.entity
+ *   if (user.role === 'viewer' && req.method !== 'GET') {
+ *     throw new MantaError('FORBIDDEN', 'Viewers have read-only access')
+ *   }
+ *
+ *   return next()
+ * })
+ * ```
+ */
+export declare function defineMiddleware(handler: (req: MiddlewareRequest, next: () => Promise<unknown>) => Promise<unknown>): MiddlewareDefinition;
+//# sourceMappingURL=define-middleware.d.ts.map

package/dist/middleware/define-middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-middleware.d.ts","sourceRoot":"","sources":["../../src/middleware/define-middleware.ts"],"names":[],"mappings":"AAKA;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,CAAA;IACX,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAA;IACtD,wEAAwE;IACxE,UAAU,EAAE,CACV,WAAW,EAAE,MAAM,KAChB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAA;IAC5F,uCAAuC;IACvC,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,+BAA+B;IAC/B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;IACnF,MAAM,EAAE,YAAY,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,GAClF,oBAAoB,CAQtB"}

package/dist/middleware/define-middleware.js

@@ -0,0 +1,40 @@
+// SPEC-V2 — defineMiddleware() (singular)
+// Per-context middleware override. Used in src/middleware/{context}.ts
+import { MantaError } from '../errors/manta-error';
+/**
+ * Define a per-context middleware override.
+ *
+ * Place the file in `src/middleware/{context}.ts` to override the auto-generated
+ * middleware for that context. The auto-generated middleware (from defineUser)
+ * handles JWT verification and actor_type checking. Use defineMiddleware to add
+ * custom logic on top (RBAC, rate limiting, etc.).
+ *
+ * @example
+ * ```typescript
+ * // src/middleware/admin.ts
+ * import { defineMiddleware, MantaError } from '@mantajs/core'
+ *
+ * export default defineMiddleware(async (req, next) => {
+ *   const auth = await req.verifyAuth('admin')
+ *   if (!auth) throw new MantaError('UNAUTHORIZED')
+ *
+ *   // Custom RBAC logic
+ *   const user = auth.entity
+ *   if (user.role === 'viewer' && req.method !== 'GET') {
+ *     throw new MantaError('FORBIDDEN', 'Viewers have read-only access')
+ *   }
+ *
+ *   return next()
+ * })
+ * ```
+ */
+export function defineMiddleware(handler) {
+    if (typeof handler !== 'function') {
+        throw new MantaError('INVALID_DATA', 'defineMiddleware() requires a handler function');
+    }
+    return {
+        handler,
+        __type: 'middleware',
+    };
+}
+//# sourceMappingURL=define-middleware.js.map

package/dist/middleware/define-middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-middleware.js","sourceRoot":"","sources":["../../src/middleware/define-middleware.ts"],"names":[],"mappings":"AAAA,0CAA0C;AAC1C,uEAAuE;AAEvE,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AA2BlD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAmF;IAEnF,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,gDAAgD,CAAC,CAAA;IACxF,CAAC;IACD,OAAO;QACL,OAAO;QACP,MAAM,EAAE,YAAY;KACrB,CAAA;AACH,CAAC"}

package/dist/middleware/index.d.ts

@@ -0,0 +1,56 @@
+import type { MantaErrorType } from '../errors/manta-error';
+export type { MiddlewareDefinition, MiddlewareRequest } from './define-middleware';
+export { defineMiddleware } from './define-middleware';
+/**
+ * A single middleware configuration entry.
+ */
+export interface MiddlewareConfig {
+    matcher: string | RegExp | ((req: unknown) => boolean);
+    method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE' | 'HEAD' | 'OPTIONS';
+    bodyParser?: {
+        type: 'json' | 'multipart' | 'text' | 'urlencoded';
+    };
+    validators?: {
+        body?: unknown;
+        query?: unknown;
+    };
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+    };
+    middlewares?: Array<(req: unknown, res: unknown, next: () => void) => Promise<void> | void>;
+    errorHandler?: (err: unknown, req: unknown, res: unknown, next: () => void) => void;
+    RBAC?: {
+        policies?: string[];
+    };
+    AUTHENTICATE?: false;
+}
+/**
+ * defineMiddlewares() — declares middleware pipeline configuration for routes.
+ *
+ * Returns the configurations for the IHttpPort adapter to apply
+ * as part of the 12-step pipeline.
+ *
+ * Usage:
+ *   export default defineMiddlewares([
+ *     {
+ *       matcher: '/admin/products',
+ *       method: 'POST',
+ *       validators: { body: CreateProductSchema },
+ *     },
+ *     {
+ *       matcher: '/store/*',
+ *       rateLimit: { maxRequests: 200, windowMs: 60_000 },
+ *     },
+ *   ])
+ */
+export declare function defineMiddlewares(configs: MiddlewareConfig[]): MiddlewareConfig[];
+/**
+ * Error-to-HTTP-status mapping per SPEC-041.
+ */
+export declare const ERROR_STATUS_MAP: Record<string, number>;
+/**
+ * Map a MantaError type to an HTTP status code.
+ */
+export declare function mapErrorToStatus(errorType: MantaErrorType | string): number;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/middleware/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AAE3D,YAAY,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AAClF,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAA;AAEtD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,CAAA;IACtD,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAA;IACzE,UAAU,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,GAAG,YAAY,CAAA;KAAE,CAAA;IACnE,UAAU,CAAC,EAAE;QACX,IAAI,CAAC,EAAE,OAAO,CAAA;QACd,KAAK,CAAC,EAAE,OAAO,CAAA;KAChB,CAAA;IACD,SAAS,CAAC,EAAE;QACV,WAAW,EAAE,MAAM,CAAA;QACnB,QAAQ,EAAE,MAAM,CAAA;KACjB,CAAA;IACD,WAAW,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,CAAA;IAC3F,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAAA;IACnF,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE,CAAA;IAC9B,YAAY,CAAC,EAAE,KAAK,CAAA;CACrB;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,gBAAgB,EAAE,GAAG,gBAAgB,EAAE,CAEjF;AAED;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcnD,CAAA;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,GAAG,MAAM,CAE3E"}