@ductape/cli 0.3.17 → 0.3.19

package/dist/commands/app-actions.d.ts

@@ -0,0 +1,8 @@
+import { type CommandInteractiveFlags } from '../lib/interactive-opts.js';
+export declare function runAppActions(verb: string, opts: {
+    profile?: string;
+    app?: string;
+    action?: string;
+    file?: string;
+    json?: boolean;
+} & CommandInteractiveFlags): Promise<void>;

package/dist/commands/app-actions.js

@@ -0,0 +1,56 @@
+import { toInteractiveOpts } from '../lib/interactive-opts.js';
+import { bodyRequiredHint, resolveBody } from '../lib/read-body.js';
+import { createAppAction, deleteAppAction, getAppAction, listAppActions, updateAppAction, } from '../lib/platform-api.js';
+import { printJson } from '../lib/output.js';
+import { requireWorkspaceContext } from '../lib/workspace-context.js';
+const VERBS = ['list', 'get', 'create', 'update', 'delete'];
+export async function runAppActions(verb, opts) {
+    const v = verb.toLowerCase();
+    if (!VERBS.includes(v)) {
+        throw new Error(`Unknown apps actions verb "${verb}". Use: ${VERBS.join(', ')}`);
+    }
+    if (!opts.app)
+        throw new Error('Provide --app <app_tag>');
+    const ctx = requireWorkspaceContext({ profile: opts.profile });
+    const interactive = toInteractiveOpts(opts);
+    const body = v === 'create' || v === 'update'
+        ? await resolveBody({
+            ...interactive,
+            file: opts.file,
+            patch: v === 'update',
+            requireBody: v === 'create',
+        })
+        : undefined;
+    let result;
+    switch (v) {
+        case 'list':
+            result = await listAppActions(ctx, opts.app);
+            break;
+        case 'get':
+            if (!opts.action)
+                throw new Error('Provide --action <action_tag>');
+            result = await getAppAction(ctx, opts.app, opts.action);
+            break;
+        case 'create':
+            if (!body || Object.keys(body).length === 0) {
+                throw new Error(`create requires a body. ${bodyRequiredHint('apps:actions:create')}`);
+            }
+            result = await createAppAction(ctx, opts.app, body);
+            break;
+        case 'update': {
+            const actionTag = opts.action ?? body?.tag;
+            if (!actionTag)
+                throw new Error('update requires --action <action_tag>');
+            result = await updateAppAction(ctx, opts.app, actionTag, body ?? {});
+            break;
+        }
+        case 'delete':
+            if (!opts.action)
+                throw new Error('Provide --action <action_tag>');
+            result = await deleteAppAction(ctx, opts.app, opts.action);
+            break;
+        default:
+            throw new Error(`Unsupported: apps actions ${v}`);
+    }
+    printJson(result, Boolean(opts.json));
+}

package/dist/commands/db.d.ts

@@ -2,4 +2,22 @@ export declare function runDb(method: string, opts: {
     file?: string;
     json?: boolean;
 }): Promise<void>;
+/**
+ * Database Actions — reusable, parameterized query/mutation definitions saved against a
+ * database component (databases.action.* in the SDK). This is administrative metadata
+ * (uses the access-key-backed sdk-proxy, same as `resources <type> create`), not a runtime
+ * query — it never connects to the live database. Required for any Feature step that calls
+ * ctx.database.query/insert/update/delete, since those take an `event` tag pointing at one
+ * of these, not a raw {table, where} shape.
+ *
+ * Tag format is always "product_tag:database_tag:action_tag" — always pass it fully
+ * qualified here (the SDK's 2-part fallback only works inside a single long-lived process
+ * that already has that product's builder cached, which a fresh CLI invocation never has).
+ */
+export declare function runDbActions(verb: string, opts: {
+    tag?: string;
+    database?: string;
+    file?: string;
+    json?: boolean;
+}, extraArgs: string[]): Promise<void>;
 export declare function runDbContext(json: boolean): void;

package/dist/commands/db.js

@@ -1,7 +1,7 @@
 import { readJsonBody } from '../lib/read-body.js';
 import { setDatabaseContext } from '../lib/context-store.js';
 import { DB_PROXY_METHODS } from '../lib/db-methods.js';
-import { getDbContext, getDbProxy, requireSession } from '../lib/proxy/context.js';
+import { getDbContext, getDbProxy, getSdkProxy, requireSession } from '../lib/proxy/context.js';
 import { loadRuntimeContext } from '../lib/context-store.js';
 import { printJson } from '../lib/output.js';
 export async function runDb(method, opts) {
@@ -47,6 +47,72 @@ export async function runDb(method, opts) {
     }
     printJson(result, Boolean(opts.json));
 }
+const DB_ACTION_VERBS = ['create', 'update', 'get', 'list', 'delete'];
+/**
+ * Database Actions — reusable, parameterized query/mutation definitions saved against a
+ * database component (databases.action.* in the SDK). This is administrative metadata
+ * (uses the access-key-backed sdk-proxy, same as `resources <type> create`), not a runtime
+ * query — it never connects to the live database. Required for any Feature step that calls
+ * ctx.database.query/insert/update/delete, since those take an `event` tag pointing at one
+ * of these, not a raw {table, where} shape.
+ *
+ * Tag format is always "product_tag:database_tag:action_tag" — always pass it fully
+ * qualified here (the SDK's 2-part fallback only works inside a single long-lived process
+ * that already has that product's builder cached, which a fresh CLI invocation never has).
+ */
+export async function runDbActions(verb, opts, extraArgs) {
+    const v = verb.toLowerCase();
+    if (!DB_ACTION_VERBS.includes(v)) {
+        throw new Error(`Unknown db actions verb "${verb}". Use: ${DB_ACTION_VERBS.join(', ')}`);
+    }
+    const proxy = getSdkProxy();
+    const tag = opts.tag ?? extraArgs[0];
+    let method;
+    let params;
+    switch (v) {
+        case 'create': {
+            const body = readJsonBody(opts.file);
+            if (!body || Object.keys(body).length === 0) {
+                throw new Error('create requires a body: { tag: "product:database:action", name, tableName, ' +
+                    'operation, template, description?, filterTemplate? } (pass -f <file.json>).');
+            }
+            method = 'action.create';
+            params = [body];
+            break;
+        }
+        case 'update': {
+            if (!tag)
+                throw new Error('update requires the action tag ("product:database:action")');
+            const body = readJsonBody(opts.file) ?? {};
+            method = 'action.update';
+            params = [{ tag, ...body }];
+            break;
+        }
+        case 'get':
+            if (!tag)
+                throw new Error('get requires the action tag ("product:database:action")');
+            method = 'action.fetch';
+            params = [tag];
+            break;
+        case 'list': {
+            const databaseTag = opts.database ?? tag;
+            if (!databaseTag) {
+                throw new Error('list requires --database <product_tag:database_tag>');
+            }
+            method = 'action.fetchAll';
+            params = [databaseTag];
+            break;
+        }
+        case 'delete':
+            if (!tag)
+                throw new Error('delete requires the action tag ("product:database:action")');
+            method = 'action.delete';
+            params = [tag];
+            break;
+    }
+    const result = await proxy.execute('databases', method, params);
+    printJson(result, Boolean(opts.json));
+}
 export function runDbContext(json) {
     const session = requireSession();
     const ctx = getDbContext(session);

package/dist/index.js

@@ -15,7 +15,7 @@ import { runInstall } from './commands/install.js';
 import { runStart, runStop, runStatus } from './commands/platform.js';
 import { runResourceCrud, runResourcesList, runEventTopicCrud, runNotificationMessageCrud } from './commands/resources.js';
 import { runCloud, runCloudPreflight } from './commands/cloud.js';
-import { runDb, runDbContext } from './commands/db.js';
+import { runDb, runDbActions, runDbContext } from './commands/db.js';
 import { runDbMigrate, runDbMigrateStatus, runDbMigrateRollback } from './commands/db-migrate.js';
 import { runFeaturesSync } from './commands/features-sync.js';
 import { runDbSchemaGenerate, runDbSchemaPush } from './commands/db-schema.js';
@@ -27,6 +27,7 @@ import { runCompletion } from './commands/completion.js';
 import { runProducts, runProductApps, runProductAppActions, runProductComponents, runProductEnvironments } from './commands/products.js';
 import { runApps } from './commands/apps.js';
 import { runAppsImport } from './commands/apps-import.js';
+import { runAppActions } from './commands/app-actions.js';
 import { runMarketplace } from './commands/marketplace.js';
 import { runApply } from './commands/apply.js';
 import { runMigrateCodebase } from './commands/migrate-codebase.js';
@@ -663,6 +664,49 @@ apps
     version: opts.version,
     json: opts.json,
 })));
+const appActions = apps.command('actions').description("An app's own actions (endpoints). resource is a path relative to each of the app's " +
+    'environment base_urls (e.g. "/v1/users/{id}"), not a full URL.');
+appActions
+    .command('list')
+    .requiredOption('--app <tag>', 'App tag')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runAppActions('list', opts)));
+appActions
+    .command('get')
+    .requiredOption('--app <tag>', 'App tag')
+    .requiredOption('--action <tag>', 'Action tag')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runAppActions('get', opts)));
+appActions
+    .command('create')
+    .requiredOption('--app <tag>', 'App tag')
+    // NOTE: cannot use -f/--file here — it collides with the parent `apps` command's own -f/--file
+    // option (used by `apps create`/`apps update`). Commander resolves a flag shared by an ancestor
+    // and a descendant command against the ancestor, so the value never reaches this subcommand's
+    // own opts, and requiredOption fails even when -f is supplied. Same fix as productEnvironments
+    // create/update (--env-file) above.
+    .requiredOption('--action-file <path>', 'JSON body: { tag, name, resource, method, description?, params?, query?, headers?, body?, response? }')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runAppActions('create', { ...opts, file: opts.actionFile })));
+appActions
+    .command('update')
+    .requiredOption('--app <tag>', 'App tag')
+    .requiredOption('--action <tag>', 'Action tag')
+    // See NOTE above on `create` — same -f/--file collision with the parent `apps` command.
+    .requiredOption('--action-file <path>', 'JSON body (partial update)')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runAppActions('update', { ...opts, file: opts.actionFile })));
+appActions
+    .command('delete')
+    .requiredOption('--app <tag>', 'App tag')
+    .requiredOption('--action <tag>', 'Action tag')
+    .option('--profile <name>')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runAppActions('delete', opts)));
 program
     .command('marketplace')
     .description('Discover public apps by capability and inspect their actions')
@@ -761,6 +805,43 @@ dbMigrate
     .option('--db <tag>', 'Limit to one db entry')
     .option('-n <count>', 'Number of migrations to roll back', '1')
     .action(wrap((opts) => runDbMigrateRollback({ env: opts.env, db: opts.db, n: Number(opts.n) })));
+const dbActions = db
+    .command('actions')
+    .description('Reusable database action definitions (saved parameterized queries). Required for any ' +
+    'Feature step that uses ctx.database.query/insert/update/delete — those take an `event` ' +
+    'tag pointing at one of these, not a raw table/where shape. Administrative (access-key), ' +
+    'not a runtime query — create/update never touch the live database.');
+dbActions
+    .command('create')
+    .description('Create a database action from a file: { tag: "product:database:action", name, tableName, operation, template }')
+    .requiredOption('-f, --file <path>', 'JSON file with the action definition')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runDbActions('create', { file: opts.file, json: opts.json }, [])));
+dbActions
+    .command('update')
+    .description('Update an existing database action')
+    .requiredOption('-t, --tag <tag>', 'Action tag ("product:database:action")')
+    .requiredOption('-f, --file <path>', 'JSON file with the fields to change')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runDbActions('update', { tag: opts.tag, file: opts.file, json: opts.json }, [])));
+dbActions
+    .command('get')
+    .description('Fetch one database action')
+    .argument('<tag>', 'Action tag ("product:database:action")')
+    .option('--json', 'JSON output')
+    .action(wrap((tag, opts) => runDbActions('get', { tag, json: opts.json }, [])));
+dbActions
+    .command('list')
+    .description('List all actions on a database')
+    .requiredOption('-d, --database <tag>', 'Database tag ("product_tag:database_tag")')
+    .option('--json', 'JSON output')
+    .action(wrap((opts) => runDbActions('list', { database: opts.database, json: opts.json }, [])));
+dbActions
+    .command('delete')
+    .description('Delete a database action')
+    .argument('<tag>', 'Action tag ("product:database:action")')
+    .option('--json', 'JSON output')
+    .action(wrap((tag, opts) => runDbActions('delete', { tag, json: opts.json }, [])));
 const dbSchema = db.command('schema').description('Schema management for ductape/database/schema.json');
 dbSchema
     .command('generate')

package/dist/lib/platform-api.d.ts

@@ -24,6 +24,11 @@ export declare function createApp(ctx: WorkspaceContext, body: Record<string, un
 export declare function updateApp(ctx: WorkspaceContext, appId: string, body: Record<string, unknown>): Promise<unknown>;
 export declare function updateAppViaProxy(ctx: WorkspaceContext, tag: string, body: Record<string, unknown>): Promise<unknown>;
 export declare function deleteApp(ctx: WorkspaceContext, appId: string): Promise<unknown>;
+export declare function listAppActions(ctx: WorkspaceContext, appTag: string): Promise<unknown>;
+export declare function getAppAction(ctx: WorkspaceContext, appTag: string, actionTag: string): Promise<unknown>;
+export declare function createAppAction(ctx: WorkspaceContext, appTag: string, body: Record<string, unknown>): Promise<unknown>;
+export declare function updateAppAction(ctx: WorkspaceContext, appTag: string, actionTag: string, body: Record<string, unknown>): Promise<unknown>;
+export declare function deleteAppAction(ctx: WorkspaceContext, appTag: string, actionTag: string): Promise<unknown>;
 export interface MarketplaceSearchOptions {
     query?: string;
     category?: string;

package/dist/lib/platform-api.js

@@ -333,6 +333,26 @@ export async function deleteApp(ctx, appId) {
     };
     return client(ctx).delete(`/apps/v1/${appId}?${new URLSearchParams(q).toString()}`);
 }
+// —— App actions (sdk-proxy — admin op, requires access key) ——
+//
+// resource is a path RELATIVE to each of the app's environment base_urls
+// (e.g. "/v1/users/{id}", not a full URL) — Ductape joins base_url + resource
+// per environment at call time.
+export async function listAppActions(ctx, appTag) {
+    return unwrapList(await proxy(ctx).execute('actions', 'list', [appTag]));
+}
+export async function getAppAction(ctx, appTag, actionTag) {
+    return unwrapOne(await proxy(ctx).execute('actions', 'fetch', [appTag, actionTag]));
+}
+export async function createAppAction(ctx, appTag, body) {
+    return unwrapOne(await proxy(ctx).execute('actions', 'create', [appTag, body]));
+}
+export async function updateAppAction(ctx, appTag, actionTag, body) {
+    return unwrapOne(await proxy(ctx).execute('actions', 'update', [appTag, actionTag, body]));
+}
+export async function deleteAppAction(ctx, appTag, actionTag) {
+    return proxy(ctx).execute('actions', 'delete', [appTag, actionTag]);
+}
 function searchableMarketplaceText(app) {
     if (!app || typeof app !== 'object')
         return '';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ductape/cli",
-  "version": "0.3.17",
+  "version": "0.3.19",
   "description": "Ductape CLI — local platform, login, link projects, and manage resources via the proxy (Workbench-compatible)",
   "type": "module",
   "main": "dist/index.js",