@mantajs/core 0.1.7 → 0.2.0-beta.0

package/dist/command/define-command-graph.d.ts

@@ -0,0 +1,63 @@
+import type { AuthContext } from '../auth/types';
+/**
+ * Module name for command graph access — autocompletes from codegen.
+ */
+type ModuleNameArg = keyof MantaGeneratedAppModules | (string & {});
+/**
+ * Per-module command access rule:
+ * - `true` — all commands of this module
+ * - `string[]` — only these command operations (e.g. ['create', 'update', 'delete'])
+ * - `(auth) => filters` — all commands, but with row-level scope injected into context
+ */
+export type CommandAccessRule = true | string[] | ((auth: AuthContext) => Record<string, unknown>);
+/**
+ * Module access map — defines which modules' commands are accessible and how.
+ */
+export type CommandAccessMap = Record<string, CommandAccessRule>;
+/**
+ * Command graph definition — controls which module commands are exposed in a context.
+ */
+export interface CommandGraphDefinition {
+    __type: 'command-graph';
+    /** '*' = wildcard (all modules, all commands). Otherwise per-module rules. */
+    access: '*' | CommandAccessMap;
+}
+/**
+ * Define command graph access for a context.
+ *
+ * @example
+ * ```typescript
+ * // src/commands/admin/graph.ts — full access
+ * export default defineCommandGraph('*')
+ *
+ * // src/commands/store/graph.ts — scoped access
+ * export default defineCommandGraph({
+ *   catalog: true,                                        // all catalog commands
+ *   customer: ['create', 'update'],                       // only create + update
+ *   order: (auth) => ({ customer_id: auth.id }),          // all commands, scoped to user
+ * })
+ * ```
+ */
+export declare function defineCommandGraph(access: '*'): CommandGraphDefinition;
+export declare function defineCommandGraph(access: Record<ModuleNameArg, CommandAccessRule>): CommandGraphDefinition;
+/**
+ * Check if a module is allowed by the command graph definition.
+ */
+export declare function isModuleAllowed(def: CommandGraphDefinition, moduleName: string): boolean;
+/**
+ * Check if a specific command operation is allowed for a module.
+ * @param def - Command graph definition
+ * @param moduleName - Module name (e.g. 'catalog')
+ * @param operation - Command operation (e.g. 'create', 'update', 'delete', or custom name)
+ * @returns true if allowed, false if blocked
+ */
+export declare function isCommandAllowed(def: CommandGraphDefinition, moduleName: string, operation: string): boolean;
+/**
+ * Get the row-level scope for a module's commands, given the auth context.
+ * Returns undefined if no scope (wildcard, `true`, or array rule).
+ * Returns the scope record if a function rule is defined.
+ * Returns null if module is not allowed.
+ */
+export declare function getCommandScope(def: CommandGraphDefinition, moduleName: string, auth: AuthContext | null): Record<string, unknown> | undefined | null;
+export {};
+//# sourceMappingURL=define-command-graph.d.ts.map

package/dist/command/define-command-graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command-graph.d.ts","sourceRoot":"","sources":["../../src/command/define-command-graph.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAGhD;;GAEG;AACH,KAAK,aAAa,GAAG,MAAM,wBAAwB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,CAAA;AAEnE;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GAAG,IAAI,GAAG,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,WAAW,KAAK,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAElG;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAA;AAEhE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,eAAe,CAAA;IACvB,8EAA8E;IAC9E,MAAM,EAAE,GAAG,GAAG,gBAAgB,CAAA;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,GAAG,GAAG,sBAAsB,CAAA;AACvE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,CAAC,aAAa,EAAE,iBAAiB,CAAC,GAAG,sBAAsB,CAAA;AAe5G;;GAEG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAGxF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,sBAAsB,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAS5G;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,GAAG,EAAE,sBAAsB,EAC3B,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,WAAW,GAAG,IAAI,GACvB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,IAAI,CAO5C"}

package/dist/command/define-command-graph.js

@@ -0,0 +1,80 @@
+// defineCommandGraph — Expose module commands for a context via catch-all route.
+//
+// Three modes:
+//   defineCommandGraph('*')                              → wildcard, all module commands
+//   defineCommandGraph({ catalog: true, customer: ['create', 'update'] })
+//                                                        → per-module filtering
+//   No defineCommandGraph = no catch-all command access   → only explicit defineCommand routes
+//
+// Usage:
+//   // src/commands/admin/graph.ts — full access
+//   export default defineCommandGraph('*')
+//
+//   // src/commands/store/graph.ts — scoped access
+//   export default defineCommandGraph({
+//     catalog: true,
+//     customer: ['create', 'update'],
+//     order: (auth) => ({ customer_id: auth.id }),
+//   })
+import { MantaError } from '../errors/manta-error';
+export function defineCommandGraph(access) {
+    if (access !== '*' && (typeof access !== 'object' || access === null)) {
+        throw new MantaError('INVALID_DATA', 'defineCommandGraph() requires "*" or a module access map');
+    }
+    if (typeof access === 'object' && Object.keys(access).length === 0) {
+        throw new MantaError('INVALID_DATA', 'defineCommandGraph() module map cannot be empty. Use "*" for full access.');
+    }
+    return {
+        __type: 'command-graph',
+        access,
+    };
+}
+/**
+ * Check if a module is allowed by the command graph definition.
+ */
+export function isModuleAllowed(def, moduleName) {
+    if (def.access === '*')
+        return true;
+    return moduleName in def.access;
+}
+/**
+ * Check if a specific command operation is allowed for a module.
+ * @param def - Command graph definition
+ * @param moduleName - Module name (e.g. 'catalog')
+ * @param operation - Command operation (e.g. 'create', 'update', 'delete', or custom name)
+ * @returns true if allowed, false if blocked
+ */
+export function isCommandAllowed(def, moduleName, operation) {
+    if (def.access === '*')
+        return true;
+    const rule = def.access[moduleName];
+    if (rule === undefined)
+        return false;
+    if (rule === true)
+        return true;
+    if (Array.isArray(rule))
+        return rule.includes(operation);
+    // Function rule = all commands allowed (scoping is applied at execution time)
+    if (typeof rule === 'function')
+        return true;
+    return false;
+}
+/**
+ * Get the row-level scope for a module's commands, given the auth context.
+ * Returns undefined if no scope (wildcard, `true`, or array rule).
+ * Returns the scope record if a function rule is defined.
+ * Returns null if module is not allowed.
+ */
+export function getCommandScope(def, moduleName, auth) {
+    if (def.access === '*')
+        return undefined; // no scope
+    const rule = def.access[moduleName];
+    if (rule === undefined)
+        return null; // not allowed
+    if (rule === true || Array.isArray(rule))
+        return undefined; // no scope
+    if (!auth)
+        return null; // scoped module but no auth → blocked
+    return rule(auth);
+}
+//# sourceMappingURL=define-command-graph.js.map

package/dist/command/define-command-graph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-command-graph.js","sourceRoot":"","sources":["../../src/command/define-command-graph.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,EAAE;AACF,eAAe;AACf,yFAAyF;AACzF,0EAA0E;AAC1E,gFAAgF;AAChF,+FAA+F;AAC/F,EAAE;AACF,SAAS;AACT,iDAAiD;AACjD,2CAA2C;AAC3C,EAAE;AACF,mDAAmD;AACnD,wCAAwC;AACxC,qBAAqB;AACrB,sCAAsC;AACtC,mDAAmD;AACnD,OAAO;AAGP,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAA;AA+ClD,MAAM,UAAU,kBAAkB,CAAC,MAAsD;IACvF,IAAI,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,CAAC,EAAE,CAAC;QACtE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,0DAA0D,CAAC,CAAA;IAClG,CAAC;IACD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACnE,MAAM,IAAI,UAAU,CAAC,cAAc,EAAE,2EAA2E,CAAC,CAAA;IACnH,CAAC;IAED,OAAO;QACL,MAAM,EAAE,eAAe;QACvB,MAAM;KACP,CAAA;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,GAA2B,EAAE,UAAkB;IAC7E,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IACnC,OAAO,UAAU,IAAI,GAAG,CAAC,MAAM,CAAA;AACjC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAA2B,EAAE,UAAkB,EAAE,SAAiB;IACjG,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,CAAA;IACnC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACnC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,KAAK,CAAA;IACpC,IAAI,IAAI,KAAK,IAAI;QAAE,OAAO,IAAI,CAAA;IAC9B,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA;IACxD,8EAA8E;IAC9E,IAAI,OAAO,IAAI,KAAK,UAAU;QAAE,OAAO,IAAI,CAAA;IAC3C,OAAO,KAAK,CAAA;AACd,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,GAA2B,EAC3B,UAAkB,EAClB,IAAwB;IAExB,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,SAAS,CAAA,CAAC,WAAW;IACpD,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;IACnC,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA,CAAC,cAAc;IAClD,IAAI,IAAI,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAA,CAAC,WAAW;IACtE,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA,CAAC,sCAAsC;IAC7D,OAAO,IAAI,CAAC,IAAI,CAAC,CAAA;AACnB,CAAC"}

package/dist/command/dml-to-zod.d.ts

@@ -0,0 +1,34 @@
+import { z } from 'zod';
+import type { DmlEntity } from '../dml/entity';
+export interface EntityZodSchemas {
+    /** Zod schema for create input — required fields required, nullable/default fields optional */
+    create: z.ZodObject<Record<string, z.ZodType>>;
+    /** Zod schema for update input — all fields optional + required `id` */
+    update: z.ZodObject<Record<string, z.ZodType>>;
+    /** Zod schema for delete input — just `id` (or `ids` for bulk) */
+    delete: z.ZodObject<Record<string, z.ZodType>>;
+    /** Zod schema for retrieve input — just `id` */
+    retrieve: z.ZodObject<Record<string, z.ZodType>>;
+    /** Zod schema for list input — filters + pagination */
+    list: z.ZodObject<Record<string, z.ZodType>>;
+}
+/**
+ * Generate Zod schemas from a DML entity for auto-generated commands.
+ *
+ * @example
+ * ```typescript
+ * const Product = defineModel('Product', {
+ *   title: field.text(),
+ *   price: field.number(),
+ *   status: field.enum(['draft', 'active']),
+ *   description: field.text().nullable(),
+ * })
+ *
+ * const schemas = dmlToZod(Product)
+ * // schemas.create → z.object({ title: z.string(), price: z.number(), status: z.enum([...]), description: z.string().nullable().optional() })
+ * // schemas.update → z.object({ id: z.string(), title: z.string().optional(), ... })
+ * // schemas.delete → z.object({ id: z.string() })
+ * ```
+ */
+export declare function dmlToZod(entity: DmlEntity): EntityZodSchemas;
+//# sourceMappingURL=dml-to-zod.d.ts.map

package/dist/command/dml-to-zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dml-to-zod.d.ts","sourceRoot":"","sources":["../../src/command/dml-to-zod.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AACvB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA8G9C,MAAM,WAAW,gBAAgB;IAC/B,+FAA+F;IAC/F,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,wEAAwE;IACxE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,kEAAkE;IAClE,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAC9C,gDAAgD;IAChD,QAAQ,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;IAChD,uDAAuD;IACvD,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAA;CAC7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,SAAS,GAAG,gBAAgB,CA0C5D"}

package/dist/command/dml-to-zod.js

@@ -0,0 +1,140 @@
+// dmlToZod — Convert a DML entity schema to Zod schemas for auto-generated commands.
+//
+// Given a DmlEntity, produces:
+//   createSchema  — required fields required, nullable fields optional
+//   updateSchema  — all fields optional + required `id`
+//
+// Implicit fields (id, created_at, updated_at, deleted_at) are excluded from create input.
+import { z } from 'zod';
+import { DmlEntity as DmlEntityClass } from '../dml/entity';
+const IMPLICIT_FIELDS = new Set(['id', 'metadata', 'created_at', 'updated_at', 'deleted_at']);
+/**
+ * Map a DML property dataType.name to a Zod type.
+ */
+function propertyToZod(meta) {
+    let schema;
+    switch (meta.dataType.name) {
+        case 'text':
+            schema = z.string();
+            break;
+        case 'number':
+        case 'float':
+        case 'bigNumber':
+        case 'autoIncrement':
+            schema = z.number();
+            break;
+        case 'boolean':
+            schema = z.boolean();
+            break;
+        case 'dateTime':
+            schema = z.string().datetime().or(z.date());
+            break;
+        case 'json':
+            schema = z.unknown();
+            break;
+        case 'enum': {
+            const values = (meta.values ?? meta.dataType.options?.values);
+            if (values && values.length > 0) {
+                schema = z.enum(values);
+            }
+            else {
+                schema = z.string();
+            }
+            break;
+        }
+        case 'array':
+            schema = z.array(z.unknown());
+            break;
+        default:
+            schema = z.unknown();
+    }
+    if (meta.nullable) {
+        schema = schema.nullable();
+    }
+    return schema;
+}
+/**
+ * Parse a DmlEntity schema into field metadata.
+ * Handles both DmlPropertyDefinition objects (with parse()) and DmlRelationDefinition objects.
+ */
+function parseEntityFields(entity) {
+    const fields = [];
+    for (const [key, value] of Object.entries(entity.schema)) {
+        if (IMPLICIT_FIELDS.has(key))
+            continue;
+        // Skip relations
+        if (DmlEntityClass.isRelation(value))
+            continue;
+        // Parse property metadata
+        if (typeof value.parse === 'function') {
+            const meta = value.parse(key);
+            // Skip computed properties (not stored)
+            if (meta.computed)
+                continue;
+            fields.push({
+                fieldName: key,
+                zodType: propertyToZod(meta),
+                nullable: meta.nullable,
+                hasDefault: meta.defaultValue !== undefined,
+            });
+        }
+    }
+    return fields;
+}
+/**
+ * Generate Zod schemas from a DML entity for auto-generated commands.
+ *
+ * @example
+ * ```typescript
+ * const Product = defineModel('Product', {
+ *   title: field.text(),
+ *   price: field.number(),
+ *   status: field.enum(['draft', 'active']),
+ *   description: field.text().nullable(),
+ * })
+ *
+ * const schemas = dmlToZod(Product)
+ * // schemas.create → z.object({ title: z.string(), price: z.number(), status: z.enum([...]), description: z.string().nullable().optional() })
+ * // schemas.update → z.object({ id: z.string(), title: z.string().optional(), ... })
+ * // schemas.delete → z.object({ id: z.string() })
+ * ```
+ */
+export function dmlToZod(entity) {
+    const fields = parseEntityFields(entity);
+    // --- Create schema ---
+    const createShape = {};
+    for (const f of fields) {
+        if (f.nullable || f.hasDefault) {
+            // Nullable or has default → optional in create
+            createShape[f.fieldName] = f.zodType.optional();
+        }
+        else {
+            // Required
+            createShape[f.fieldName] = f.zodType;
+        }
+    }
+    const create = z.object(createShape);
+    // --- Update schema ---
+    const updateShape = { id: z.string() };
+    for (const f of fields) {
+        updateShape[f.fieldName] = f.zodType.optional();
+    }
+    const update = z.object(updateShape);
+    // --- Delete schema ---
+    const del = z.object({
+        id: z.string(),
+    });
+    // --- Retrieve schema ---
+    const retrieve = z.object({
+        id: z.string(),
+    });
+    // --- List schema ---
+    const list = z.object({
+        filters: z.record(z.unknown()).optional(),
+        limit: z.number().int().min(1).max(1000).optional(),
+        offset: z.number().int().min(0).optional(),
+        order: z.record(z.enum(['ASC', 'DESC'])).optional(),
+    });
+    return { create, update, delete: del, retrieve, list };
+}
+//# sourceMappingURL=dml-to-zod.js.map

package/dist/command/dml-to-zod.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dml-to-zod.js","sourceRoot":"","sources":["../../src/command/dml-to-zod.ts"],"names":[],"mappings":"AAAA,qFAAqF;AACrF,EAAE;AACF,+BAA+B;AAC/B,uEAAuE;AACvE,wDAAwD;AACxD,EAAE;AACF,2FAA2F;AAE3F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAEvB,OAAO,EAAE,SAAS,IAAI,cAAc,EAAE,MAAM,eAAe,CAAA;AAE3D,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC,CAAA;AAE7F;;GAEG;AACH,SAAS,aAAa,CAAC,IAKtB;IACC,IAAI,MAAiB,CAAA;IAErB,QAAQ,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC3B,KAAK,MAAM;YACT,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAA;YACnB,MAAK;QACP,KAAK,QAAQ,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,WAAW,CAAC;QACjB,KAAK,eAAe;YAClB,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAA;YACnB,MAAK;QACP,KAAK,SAAS;YACZ,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;YACpB,MAAK;QACP,KAAK,UAAU;YACb,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YAC3C,MAAK;QACP,KAAK,MAAM;YACT,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;YACpB,MAAK;QACP,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAA+C,CAAA;YAC3G,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAChC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,MAA+B,CAAC,CAAA;YAClD,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAA;YACrB,CAAC;YACD,MAAK;QACP,CAAC;QACD,KAAK,OAAO;YACV,MAAM,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAA;YAC7B,MAAK;QACP;YACE,MAAM,GAAG,CAAC,CAAC,OAAO,EAAE,CAAA;IACxB,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAClB,MAAM,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAA;IAC5B,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;GAGG;AACH,SAAS,iBAAiB,CAAC,MAAiB;IAM1C,MAAM,MAAM,GAKP,EAAE,CAAA;IAEP,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;QACzD,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,SAAQ;QAEtC,iBAAiB;QACjB,IAAI,cAAc,CAAC,UAAU,CAAC,KAAK,CAAC;YAAE,SAAQ;QAE9C,0BAA0B;QAC1B,IAAI,OAAQ,KAA6B,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC/D,MAAM,IAAI,GACR,KASD,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;YAEZ,wCAAwC;YACxC,IAAI,IAAI,CAAC,QAAQ;gBAAE,SAAQ;YAE3B,MAAM,CAAC,IAAI,CAAC;gBACV,SAAS,EAAE,GAAG;gBACd,OAAO,EAAE,aAAa,CAAC,IAAI,CAAC;gBAC5B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,UAAU,EAAE,IAAI,CAAC,YAAY,KAAK,SAAS;aAC5C,CAAC,CAAA;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAA;AACf,CAAC;AAeD;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,MAAM,GAAG,iBAAiB,CAAC,MAAM,CAAC,CAAA;IAExC,wBAAwB;IACxB,MAAM,WAAW,GAA8B,EAAE,CAAA;IACjD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,UAAU,EAAE,CAAC;YAC/B,+CAA+C;YAC/C,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;QACjD,CAAC;aAAM,CAAC;YACN,WAAW;YACX,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAA;QACtC,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAEpC,wBAAwB;IACxB,MAAM,WAAW,GAA8B,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAA;IACjE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,WAAW,CAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAA;IACjD,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAA;IAEpC,wBAAwB;IACxB,MAAM,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC;QACnB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC,CAAA;IAEF,0BAA0B;IAC1B,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;QACxB,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;KACf,CAAC,CAAA;IAEF,sBAAsB;IACtB,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAC;QACpB,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;QACzC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;QACnD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QAC1C,KAAK,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KACpD,CAAC,CAAA;IAEF,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AACxD,CAAC"}

package/dist/command/generate-entity-commands.d.ts

@@ -0,0 +1,68 @@
+import type { DmlEntity } from '../dml/entity';
+import type { ResolvedLink } from '../link';
+import type { CommandDefinition } from './types';
+/**
+ * Entity command operation type.
+ * Used for filtering in defineCommandGraph (e.g. customer: ['create', 'update']).
+ */
+export type EntityCommandOperation = 'create' | 'update' | 'delete' | 'retrieve' | 'list' | 'link' | 'unlink';
+/**
+ * A generated entity command — a CommandDefinition augmented with module/entity metadata.
+ */
+export interface EntityCommand extends CommandDefinition {
+    /** Module this command belongs to (e.g. 'catalog') */
+    __module: string;
+    /** Entity this command operates on (e.g. 'Product') */
+    __entity: string;
+    /** CRUD operation type */
+    __operation: EntityCommandOperation;
+    /** Whether this is an auto-generated command (vs explicit) */
+    __autoGenerated: true;
+}
+/**
+ * Generate CRUD commands for a single entity within a module.
+ *
+ * Command names use camelCase for ergonomic `step.command.createProduct()` usage.
+ * The HTTP route handler converts kebab-case URLs to camelCase for lookup.
+ *
+ * @param moduleName - Module name (e.g. 'customer')
+ * @param entity - DML entity definition
+ * @returns Array of auto-generated EntityCommand definitions
+ *
+ * @example
+ * ```typescript
+ * const Customer = defineModel('Customer', { email: field.text(), name: field.text() })
+ * const commands = generateEntityCommands('customer', Customer)
+ * // → [
+ * //   { name: 'createCustomer', ... },
+ * //   { name: 'updateCustomer', ... },
+ * //   { name: 'deleteCustomer', ... },
+ * //   { name: 'retrieveCustomer', ... },
+ * //   { name: 'listCustomers', ... },
+ * // ]
+ * // Usage: step.command.createCustomer({ email: '...' })
+ * // HTTP:  POST /api/admin/command/create-customer
+ * ```
+ */
+export declare function generateEntityCommands(moduleName: string, entity: DmlEntity): EntityCommand[];
+/**
+ * Generate entity commands for all entities in a module.
+ */
+export declare function generateModuleCommands(moduleName: string, models: Record<string, DmlEntity>): EntityCommand[];
+/**
+ * Generate link and unlink commands for a ResolvedLink.
+ *
+ * Names are camelCase for ergonomic usage: `step.command.linkCustomerCustomerGroup()`
+ *
+ * @example
+ * ```typescript
+ * // From: defineLink(many('customer'), many('customer_group'))
+ * // Generates:
+ * //   { name: 'linkCustomerCustomerGroup', ... }
+ * //   { name: 'unlinkCustomerCustomerGroup', ... }
+ * // Usage: step.command.linkCustomerCustomerGroup({ customer_id: '...', customer_group_id: '...' })
+ * // HTTP:  POST /api/admin/command/link-customer-customer-group
+ * ```
+ */
+export declare function generateLinkCommands(link: ResolvedLink): EntityCommand[];
+//# sourceMappingURL=generate-entity-commands.d.ts.map

package/dist/command/generate-entity-commands.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-entity-commands.d.ts","sourceRoot":"","sources":["../../src/command/generate-entity-commands.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAE9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAG3C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD;;;GAGG;AACH,MAAM,MAAM,sBAAsB,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAA;AAE7G;;GAEG;AACH,MAAM,WAAW,aAAc,SAAQ,iBAAiB;IACtD,sDAAsD;IACtD,QAAQ,EAAE,MAAM,CAAA;IAChB,uDAAuD;IACvD,QAAQ,EAAE,MAAM,CAAA;IAChB,0BAA0B;IAC1B,WAAW,EAAE,sBAAsB,CAAA;IACnC,8DAA8D;IAC9D,eAAe,EAAE,IAAI,CAAA;CACtB;AA2BD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS,GAAG,aAAa,EAAE,CA6I7F;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,aAAa,EAAE,CAM7G;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,aAAa,EAAE,CA8JxE"}