@datamagik/cli 0.1.0

package/dist/index.js

@@ -0,0 +1,268 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { initCommand } from './commands/init.js';
+import { addCommand } from './commands/add.js';
+import { pullCommand, runCommand, pushCommand, commitCommand, statusCommand } from './commands/script.js';
+import { pullSqlCommand, runSqlCommand, pushSqlCommand } from './commands/sql.js';
+import { loginCommand } from './commands/login.js';
+import { typegenCommand } from './commands/typegen.js';
+import { devCommand } from './commands/dev.js';
+import { publishCommand } from './commands/publish.js';
+const program = new Command();
+program
+    .name('dm')
+    .description(`DataMagik CLI — build, type, run, and ship custom Vue SPA apps for the DataMagik Application Designer.
+
+Typical lifecycle:
+  dm init my-app              scaffold a starter (simple or showcase)
+  cd my-app && npm install
+  dm login --url <platform>   store a builder API key
+  dm add                      search the tenant and declare a resource
+  dm typegen                  generate typed src/dm.generated.ts
+  dm dev                      hot-reload dev server against live data
+  dm publish                  build + ship a new version (goes live)
+
+Config & state:
+  dm.config.json              your app id + declared resources (commit it)
+  src/dm.generated.ts         typed alias surface (regenerated by typegen; commit it)
+  ~/.config/datamagik/credentials.json   stored { url, token } (0600)`)
+    .version('0.1.0')
+    .showHelpAfterError('(run `dm <command> --help` for usage)');
+program
+    .command('init')
+    .summary('scaffold a new SPA starter project')
+    .description(`Scaffold a Vue 3 + Vite starter wired to @datamagik/app-sdk.
+
+Templates:
+  showcase   platform-styled app with a working example for every SDK area
+             (context, data query, scripts, serials, printing, navigation,
+             output events) — recommended for learning the framework.
+  simple     minimal app: connect, show context, run one data query.
+
+The generated dm.config.json uses placeholder resource ids. Set "appId" and
+add real resources with \`dm add\`, then run \`dm typegen\`.`)
+    .argument('[dir]', 'target directory (defaults to the current directory)')
+    .option('--template <kind>', 'starter template: simple | showcase (prompts when omitted)')
+    .option('--app <id>', 'application id to write into dm.config.json')
+    .option('--force', 'scaffold into a non-empty directory')
+    .addHelpText('after', `
+Examples:
+  dm init my-app                       # prompt for template, scaffold ./my-app
+  dm init my-app --template showcase   # full showcase app
+  dm init . --template simple --app 12 # minimal app in the current dir, appId 12`)
+    .action(async (dir, opts) => {
+    await initCommand({ dir, ...opts });
+});
+program
+    .command('add')
+    .summary('search the tenant and declare a resource in dm.config.json')
+    .description(`Browse the active tenant's resources, pick one, declare it in dm.config.json
+with a chosen alias, and regenerate src/dm.generated.ts.
+
+Resource types: lookup_table, odbc_query, script, serial_series, printer
+(synonyms accepted: table, odbc/sql/query, series/serial, printer).
+
+Interactive on a TTY (prompts for type, selection, and alias). Fully scriptable
+by passing the type and an id (or unique search term) as arguments. Requires
+\`dm login\` first.`)
+    .argument('[type]', 'resource type (prompts when omitted)')
+    .argument('[id-or-search]', 'numeric id (selects directly) or a name search term')
+    .option('--alias <name>', 'alias to declare (derived from the resource name when omitted)')
+    .option('--no-typegen', 'do not run dm typegen after adding')
+    .option('--yes', 'assume yes / non-interactive (no prompts)')
+    .addHelpText('after', `
+Examples:
+  dm add                               # fully interactive: pick type, search, alias
+  dm add lookup_table                  # list lookup tables, then pick one
+  dm add script receipt                # search scripts matching "receipt"
+  dm add printer 11 --alias line1Zebra # declare printer #11 as line1Zebra
+  dm add odbc 7 --alias openOrders --no-typegen`)
+    .action(async (type, query, opts) => {
+    await addCommand({ type, query, alias: opts.alias, noTypegen: opts.typegen === false, yes: opts.yes });
+});
+const script = program
+    .command('script')
+    .summary('author script-engine scripts locally (pull / run / push / commit / status)')
+    .description(`Local-first authoring for script-engine scripts: pull a script to a .js file
+with full frontmatter + autocomplete for the V8 sandbox globals (plex, odbc,
+context, …), edit locally, and dry-run it against the cloud engine. Requires
+\`dm login\`. See \`dm script <sub> --help\`.`);
+script
+    .command('pull')
+    .summary('pull script(s) to local .js files with frontmatter + types')
+    .description(`Write each script to <dir>/<slug>.js with a @dm-script frontmatter block (its
+full attribute set) and drop the ambient types + jsconfig so the V8 globals
+autocomplete. Pulls all scripts unless an id is given.`)
+    .argument('[id]', 'script id to pull (pulls all when omitted)')
+    .option('--dir <dir>', 'output directory', 'scripts')
+    .addHelpText('after', `
+Examples:
+  dm script pull              # pull every script into ./scripts
+  dm script pull 1107         # pull one script
+  dm script pull --dir src/scripts`)
+    .action(async (id, opts) => {
+    await pullCommand({ id, dir: opts.dir });
+});
+script
+    .command('run')
+    .summary('dry-run a local script against the engine (read-only)')
+    .description(`Send a local script's code to the engine's read-only test-run with a simulated
+context and print the console logs + output. Never saves a version. The scriptId
+comes from the file's @dm-script frontmatter (or --id).`)
+    .argument('<file>', 'path to the local script .js file')
+    .option('--id <id>', 'script id (overrides the frontmatter scriptId)')
+    .option('--context <key=val...>', 'simulated context params (repeatable)', collect, [])
+    .addHelpText('after', `
+Examples:
+  dm script run scripts/milton-ar-daily.js
+  dm script run scripts/milton-ar-daily.js --context order=42 --context line=L1`)
+    .action(async (file, opts) => {
+    await runCommand(file, { id: opts.id, context: opts.context });
+});
+script
+    .command('push')
+    .summary('save a script’s metadata to the platform (no code version)')
+    .description(`Update an existing script's attributes (name, description, tags, timeout, …)
+from the file's frontmatter via PUT. Does NOT save code — use \`dm script commit\`
+to deploy code as a new version. Requires a scriptId in the frontmatter.`)
+    .argument('<file>', 'path to the local script .js file')
+    .option('--id <id>', 'script id (overrides the frontmatter scriptId)')
+    .addHelpText('after', '\nExample:\n  dm script push scripts/milton-ar-daily.js')
+    .action(async (file, opts) => {
+    await pushCommand(file, opts);
+});
+script
+    .command('commit')
+    .summary('deploy: save metadata + code as a new version (goes live)')
+    .description(`Create the script if it has no id (writing the new id back to the file), sync
+its metadata, and save the code as a new version — the current/live version.`)
+    .argument('<file>', 'path to the local script .js file')
+    .option('--id <id>', 'script id (overrides the frontmatter scriptId)')
+    .option('-m, --message <text>', 'version notes')
+    .addHelpText('after', '\nExample:\n  dm script commit scripts/milton-ar-daily.js -m "fix rounding"')
+    .action(async (file, opts) => {
+    await commitCommand(file, opts);
+});
+script
+    .command('status')
+    .summary('show how a local script differs from the engine')
+    .description('Compare the local file’s attributes + code against the current version on the platform.')
+    .argument('<file>', 'path to the local script .js file')
+    .option('--id <id>', 'script id (overrides the frontmatter scriptId)')
+    .action(async (file, opts) => {
+    await statusCommand(file, opts);
+});
+const sql = program
+    .command('sql')
+    .summary('author ODBC/SQL queries locally (pull / run / push)')
+    .description(`Local-first authoring for ODBC queries: pull a query to a .sql file with
+@dm-sql frontmatter, dry-run it against the engine, and push changes back.
+ODBC queries are not versioned, so push updates in place. Requires \`dm login\`.`);
+sql
+    .command('pull')
+    .summary('pull SQL query/queries to local .sql files')
+    .description('Write each ODBC query to <dir>/<slug>.sql with @dm-sql frontmatter. Pulls all unless an id is given.')
+    .argument('[id]', 'query id to pull (pulls all when omitted)')
+    .option('--dir <dir>', 'output directory', 'sql')
+    .addHelpText('after', '\nExamples:\n  dm sql pull\n  dm sql pull 7 --dir src/sql')
+    .action(async (id, opts) => {
+    await pullSqlCommand({ id, dir: opts.dir });
+});
+sql
+    .command('run')
+    .summary('dry-run a local SQL query against the engine (read-only)')
+    .description('Send the local SQL to the engine’s read-only test-run and print rows. Uses the frontmatter credentialId (or --credential-id).')
+    .argument('<file>', 'path to the local .sql file')
+    .option('--id <id>', 'query id (overrides the frontmatter queryId)')
+    .option('--credential-id <id>', 'ODBC credential id (overrides the frontmatter credentialId)')
+    .option('--param <key=val...>', 'query parameters (repeatable)', collect, [])
+    .addHelpText('after', '\nExample:\n  dm sql run sql/open-orders.sql --param status=OPEN')
+    .action(async (file, opts) => {
+    await runSqlCommand(file, { id: opts.id, credentialId: opts.credentialId, param: opts.param });
+});
+sql
+    .command('push')
+    .summary('create or update a SQL query in place')
+    .description('Save the local .sql file’s frontmatter + text to the platform (creates if no queryId, else updates). ODBC queries are not versioned.')
+    .argument('<file>', 'path to the local .sql file')
+    .option('--id <id>', 'query id (overrides the frontmatter queryId)')
+    .addHelpText('after', '\nExample:\n  dm sql push sql/open-orders.sql')
+    .action(async (file, opts) => {
+    await pushSqlCommand(file, opts);
+});
+program
+    .command('login')
+    .summary('store platform credentials')
+    .description(`Store { url, token } in ~/.config/datamagik/credentials.json (mode 0600).
+
+Create an API key in the platform UI (Settings → API Keys) and paste it when
+prompted, or pass it with --token. The url is remembered and used by add,
+typegen, dev, and publish.`)
+    .option('--url <platform>', 'platform base URL', 'https://data-magik.com')
+    .option('--token <token>', 'API key (dcp_...) created in the platform UI (prompted when omitted)')
+    .addHelpText('after', `
+Examples:
+  dm login --url https://staging.data-magik.com
+  dm login --url https://data-magik.com --token dcp_xxxxxxxx`)
+    .action(async (opts) => {
+    await loginCommand(opts);
+});
+program
+    .command('typegen')
+    .summary('generate the typed dm.generated.ts module')
+    .description(`Read dm.config.json, fetch metadata for every declared resource from the
+platform, and emit the typed module src/dm.generated.ts (deterministic — commit
+it). Re-run after changing dm.config.json (or use --watch). Requires \`dm login\`.`)
+    .option('--watch', 're-generate when dm.config.json changes')
+    .option('--out <file>', 'output file', 'src/dm.generated.ts')
+    .addHelpText('after', `
+Examples:
+  dm typegen
+  dm typegen --watch
+  dm typegen --out src/types/dm.generated.ts`)
+    .action(async (opts) => {
+    await typegenCommand(opts);
+});
+program
+    .command('dev')
+    .summary('run the dev server against live platform data')
+    .description(`Start the project's Vite dev server with the DataMagik auth proxy and a
+simulated host context. /api/* calls are proxied to the platform with your
+builder bearer; --context flags become context.params. Prints an in-platform
+dev URL you open to test inside the real shell. Requires \`dm login\`.`)
+    .option('--app <id>', 'app id (defaults to dm.config.json appId)')
+    .option('--port <port>', 'dev server port', '5173')
+    .option('--context <key=val...>', 'simulated context params (repeatable)', collect, [])
+    .addHelpText('after', `
+Examples:
+  dm dev
+  dm dev --app 12 --port 5174
+  dm dev --context order=42 --context line=L1`)
+    .action(async (opts) => {
+    await devCommand(opts);
+});
+program
+    .command('publish')
+    .summary('build and ship a new version (goes live)')
+    .description(`Run vite build, zip dist/, and publish a new SPA version to the platform.
+The new version goes live immediately. Use --skip-build to publish an existing
+dist/ as-is. Requires \`dm login\`.`)
+    .option('--app <id>', 'app id (defaults to dm.config.json appId)')
+    .option('--message <text>', 'change description for the new version')
+    .option('--skip-build', 'skip vite build and publish the existing dist/')
+    .addHelpText('after', `
+Examples:
+  dm publish --message "first version"
+  dm publish --app 12 --message "fix label layout"
+  dm publish --skip-build --message "re-publish current dist"`)
+    .action(async (opts) => {
+    await publishCommand(opts);
+});
+function collect(value, previous) {
+    return [...previous, value];
+}
+program.parseAsync(process.argv).catch((err) => {
+    console.error(err instanceof Error ? err.message : String(err));
+    process.exit(1);
+});
+//# 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/scriptfile.d.ts

@@ -0,0 +1,10 @@
+export type MetaValue = string | number | boolean | string[];
+export type ScriptMeta = Record<string, MetaValue>;
+export interface ScriptFile {
+    meta: ScriptMeta;
+    code: string;
+}
+/** Parses a `@dm-script` file into `{ meta, code }`. Missing block → empty meta. */
+export declare function parseScriptFile(text: string): ScriptFile;
+/** Serializes `{ meta, code }` back into a `@dm-script` file. */
+export declare function serializeScriptFile(meta: ScriptMeta, code: string): string;

package/dist/scriptfile.js

@@ -0,0 +1,91 @@
+// Parse/serialize the single-file frontmatter that carries a script's full
+// attribute set (see docs/design/script-engine-local-dev.md). A script file is
+// a `/* @dm-script ... */` block (key: value lines) followed by the code body.
+const MARKER = '@dm-script';
+// Stable emit order; only keys that are present are written.
+const FIELD_ORDER = [
+    'name', 'description', 'category', 'tags', 'active', 'timeoutSeconds',
+    'maxMemoryMB', 'priority', 'isReportGenerator', 'reportType',
+    'generateDocuments', 'outputFormat', 'titleJsonPath', 'summaryJsonPath',
+    'waitForGeneration', 'credentials', 'allowedDomains', 'schedule', 'scriptId',
+];
+const SAFE_BARE = /^[A-Za-z0-9_$./\-*]+$/;
+function parseValue(raw) {
+    const v = raw.trim();
+    if (v.startsWith('[') && v.endsWith(']')) {
+        const inner = v.slice(1, -1).trim();
+        if (inner === '')
+            return [];
+        return inner.split(',').map((s) => unquote(s.trim()));
+    }
+    if (v === 'true')
+        return true;
+    if (v === 'false')
+        return false;
+    if (/^-?\d+$/.test(v))
+        return Number(v);
+    return unquote(v);
+}
+function unquote(s) {
+    if (s.startsWith('"')) {
+        try {
+            return JSON.parse(s);
+        }
+        catch {
+            return s.slice(1, -1);
+        }
+    }
+    return s;
+}
+function serializeScalar(v) {
+    if (typeof v === 'string')
+        return SAFE_BARE.test(v) ? v : JSON.stringify(v);
+    return String(v);
+}
+function serializeValue(v) {
+    if (Array.isArray(v))
+        return `[${v.map((s) => serializeScalar(s)).join(', ')}]`;
+    return serializeScalar(v);
+}
+/** Parses a `@dm-script` file into `{ meta, code }`. Missing block → empty meta. */
+export function parseScriptFile(text) {
+    const start = text.indexOf(`/* ${MARKER}`);
+    if (start === -1)
+        return { meta: {}, code: text };
+    const end = text.indexOf('*/', start);
+    if (end === -1)
+        return { meta: {}, code: text };
+    const block = text.slice(start + `/* ${MARKER}`.length, end);
+    const meta = {};
+    for (const line of block.split('\n')) {
+        const trimmed = line.trim();
+        if (trimmed === '' || trimmed.startsWith('#'))
+            continue;
+        const colon = trimmed.indexOf(':');
+        if (colon === -1)
+            continue;
+        const key = trimmed.slice(0, colon).trim();
+        let value = trimmed.slice(colon + 1).trim();
+        // Strip a trailing `# comment`, but never inside a quoted string.
+        if (!value.startsWith('"'))
+            value = value.replace(/\s+#.*$/, '');
+        if (key)
+            meta[key] = parseValue(value);
+    }
+    // Code is everything after the closing `*/` (drop the immediate newline).
+    const code = text.slice(end + 2).replace(/^\r?\n/, '');
+    return { meta, code };
+}
+/** Serializes `{ meta, code }` back into a `@dm-script` file. */
+export function serializeScriptFile(meta, code) {
+    const keys = [
+        ...FIELD_ORDER.filter((k) => k in meta),
+        ...Object.keys(meta).filter((k) => !FIELD_ORDER.includes(k)),
+    ];
+    const lines = [`/* ${MARKER}`];
+    for (const k of keys)
+        lines.push(`   ${k}: ${serializeValue(meta[k])}`);
+    lines.push('*/');
+    return `${lines.join('\n')}\n${code.replace(/^\r?\n/, '')}`;
+}
+//# sourceMappingURL=scriptfile.js.map

package/dist/scriptfile.js.map

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

package/dist/sqlfile.d.ts

@@ -0,0 +1,9 @@
+export type SqlMeta = Record<string, unknown>;
+export interface SqlFile {
+    meta: SqlMeta;
+    sql: string;
+}
+/** Parses a `@dm-sql` file into `{ meta, sql }`. No frontmatter → all SQL. */
+export declare function parseSqlFile(text: string): SqlFile;
+/** Serializes `{ meta, sql }` back into a `@dm-sql` file. */
+export declare function serializeSqlFile(meta: SqlMeta, sql: string): string;

package/dist/sqlfile.js

@@ -0,0 +1,75 @@
+// Parse/serialize the `@dm-sql` frontmatter for ODBC/SQL queries: a leading
+// block of `-- key: value` line comments followed by the raw SQL body. Values
+// may be JSON (arrays/objects) — used for the `parameters` list.
+const MARKER = '-- @dm-sql';
+const FIELD_ORDER = ['name', 'description', 'timeoutSeconds', 'credential', 'credentialId', 'parameters', 'queryId'];
+const SAFE_BARE = /^[A-Za-z0-9_$./\-*]+$/;
+function parseValue(raw) {
+    const v = raw.trim();
+    if (v.startsWith('[') || v.startsWith('{')) {
+        try {
+            return JSON.parse(v);
+        }
+        catch {
+            return v;
+        }
+    }
+    if (v === 'true')
+        return true;
+    if (v === 'false')
+        return false;
+    if (/^-?\d+$/.test(v))
+        return Number(v);
+    if (v.startsWith('"')) {
+        try {
+            return JSON.parse(v);
+        }
+        catch {
+            return v.slice(1, -1);
+        }
+    }
+    return v;
+}
+function serializeValue(v) {
+    if (v === null)
+        return 'null';
+    if (typeof v === 'object')
+        return JSON.stringify(v);
+    if (typeof v === 'string')
+        return SAFE_BARE.test(v) ? v : JSON.stringify(v);
+    return String(v);
+}
+/** Parses a `@dm-sql` file into `{ meta, sql }`. No frontmatter → all SQL. */
+export function parseSqlFile(text) {
+    const lines = text.split('\n');
+    if (lines[0]?.trim() !== MARKER)
+        return { meta: {}, sql: text };
+    const meta = {};
+    let i = 1;
+    for (; i < lines.length; i++) {
+        const line = lines[i] ?? '';
+        if (!line.trimStart().startsWith('--'))
+            break;
+        const body = line.trimStart().replace(/^--\s?/, '');
+        const colon = body.indexOf(':');
+        if (colon === -1)
+            continue;
+        const key = body.slice(0, colon).trim();
+        const value = body.slice(colon + 1).trim();
+        if (key)
+            meta[key] = parseValue(value);
+    }
+    return { meta, sql: lines.slice(i).join('\n').replace(/^\r?\n/, '') };
+}
+/** Serializes `{ meta, sql }` back into a `@dm-sql` file. */
+export function serializeSqlFile(meta, sql) {
+    const keys = [
+        ...FIELD_ORDER.filter((k) => k in meta),
+        ...Object.keys(meta).filter((k) => !FIELD_ORDER.includes(k)),
+    ];
+    const lines = [MARKER];
+    for (const k of keys)
+        lines.push(`-- ${k}: ${serializeValue(meta[k])}`);
+    return `${lines.join('\n')}\n${sql.replace(/^\r?\n/, '')}`;
+}
+//# sourceMappingURL=sqlfile.js.map

package/dist/sqlfile.js.map

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

package/dist/typegen/emit.d.ts

@@ -0,0 +1,22 @@
+import type { TypegenMeta } from './meta.js';
+/**
+ * Emits the `dm.generated.ts` module from fetched metadata.
+ *
+ * Deterministic: aliases are sorted within each category, the output carries
+ * no timestamps, and identical inputs always produce byte-identical output —
+ * the file is meant to be committed.
+ */
+export declare function emitGeneratedModule(meta: TypegenMeta): string;
+/** `parts` → `PartsRow`-style Pascal case. */
+export declare function pascal(alias: string): string;
+/**
+ * Maps a lookup-table `value_schema` field type to TypeScript
+ * (design §8.1): text→string, number→number, date→string (ISO 8601),
+ * boolean→boolean, picture→DmImageRef, lookup_table→number (FK).
+ */
+export declare function lookupFieldType(type: string): {
+    ts: string;
+    note?: string;
+};
+/** Maps an ODBC parameter type to TypeScript: string|int|float|bool. */
+export declare function odbcParamType(type: string): string;