@mantajs/core 0.1.7 → 0.2.0-beta.1

package/dist/command/index.js

@@ -0,0 +1,338 @@
+// CQRS Tool-First — defineCommand() + CommandRegistry
+// Pure domain, zero infra dependency.
+import { MantaError } from '../errors/manta-error.js';
+import { step as stepApi } from '../workflows/step.js';
+function createBoundModuleProxy(moduleName, ctx, ids) {
+    // Resolve the DML entity name from the service (e.g. module "catalog" → entity "Product")
+    // The CRUD methods use the entity name, not the module name.
+    let entity = moduleName.charAt(0).toUpperCase() + moduleName.slice(1);
+    try {
+        const modules = ctx.app.modules;
+        const service = modules[moduleName];
+        if (service?.__entity) {
+            entity = service.__entity.name;
+        }
+    }
+    catch {
+        /* fallback to capitalized module name */
+    }
+    return new Proxy({}, {
+        get(_target, methodName) {
+            switch (methodName) {
+                case 'create':
+                    return async (data) => {
+                        const result = await stepApi.create(entity, data, ctx);
+                        const id = result.id;
+                        const existing = ids.get(entity) ?? [];
+                        existing.push(id);
+                        ids.set(entity, existing);
+                        return result;
+                    };
+                case 'update':
+                    return (id, data) => stepApi.update(entity, id, data, ctx);
+                case 'delete':
+                    return (id) => stepApi.delete(entity, id, ctx);
+                case 'link':
+                    return new Proxy({}, {
+                        get(_t, rightEntityProp) {
+                            // step.product.link.inventoryItem()
+                            // step.product.link.inventoryItem({ extraCol: value })
+                            return async (extraColumns) => {
+                                const rightEntity = rightEntityProp.charAt(0).toUpperCase() + rightEntityProp.slice(1);
+                                const leftIds = ids.get(entity) ?? [];
+                                const leftId = leftIds[leftIds.length - 1];
+                                const rightIds = ids.get(rightEntity) ?? [];
+                                const rightId = rightIds[rightIds.length - 1];
+                                if (!leftId)
+                                    throw new MantaError('INVALID_DATA', `Cannot link: no ${entity} created yet in this workflow. Call step.service.${entity.toLowerCase()}.create() first.`);
+                                if (!rightId)
+                                    throw new MantaError('INVALID_DATA', `Cannot link: no ${rightEntity} created yet in this workflow. Call step.service.${rightEntity.toLowerCase()}.create() first.`);
+                                return stepApi.linkExplicit(entity, leftId, rightEntity, rightId, ctx, extraColumns);
+                            };
+                        },
+                    });
+                default:
+                    // Service compensable methods (activate, archive, etc.)
+                    return (...args) => stepApi.invoke(moduleName, methodName, args, ctx);
+            }
+        },
+    });
+}
+function createBoundStepProxy(entities, ctx, moduleScope) {
+    // Shared ID tracker across all module proxies
+    const ids = new Map();
+    // Resolve which entity names this command can access
+    // If moduleScope is set, only entities from that module are allowed
+    let allowedEntities = null;
+    if (moduleScope) {
+        allowedEntities = new Set();
+        const modules = ctx.app.modules;
+        const mod = modules[moduleScope];
+        if (mod?.__entity) {
+            allowedEntities.add(mod.__entity.name.toLowerCase());
+        }
+        // Also check all modules for entities registered under this module scope
+        for (const [key, svc] of Object.entries(modules)) {
+            const s = svc;
+            if (s?.__entity) {
+                // Entity belongs to this module if it was registered under the module name
+                const entityName = s.__entity.name.toLowerCase();
+                // Check if this entity key starts with module scope name
+                if (key === moduleScope || key === `${moduleScope}Service`) {
+                    allowedEntities.add(entityName);
+                }
+            }
+        }
+        // Also add entities from the entities map if provided
+        for (const key of Object.keys(entities)) {
+            allowedEntities.add(key.toLowerCase());
+        }
+    }
+    // Bound service namespace — step.service.catalog.create({...}) (no ctx needed)
+    // If moduleScope is set, only allows access to the module's own entities
+    const boundServiceProxy = new Proxy({}, {
+        get(_target, moduleName) {
+            if (allowedEntities && !allowedEntities.has(moduleName.toLowerCase())) {
+                throw new MantaError('FORBIDDEN', `Command scoped to module "${moduleScope}" cannot access "${moduleName}". ` +
+                    `Intra-module commands can only use their own entities. ` +
+                    `Use a cross-module command in src/commands/ to orchestrate across modules.`);
+            }
+            return createBoundModuleProxy(moduleName, ctx, ids);
+        },
+    });
+    // Bound command namespace — step.command.createProduct({...}) (no ctx needed)
+    const boundCommandProxy = new Proxy({}, {
+        get(_target, commandName) {
+            return async (input) => {
+                return stepApi.command[commandName](input, ctx);
+            };
+        },
+    });
+    // Bound agent namespace — step.agent.categorizeProduct({...}) (no ctx needed)
+    const boundAgentProxy = new Proxy({}, {
+        get(_target, agentName) {
+            return async (input) => {
+                return stepApi.agent[agentName](input, ctx);
+            };
+        },
+    });
+    // Bound link namespace — step.link.customerAddress.list({...}) (no ctx needed)
+    // Mirrors the global step.link.<name>.{ list, create, update, delete } API.
+    const boundLinkProxy = new Proxy({}, {
+        get(_target, linkName) {
+            return {
+                list: async (where) => {
+                    return stepApi.link[linkName].list(where, ctx);
+                },
+                create: async (data) => {
+                    return stepApi.link[linkName].create(data, ctx);
+                },
+                update: async (where, patch) => {
+                    return stepApi.link[linkName].update(where, patch, ctx);
+                },
+                delete: async (where) => {
+                    return stepApi.link[linkName].delete(where, ctx);
+                },
+            };
+        },
+    });
+    return new Proxy({}, {
+        get(_target, prop) {
+            if (prop === 'service')
+                return boundServiceProxy;
+            if (prop === 'command')
+                return boundCommandProxy;
+            if (prop === 'link')
+                return boundLinkProxy;
+            if (prop === 'agent')
+                return boundAgentProxy;
+            if (prop === 'emit') {
+                return (eventName, data) => {
+                    return stepApi.emit(eventName, data, ctx);
+                };
+            }
+            if (prop === 'action') {
+                return (name, config) => {
+                    const actionFn = stepApi.action(name, config);
+                    return (input) => actionFn(input, ctx);
+                };
+            }
+            // Fallback for backward compat during migration
+            return createBoundModuleProxy(prop, ctx, ids);
+        },
+    });
+}
+// Implementation
+// biome-ignore lint/suspicious/noExplicitAny: overload implementation
+export function defineCommand(config) {
+    if (!config.name)
+        throw new MantaError('INVALID_DATA', 'Command name is required. Usage: defineCommand({ name: "create-product", description: "...", input: z.object({...}), workflow: async (input, { step }) => {...} })');
+    if (!config.description)
+        throw new MantaError('INVALID_DATA', `Command "${config.name}" requires a description (used for AI tool discovery and documentation)`);
+    if (!config.input)
+        throw new MantaError('INVALID_DATA', `Command "${config.name}" requires an input Zod schema. Use z.object({}) for commands with no input.`);
+    if (typeof config.workflow !== 'function')
+        throw new MantaError('INVALID_DATA', `Command "${config.name}" workflow must be an async function: workflow: async (input, { step }) => {...}`);
+    // Always wrap workflow to inject typed step proxy.
+    // The user's workflow receives (input, { step, log }), the bootstrap calls (input, ctx).
+    // If __moduleScope is set (intra-module command), the step proxy is filtered.
+    const userWorkflow = config.workflow;
+    const moduleScope = config.__moduleScope;
+    return {
+        __type: 'command',
+        name: config.name,
+        description: config.description,
+        input: config.input,
+        __moduleScope: moduleScope,
+        workflow: async (input, ctx) => {
+            const step = createBoundStepProxy(config.entities ?? {}, ctx, moduleScope);
+            // auth + headers come from the HTTP route, injected by bootstrap into __httpCtx
+            const httpCtx = ctx.__httpCtx;
+            return userWorkflow(input, {
+                step,
+                log: ctx.app?.infra?.logger ?? console,
+                auth: httpCtx?.auth ?? null,
+                headers: httpCtx?.headers ?? {},
+            });
+        },
+    };
+}
+export class CommandRegistry {
+    _entries = new Map();
+    // biome-ignore lint/suspicious/noExplicitAny: commands have varied type params
+    register(def) {
+        if (this._entries.has(def.name)) {
+            throw new MantaError('DUPLICATE_ERROR', `Command "${def.name}" is already registered`);
+        }
+        this._entries.set(def.name, {
+            name: def.name,
+            description: def.description,
+            inputSchema: def.input,
+            workflow: def.workflow,
+        });
+    }
+    get(name) {
+        return this._entries.get(name);
+    }
+    list() {
+        return [...this._entries.values()];
+    }
+    /** Generate tool schemas for AI discovery (commands + query) */
+    toToolSchemas() {
+        const schemas = [QUERY_TOOL_SCHEMA];
+        for (const entry of this._entries.values()) {
+            schemas.push({
+                name: entry.name,
+                description: entry.description,
+                input_schema: zodToJsonSchema(entry.inputSchema),
+            });
+        }
+        return schemas;
+    }
+    _reset() {
+        this._entries.clear();
+    }
+}
+// ── QUERY_TOOL_SCHEMA ────────────────────────────────────────────────
+export const QUERY_TOOL_SCHEMA = {
+    name: 'query',
+    description: 'Query entities from the database. Supports filtering, pagination, and field selection.',
+    input_schema: {
+        type: 'object',
+        properties: {
+            entity: { type: 'string', description: 'Entity name to query (e.g. "product", "inventory")' },
+            fields: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Fields to return (optional, returns all by default)',
+            },
+            filters: {
+                type: 'object',
+                description: 'Filter conditions (e.g. { status: "active" })',
+            },
+            limit: { type: 'number', description: 'Max results to return (default: 100)' },
+            offset: { type: 'number', description: 'Offset for pagination' },
+        },
+        required: ['entity'],
+    },
+};
+// biome-ignore lint/suspicious/noExplicitAny: Zod internals use _def with varying shapes
+export function zodToJsonSchema(schema) {
+    const def = schema._def;
+    const typeName = def?.typeName ?? '';
+    if (typeName === 'ZodObject') {
+        const shape = def.shape?.() ?? {};
+        const properties = {};
+        const required = [];
+        for (const [key, value] of Object.entries(shape)) {
+            const prop = value;
+            properties[key] = zodToJsonSchema(prop);
+            const innerTypeName = prop._def?.typeName ?? '';
+            if (innerTypeName !== 'ZodOptional' && innerTypeName !== 'ZodDefault')
+                required.push(key);
+        }
+        return { type: 'object', properties, ...(required.length > 0 ? { required } : {}) };
+    }
+    if (typeName === 'ZodString')
+        return { type: 'string' };
+    if (typeName === 'ZodNumber')
+        return { type: 'number' };
+    if (typeName === 'ZodBoolean')
+        return { type: 'boolean' };
+    if (typeName === 'ZodArray')
+        return { type: 'array', items: zodToJsonSchema(def.type) };
+    if (typeName === 'ZodEnum')
+        return { type: 'string', enum: def.values };
+    if (typeName === 'ZodOptional')
+        return zodToJsonSchema(def.innerType);
+    if (typeName === 'ZodDefault')
+        return { ...zodToJsonSchema(def.innerType), default: def.defaultValue() };
+    if (typeName === 'ZodNullable')
+        return { ...zodToJsonSchema(def.innerType), nullable: true };
+    if (typeName === 'ZodUnion') {
+        // biome-ignore lint/suspicious/noExplicitAny: Zod internal option types
+        const options = def.options.map((o) => zodToJsonSchema(o));
+        return { oneOf: options };
+    }
+    if (typeName === 'ZodDiscriminatedUnion') {
+        // biome-ignore lint/suspicious/noExplicitAny: Zod internal option types
+        const options = [...def.options.values()].map((o) => zodToJsonSchema(o));
+        return { oneOf: options };
+    }
+    if (typeName === 'ZodLiteral') {
+        const value = def.value;
+        return { type: typeof value, const: value };
+    }
+    if (typeName === 'ZodDate')
+        return { type: 'string', format: 'date-time' };
+    if (typeName === 'ZodEffects')
+        return zodToJsonSchema(def.schema);
+    if (typeName === 'ZodRecord')
+        return { type: 'object', additionalProperties: zodToJsonSchema(def.valueType) };
+    if (typeName === 'ZodTuple') {
+        // biome-ignore lint/suspicious/noExplicitAny: Zod internal tuple item types
+        const items = def.items.map((i) => zodToJsonSchema(i));
+        return { type: 'array', items, minItems: items.length, maxItems: items.length };
+    }
+    if (typeName === 'ZodIntersection') {
+        return { allOf: [zodToJsonSchema(def.left), zodToJsonSchema(def.right)] };
+    }
+    if (typeName === 'ZodNull')
+        return { type: 'null' };
+    if (typeName === 'ZodAny')
+        return {};
+    if (typeName === 'ZodNativeEnum') {
+        const values = Object.values(def.values).filter((v) => typeof v === 'string' || typeof v === 'number');
+        return { enum: values };
+    }
+    if (typeName === 'ZodLazy')
+        return zodToJsonSchema(def.getter());
+    return {};
+}
+// --- Command Graph ---
+export { defineCommandGraph, getCommandScope, isCommandAllowed, isModuleAllowed, } from './define-command-graph.js';
+// --- DML → Zod ---
+export { dmlToZod } from './dml-to-zod.js';
+// --- Auto-generated entity commands ---
+export { generateEntityCommands, generateLinkCommands, generateModuleCommands } from './generate-entity-commands.js';
+//# sourceMappingURL=index.js.map

package/dist/command/index.js.map

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

package/dist/command/types.d.ts

@@ -0,0 +1,131 @@
+import type { z } from 'zod';
+import type { DmlEntity } from '../dml/entity.js';
+import type { MantaEventMap } from '../events/types.js';
+import type { ILoggerPort } from '../ports/logger.js';
+import type { StepContext } from '../workflows/types.js';
+type ImplicitKeys = 'id' | 'metadata' | 'created_at' | 'updated_at' | 'deleted_at';
+/** Extract keys where the value can be null */
+type NullableKeys<T> = {
+    [K in keyof T]: null extends T[K] ? K : never;
+}[keyof T];
+/** Extract keys where the value cannot be null */
+type RequiredKeys<T> = Exclude<keyof T, NullableKeys<T> | ImplicitKeys>;
+/** Extract keys where the value can be null (minus implicit) */
+type OptionalKeys<T> = Exclude<NullableKeys<T>, ImplicitKeys>;
+/**
+ * Create input type: non-nullable fields are required, nullable fields are optional.
+ * Implicit columns (id, timestamps) are excluded.
+ */
+type CreateInput<E> = {
+    [K in RequiredKeys<E>]: E[K];
+} & {
+    [K in OptionalKeys<E>]?: E[K];
+};
+/** Step methods for a single entity module. Typed from DML. */
+export type EntityStep<E> = {
+    create(data: CreateInput<E>): Promise<E>;
+    update(id: string, data: Partial<E>): Promise<E>;
+    delete(id: string): Promise<{
+        id: string;
+        deletedLinks: Array<{
+            tableName: string;
+            linkId: string;
+        }>;
+        deletedChildren: Array<{
+            entity: string;
+            id: string;
+        }>;
+        dismissedLinks: Array<{
+            tableName: string;
+            linkId: string;
+        }>;
+    }>;
+    link: Record<string, (extraColumns?: Record<string, unknown>) => Promise<{
+        linkId: string;
+    }>>;
+} & {
+    /** Custom service methods (publish, archive, etc.) resolved at runtime via Proxy. */
+    [method: string]: (...args: any[]) => Promise<any>;
+};
+/**
+ * Global entity registry — augmented by .manta/types.ts (auto-generated at boot).
+ * When populated, step.product.create() is typed without `entities` declaration.
+ */
+export interface MantaEntities extends MantaGeneratedEntities {
+}
+/** Entity ref for step.link() — tagged object from create() or explicit { entity, id } */
+export interface EntityRef {
+    entity: string;
+    id: string;
+}
+/** Step utilities (emit, action, link, agent) */
+interface StepUtilities {
+    /** Link two entities. Validates that a defineLink exists between them. */
+    link<A extends {
+        id: string;
+    }, B extends {
+        id: string;
+    }>(a: A, b: B, extraColumns?: Record<string, unknown>): Promise<{
+        linkId: string;
+    }>;
+    /** Emit a known event with typed data (from MantaEventMap codegen). */
+    emit<E extends keyof MantaEventMap>(eventName: E, data: MantaEventMap[E]): Promise<void>;
+    /** Emit an unknown event (fallback). */
+    emit(eventName: string, data: Record<string, unknown>): Promise<void>;
+    action<TInput, TOutput>(name: string, config: {
+        invoke: (input: TInput, ctx: StepContext) => Promise<TOutput>;
+        compensate: (output: TOutput, ctx: StepContext) => Promise<void>;
+    }): (input: TInput) => Promise<TOutput>;
+    agent: MantaGeneratedAgents;
+}
+/** Command namespace — step.command.NAME(input) */
+type CommandNamespace = MantaCommands;
+/**
+ * Typed step proxy — categorized.
+ * - step.service.MODULE.method() — service CRUD + compensable methods
+ * - step.command.NAME(input) — sub-workflow
+ * - step.agent.NAME(input) — AI call
+ * - step.action(name, config) — external action
+ * - step.emit(event, data) — fire event
+ */
+export type TypedStep<_TEntities = MantaEntities> = {
+    service: MantaGeneratedAppModules;
+    command: CommandNamespace;
+} & StepUtilities;
+/** Internal command definition — workflow receives raw (input, ctx). Used by bootstrap/registry. */
+export interface CommandDefinition<TInput = unknown, TOutput = unknown> {
+    __type: 'command';
+    name: string;
+    description: string;
+    input: z.ZodType<TInput>;
+    workflow: (input: TInput, ctx: StepContext) => Promise<TOutput>;
+    /** If set, this command is scoped to a module — step.service only resolves this module's entities. */
+    __moduleScope?: string;
+}
+/** What the developer writes — workflow receives typed { step, log }. */
+export interface TypedCommandConfig<_TInput, TOutput, TEntities extends Record<string, DmlEntity<any>> = MantaEntities & Record<string, DmlEntity<any>>, TSchema extends z.ZodType = z.ZodType> {
+    name: string;
+    description: string;
+    entities?: TEntities;
+    input: TSchema;
+    workflow: (input: z.output<TSchema>, context: {
+        step: TypedStep;
+        log: ILoggerPort;
+        auth: import('../auth/types.js').AuthContext | null;
+        headers: Record<string, string | undefined>;
+    }) => Promise<TOutput>;
+}
+/**
+ * Command callables registry — augmented by .manta/types/ codegen.
+ * When codegen runs, `commands.reserveStock()` gets full autocomplete.
+ */
+export interface MantaCommands extends MantaGeneratedCommands {
+}
+/** JSON Schema exposed for AI tool discovery */
+export interface CommandToolSchema {
+    name: string;
+    description: string;
+    input_schema: Record<string, unknown>;
+}
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/command/types.d.ts.map

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

package/dist/command/types.js

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

package/dist/command/types.js.map

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

package/dist/config/built-in-presets.d.ts

@@ -0,0 +1,20 @@
+import type { PresetDefinition } from './presets.js';
+/**
+ * Dev preset — PG local + Pino pretty + all in-memory except DB/HTTP.
+ */
+export declare const devPreset: PresetDefinition;
+/**
+ * Vercel preset — Neon + Pino JSON + Upstash + Vercel services.
+ */
+export declare const vercelPreset: PresetDefinition;
+/**
+ * Cloudflare Workers preset — Neon over HTTP + fetch-compatible adapters.
+ *
+ * Keep the service shape close to Vercel, but avoid Vercel-only storage and
+ * cron primitives. Cloudflare cron bindings are handled at the Nitro/Wrangler
+ * layer; Manta still exposes the same HTTP-triggerable job scheduler contract.
+ */
+export declare const cloudflarePreset: PresetDefinition;
+/** Map of built-in preset names to their definitions */
+export declare const BUILT_IN_PRESETS: Record<string, PresetDefinition>;
+//# sourceMappingURL=built-in-presets.d.ts.map

package/dist/config/built-in-presets.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-presets.d.ts","sourceRoot":"","sources":["../../src/config/built-in-presets.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGpD;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,gBAetB,CAAA;AAEF;;GAEG;AACH,eAAO,MAAM,YAAY,EAAE,gBAezB,CAAA;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,EAAE,gBAe7B,CAAA;AAEF,wDAAwD;AACxD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAI7D,CAAA"}

package/dist/config/built-in-presets.js

@@ -0,0 +1,70 @@
+// Built-in presets for common deployment targets
+import { definePreset } from './presets.js';
+/**
+ * Dev preset — PG local + Pino pretty + all in-memory except DB/HTTP.
+ */
+export const devPreset = definePreset({
+    name: 'dev',
+    profile: 'dev',
+    adapters: {
+        ILoggerPort: { adapter: '@mantajs/adapter-logger-pino', options: { pretty: true } },
+        IDatabasePort: { adapter: '@mantajs/adapter-database-pg' },
+        ISchemaGenerator: { adapter: '@mantajs/adapter-database-pg/DrizzleSchemaGenerator' },
+        IRepositoryFactory: { adapter: '@mantajs/adapter-database-pg/DrizzleRepositoryFactory' },
+        ICachePort: { adapter: '@mantajs/core/InMemoryCacheAdapter' },
+        IEventBusPort: { adapter: '@mantajs/core/InMemoryEventBusAdapter' },
+        ILockingPort: { adapter: '@mantajs/core/InMemoryLockingAdapter' },
+        IFilePort: { adapter: '@mantajs/core/InMemoryFileAdapter' },
+        IJobSchedulerPort: { adapter: '@mantajs/core/InMemoryJobScheduler' },
+        IHttpPort: { adapter: '@mantajs/adapter-h3' },
+    },
+});
+/**
+ * Vercel preset — Neon + Pino JSON + Upstash + Vercel services.
+ */
+export const vercelPreset = definePreset({
+    name: 'vercel',
+    profile: 'prod',
+    adapters: {
+        ILoggerPort: { adapter: '@mantajs/adapter-logger-pino', options: { pretty: false } },
+        IDatabasePort: { adapter: '@mantajs/adapter-database-neon' },
+        ISchemaGenerator: { adapter: '@mantajs/adapter-database-pg/DrizzleSchemaGenerator' },
+        IRepositoryFactory: { adapter: '@mantajs/adapter-database-pg/DrizzleRepositoryFactory' },
+        ICachePort: { adapter: '@mantajs/adapter-cache-upstash' },
+        IEventBusPort: { adapter: '@mantajs/adapter-eventbus-upstash' },
+        ILockingPort: { adapter: '@mantajs/adapter-locking-neon' },
+        IFilePort: { adapter: '@mantajs/adapter-file-vercel-blob' },
+        IJobSchedulerPort: { adapter: '@mantajs/adapter-jobs-vercel-cron' },
+        IHttpPort: { adapter: '@mantajs/adapter-h3' },
+    },
+});
+/**
+ * Cloudflare Workers preset — Neon over HTTP + fetch-compatible adapters.
+ *
+ * Keep the service shape close to Vercel, but avoid Vercel-only storage and
+ * cron primitives. Cloudflare cron bindings are handled at the Nitro/Wrangler
+ * layer; Manta still exposes the same HTTP-triggerable job scheduler contract.
+ */
+export const cloudflarePreset = definePreset({
+    name: 'cloudflare',
+    profile: 'prod',
+    adapters: {
+        ILoggerPort: { adapter: '@mantajs/core/ConsoleLoggerAdapter', options: { level: 'info' } },
+        IDatabasePort: { adapter: '@mantajs/adapter-database-neon' },
+        ISchemaGenerator: { adapter: '@mantajs/adapter-database-pg/DrizzleSchemaGenerator' },
+        IRepositoryFactory: { adapter: '@mantajs/adapter-database-pg/DrizzleRepositoryFactory' },
+        ICachePort: { adapter: '@mantajs/adapter-cache-upstash' },
+        IEventBusPort: { adapter: '@mantajs/adapter-eventbus-upstash' },
+        ILockingPort: { adapter: '@mantajs/adapter-locking-neon' },
+        IFilePort: { adapter: '@mantajs/core/InMemoryFileAdapter' },
+        IJobSchedulerPort: { adapter: '@mantajs/adapter-jobs-vercel-cron' },
+        IHttpPort: { adapter: '@mantajs/adapter-h3' },
+    },
+});
+/** Map of built-in preset names to their definitions */
+export const BUILT_IN_PRESETS = {
+    dev: devPreset,
+    vercel: vercelPreset,
+    cloudflare: cloudflarePreset,
+};
+//# sourceMappingURL=built-in-presets.js.map

package/dist/config/built-in-presets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"built-in-presets.js","sourceRoot":"","sources":["../../src/config/built-in-presets.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAGjD,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAE3C;;GAEG;AACH,MAAM,CAAC,MAAM,SAAS,GAAqB,YAAY,CAAC;IACtD,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,KAAK;IACd,QAAQ,EAAE;QACR,WAAW,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;QACnF,aAAa,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE;QAC1D,gBAAgB,EAAE,EAAE,OAAO,EAAE,qDAAqD,EAAE;QACpF,kBAAkB,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;QACxF,UAAU,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE;QAC7D,aAAa,EAAE,EAAE,OAAO,EAAE,uCAAuC,EAAE;QACnE,YAAY,EAAE,EAAE,OAAO,EAAE,sCAAsC,EAAE;QACjE,SAAS,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QAC3D,iBAAiB,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE;QACpE,SAAS,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE;KAC9C;CACF,CAAC,CAAA;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAqB,YAAY,CAAC;IACzD,IAAI,EAAE,QAAQ;IACd,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE;QACR,WAAW,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE;QACpF,aAAa,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE;QAC5D,gBAAgB,EAAE,EAAE,OAAO,EAAE,qDAAqD,EAAE;QACpF,kBAAkB,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;QACxF,UAAU,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE;QACzD,aAAa,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QAC/D,YAAY,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE;QAC1D,SAAS,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QAC3D,iBAAiB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QACnE,SAAS,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE;KAC9C;CACF,CAAC,CAAA;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAqB,YAAY,CAAC;IAC7D,IAAI,EAAE,YAAY;IAClB,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE;QACR,WAAW,EAAE,EAAE,OAAO,EAAE,oCAAoC,EAAE,OAAO,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;QAC1F,aAAa,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE;QAC5D,gBAAgB,EAAE,EAAE,OAAO,EAAE,qDAAqD,EAAE;QACpF,kBAAkB,EAAE,EAAE,OAAO,EAAE,uDAAuD,EAAE;QACxF,UAAU,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE;QACzD,aAAa,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QAC/D,YAAY,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE;QAC1D,SAAS,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QAC3D,iBAAiB,EAAE,EAAE,OAAO,EAAE,mCAAmC,EAAE;QACnE,SAAS,EAAE,EAAE,OAAO,EAAE,qBAAqB,EAAE;KAC9C;CACF,CAAC,CAAA;AAEF,wDAAwD;AACxD,MAAM,CAAC,MAAM,gBAAgB,GAAqC;IAChE,GAAG,EAAE,SAAS;IACd,MAAM,EAAE,YAAY;IACpB,UAAU,EAAE,gBAAgB;CAC7B,CAAA"}