@mantajs/core 0.1.7 → 0.2.0-beta.0

package/dist/command/generate-entity-commands.js

@@ -0,0 +1,350 @@
+// generateEntityCommands — Auto-generate CRUD CommandDefinitions from a DML entity.
+//
+// For each entity in a module, generates atomic commands:
+//   createProduct    → service.create + emit
+//   updateProduct    → service.update + emit
+//   deleteProduct    → service.delete + emit
+//   retrieveProduct  → service.retrieve (read, no emit)
+//   listProducts     → service.list (read, no emit)
+//
+// Names are camelCase for ergonomic `step.command.createProduct()` usage.
+// The HTTP route handler converts kebab URLs to camelCase for lookup.
+import { z } from 'zod';
+import { MantaError } from '../errors/manta-error';
+import { dmlToZod } from './dml-to-zod';
+function toKebab(name) {
+    return name
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+/** Convert any casing to camelCase: 'CustomerGroup' → 'customerGroup', 'customer_group' → 'customerGroup' */
+function toCamel(name) {
+    // PascalCase → camelCase: 'CustomerGroup' → 'customerGroup'
+    const kebab = toKebab(name);
+    // kebab → camelCase: 'customer-group' → 'customerGroup'
+    return kebab.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+}
+function pluralize(name) {
+    if (name.endsWith('s') || name.endsWith('x') || name.endsWith('ch') || name.endsWith('sh')) {
+        return `${name}es`;
+    }
+    if (name.endsWith('y') && !/[aeiou]y$/i.test(name)) {
+        return `${name.slice(0, -1)}ies`;
+    }
+    return `${name}s`;
+}
+/**
+ * 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 function generateEntityCommands(moduleName, entity) {
+    const entityName = entity.name;
+    const entityCamel = toCamel(entityName);
+    const entityLower = entityName.toLowerCase();
+    const schemas = dmlToZod(entity);
+    // Capitalize first letter for method names: 'customerGroup' → 'CustomerGroup'
+    const cap = entityCamel.charAt(0).toUpperCase() + entityCamel.slice(1);
+    const capPlural = pluralize(cap);
+    const commands = [];
+    // --- create ---
+    commands.push({
+        __type: 'command',
+        __module: moduleName,
+        __entity: entityName,
+        __operation: 'create',
+        __autoGenerated: true,
+        name: `create${cap}`,
+        description: `Create a new ${entityLower}`,
+        input: schemas.create,
+        workflow: async (input, ctx) => {
+            const modules = ctx.app.modules;
+            const service = modules[entityLower] ?? modules[moduleName];
+            const result = await service[`create${pluralize(entityName)}`](input);
+            const eventBus = ctx.app.infra?.eventBus;
+            if (eventBus) {
+                const id = result?.id;
+                await eventBus.emit({
+                    eventName: `${entityLower}.created`,
+                    data: { id, ...input },
+                    metadata: { timestamp: Date.now() },
+                });
+            }
+            return result;
+        },
+    });
+    // --- update ---
+    commands.push({
+        __type: 'command',
+        __module: moduleName,
+        __entity: entityName,
+        __operation: 'update',
+        __autoGenerated: true,
+        name: `update${cap}`,
+        description: `Update an existing ${entityLower}`,
+        input: schemas.update,
+        workflow: async (input, ctx) => {
+            const { id, ...data } = input;
+            const modules = ctx.app.modules;
+            const service = modules[entityLower] ?? modules[moduleName];
+            const result = await service[`update${pluralize(entityName)}`]({ id, ...data });
+            const eventBus = ctx.app.infra?.eventBus;
+            if (eventBus) {
+                await eventBus.emit({
+                    eventName: `${entityLower}.updated`,
+                    data: { id },
+                    metadata: { timestamp: Date.now() },
+                });
+            }
+            return result;
+        },
+    });
+    // --- delete ---
+    commands.push({
+        __type: 'command',
+        __module: moduleName,
+        __entity: entityName,
+        __operation: 'delete',
+        __autoGenerated: true,
+        name: `delete${cap}`,
+        description: `Delete a ${entityLower}`,
+        input: schemas.delete,
+        workflow: async (input, ctx) => {
+            const { id } = input;
+            const modules = ctx.app.modules;
+            const service = modules[entityLower] ?? modules[moduleName];
+            await service[`delete${pluralize(entityName)}`](id);
+            const eventBus = ctx.app.infra?.eventBus;
+            if (eventBus) {
+                await eventBus.emit({
+                    eventName: `${entityLower}.deleted`,
+                    data: { id },
+                    metadata: { timestamp: Date.now() },
+                });
+            }
+            return { id, deleted: true };
+        },
+    });
+    // --- retrieve ---
+    commands.push({
+        __type: 'command',
+        __module: moduleName,
+        __entity: entityName,
+        __operation: 'retrieve',
+        __autoGenerated: true,
+        name: `retrieve${cap}`,
+        description: `Retrieve a ${entityLower} by ID`,
+        input: schemas.retrieve,
+        workflow: async (input, ctx) => {
+            const { id } = input;
+            const modules = ctx.app.modules;
+            const service = modules[entityLower] ?? modules[moduleName];
+            return service[`retrieve${entityName}`](id);
+        },
+    });
+    // --- list ---
+    commands.push({
+        __type: 'command',
+        __module: moduleName,
+        __entity: entityName,
+        __operation: 'list',
+        __autoGenerated: true,
+        name: `list${capPlural}`,
+        description: `List ${entityLower} entities`,
+        input: schemas.list,
+        workflow: async (input, ctx) => {
+            const { filters, limit, offset, order } = input;
+            const modules = ctx.app.modules;
+            const service = modules[entityLower] ?? modules[moduleName];
+            return service[`list${pluralize(entityName)}`](filters, { take: limit, skip: offset, order });
+        },
+    });
+    return commands;
+}
+/**
+ * Generate entity commands for all entities in a module.
+ */
+export function generateModuleCommands(moduleName, models) {
+    const commands = [];
+    for (const entity of Object.values(models)) {
+        commands.push(...generateEntityCommands(moduleName, entity));
+    }
+    return commands;
+}
+// ---------------------------------------------------------------------------
+// Link commands — auto-generated from defineLink() definitions
+// ---------------------------------------------------------------------------
+/**
+ * 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 function generateLinkCommands(link) {
+    const leftCamel = toCamel(link.leftEntity);
+    const rightCamel = toCamel(link.rightEntity);
+    const leftCap = leftCamel.charAt(0).toUpperCase() + leftCamel.slice(1);
+    const rightCap = rightCamel.charAt(0).toUpperCase() + rightCamel.slice(1);
+    const leftLower = link.leftEntity.toLowerCase();
+    const rightLower = link.rightEntity.toLowerCase();
+    const leftFk = link.leftFk;
+    const rightFk = link.rightFk;
+    // Build input schema: FK fields + extra columns (if any)
+    const inputFields = {
+        [leftFk]: z.string(),
+        [rightFk]: z.string(),
+    };
+    // Map DML dataType names to Zod types for extra columns
+    const extraColumnNames = [];
+    if (link.extraColumns) {
+        for (const [fieldName, fieldValue] of Object.entries(link.extraColumns)) {
+            const v = fieldValue;
+            if (typeof v?.parse === 'function') {
+                const meta = v.parse(fieldName);
+                let zodType;
+                switch (meta.dataType.name) {
+                    case 'text':
+                    case 'id':
+                    case 'enum':
+                    case 'dateTime':
+                        zodType = z.string();
+                        break;
+                    case 'number':
+                    case 'serial':
+                    case 'float':
+                        zodType = z.number();
+                        break;
+                    case 'boolean':
+                        zodType = z.boolean();
+                        break;
+                    default:
+                        zodType = z.unknown();
+                        break;
+                }
+                if (meta.nullable || meta.defaultValue !== undefined) {
+                    zodType = zodType.optional();
+                }
+                inputFields[fieldName] = zodType;
+                extraColumnNames.push(fieldName);
+            }
+        }
+    }
+    const inputSchema = z.object(inputFields);
+    const commands = [];
+    // --- link ---
+    commands.push({
+        __type: 'command',
+        __module: link.leftModule ?? leftLower,
+        __entity: `${link.leftEntity}_${link.rightEntity}`,
+        __operation: 'link',
+        __autoGenerated: true,
+        name: `link${leftCap}${rightCap}`,
+        description: `Link a ${leftLower} to a ${rightLower}`,
+        input: inputSchema,
+        workflow: async (input, ctx) => {
+            const data = input;
+            const leftId = data[leftFk];
+            const rightId = data[rightFk];
+            const db = ctx.app.infra.db;
+            const tables = ctx.app.resolve('__generatedTables');
+            const linkTable = tables.get(link.tableName);
+            if (!linkTable) {
+                throw new MantaError('NOT_FOUND', `Link table "${link.tableName}" not found`);
+            }
+            // Build values with FK fields + any extra column values from input
+            const values = {
+                id: `link_${leftId}_${rightId}`,
+                [leftFk]: leftId,
+                [rightFk]: rightId,
+                created_at: new Date(),
+                updated_at: new Date(),
+            };
+            for (const col of extraColumnNames) {
+                if (data[col] !== undefined) {
+                    values[col] = data[col];
+                }
+            }
+            await db.insert(linkTable).values(values).onConflictDoNothing();
+            const eventBus = ctx.app.infra?.eventBus;
+            if (eventBus) {
+                await eventBus.emit({
+                    eventName: `${leftLower}.${rightLower}.linked`,
+                    data: { [leftFk]: leftId, [rightFk]: rightId },
+                    metadata: { timestamp: Date.now() },
+                });
+            }
+            return { success: true };
+        },
+    });
+    // --- unlink ---
+    commands.push({
+        __type: 'command',
+        __module: link.leftModule ?? leftLower,
+        __entity: `${link.leftEntity}_${link.rightEntity}`,
+        __operation: 'unlink',
+        __autoGenerated: true,
+        name: `unlink${leftCap}${rightCap}`,
+        description: `Unlink a ${leftLower} from a ${rightLower}`,
+        input: inputSchema,
+        workflow: async (input, ctx) => {
+            const data = input;
+            const leftId = data[leftFk];
+            const rightId = data[rightFk];
+            const db = ctx.app.infra.db;
+            const tables = ctx.app.resolve('__generatedTables');
+            const linkTable = tables.get(link.tableName);
+            if (!linkTable) {
+                throw new MantaError('NOT_FOUND', `Link table "${link.tableName}" not found`);
+            }
+            // Drizzle dynamic column access — columns are passed to eq() which requires
+            // typed Drizzle column types we can't express from a string key.
+            // biome-ignore lint/suspicious/noExplicitAny: Drizzle column dynamic access
+            const linkTableCols = linkTable;
+            const leftFkCol = linkTableCols[leftFk];
+            const rightFkCol = linkTableCols[rightFk];
+            const { eq, and } = await import('drizzle-orm');
+            await db.delete(linkTable).where(and(eq(leftFkCol, leftId), eq(rightFkCol, rightId)));
+            const eventBus = ctx.app.infra?.eventBus;
+            if (eventBus) {
+                await eventBus.emit({
+                    eventName: `${leftLower}.${rightLower}.unlinked`,
+                    data: { [leftFk]: leftId, [rightFk]: rightId },
+                    metadata: { timestamp: Date.now() },
+                });
+            }
+            return { success: true };
+        },
+    });
+    return commands;
+}
+//# sourceMappingURL=generate-entity-commands.js.map

package/dist/command/generate-entity-commands.js.map

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

package/dist/command/index.d.ts

@@ -0,0 +1,54 @@
+import type { z } from 'zod';
+import type { DmlEntity } from '../dml/entity';
+import type { CommandDefinition, CommandToolSchema, TypedCommandConfig } from './types';
+/**
+ * Define a command.
+ *
+ * With `entities`: types come from the explicit declaration.
+ * Without `entities`: types come from MantaEntities (auto-generated at boot in .manta/types.ts).
+ *
+ * @example
+ * // With codegen (no entities needed):
+ * defineCommand({
+ *   name: 'create-product',
+ *   input: z.object({ title: z.string() }),
+ *   workflow: async (input, { step }) => {
+ *     const product = await step.product.create({ title: input.title })
+ *   }
+ * })
+ *
+ * // With explicit entities (before codegen is set up):
+ * defineCommand({
+ *   name: 'create-product',
+ *   entities: { product: Product, inventoryItem: InventoryItem },
+ *   input: z.object({ title: z.string() }),
+ *   workflow: async (input, { step }) => { ... }
+ * })
+ */
+export declare function defineCommand<TOutput, TEntities extends Record<string, DmlEntity<any>>, TSchema extends z.ZodType>(config: TypedCommandConfig<unknown, TOutput, TEntities, TSchema>): CommandDefinition<z.output<TSchema>, TOutput>;
+export declare function defineCommand<TInput, TOutput>(config: CommandDefinition<TInput, TOutput>): CommandDefinition<TInput, TOutput>;
+interface RegistryEntry {
+    name: string;
+    description: string;
+    inputSchema: z.ZodType;
+    workflow: (input: unknown, ctx: unknown) => Promise<unknown>;
+}
+export declare class CommandRegistry {
+    private _entries;
+    register(def: CommandDefinition<any, any>): void;
+    get(name: string): RegistryEntry | undefined;
+    list(): RegistryEntry[];
+    /** Generate tool schemas for AI discovery (commands + query) */
+    toToolSchemas(): CommandToolSchema[];
+    _reset(): void;
+}
+export declare const QUERY_TOOL_SCHEMA: CommandToolSchema;
+export declare function zodToJsonSchema(schema: z.ZodType<any>): Record<string, unknown>;
+export type { CommandAccessMap, CommandAccessRule, CommandGraphDefinition } from './define-command-graph';
+export { defineCommandGraph, getCommandScope, isCommandAllowed, isModuleAllowed, } from './define-command-graph';
+export type { EntityZodSchemas } from './dml-to-zod';
+export { dmlToZod } from './dml-to-zod';
+export type { EntityCommand, EntityCommandOperation } from './generate-entity-commands';
+export { generateEntityCommands, generateLinkCommands, generateModuleCommands } from './generate-entity-commands';
+export type { CommandDefinition, CommandToolSchema, MantaCommands, MantaEntities, TypedCommandConfig, TypedStep, } from './types';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/command/index.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAC5B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AAK9C,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAA;AA0LvF;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,wBAAgB,aAAa,CAAC,OAAO,EAAE,SAAS,SAAS,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,SAAS,CAAC,CAAC,OAAO,EAChH,MAAM,EAAE,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,CAAC,GAC/D,iBAAiB,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC,CAAA;AAGhD,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,EAC3C,MAAM,EAAE,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,GACzC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;AAuDrC,UAAU,aAAa;IACrB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,CAAA;IACnB,WAAW,EAAE,CAAC,CAAC,OAAO,CAAA;IACtB,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7D;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAmC;IAGnD,QAAQ,CAAC,GAAG,EAAE,iBAAiB,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,IAAI;IAYhD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAI5C,IAAI,IAAI,aAAa,EAAE;IAIvB,gEAAgE;IAChE,aAAa,IAAI,iBAAiB,EAAE;IAYpC,MAAM,IAAI,IAAI;CAGf;AAID,eAAO,MAAM,iBAAiB,EAAE,iBAqB/B,CAAA;AAQD,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6D/E;AAED,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAA;AAGzG,OAAO,EACL,kBAAkB,EAClB,eAAe,EACf,gBAAgB,EAChB,eAAe,GAChB,MAAM,wBAAwB,CAAA;AAC/B,YAAY,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAA;AAGpD,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AACvC,YAAY,EAAE,aAAa,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AAGvF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAA;AACjH,YAAY,EACV,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,SAAS,GACV,MAAM,SAAS,CAAA"}