@datamagik/cli 0.1.0

package/dist/commands/sql.js

@@ -0,0 +1,124 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { requireCredentials } from '../credentials.js';
+import { PlatformClient } from '../api.js';
+import { parseSqlFile, serializeSqlFile } from '../sqlfile.js';
+function fileSlug(name) {
+    const slug = name.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '');
+    return slug || 'query';
+}
+function detailToMeta(d) {
+    const meta = { name: d.query_name };
+    if (d.description)
+        meta['description'] = d.description;
+    if (d.timeout_seconds)
+        meta['timeoutSeconds'] = d.timeout_seconds;
+    if (d.credential_name)
+        meta['credential'] = d.credential_name;
+    if (d.credential_id)
+        meta['credentialId'] = d.credential_id;
+    if (d.parameters && d.parameters.length)
+        meta['parameters'] = d.parameters;
+    meta['queryId'] = Number(d.query_id);
+    return meta;
+}
+const mstr = (m, k) => (typeof m[k] === 'string' ? m[k] : undefined);
+const mnum = (m, k) => (typeof m[k] === 'number' ? m[k] : undefined);
+function metaParams(m) {
+    return Array.isArray(m['parameters']) ? m['parameters'] : [];
+}
+/** `dm sql pull [id]` — write ODBC queries to <dir>/<slug>.sql with frontmatter. */
+export async function pullSqlCommand(opts, deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const creds = requireCredentials();
+    const client = deps.client ?? new PlatformClient(creds.url, creds.token);
+    const outDir = path.resolve(cwd, opts.dir ?? 'sql');
+    mkdirSync(outDir, { recursive: true });
+    const ids = opts.id !== undefined ? [Number(opts.id)] : (await client.listOdbcQueries()).map((q) => Number(q.query_id));
+    if (ids.length === 0) {
+        console.log(`No SQL queries found in this tenant (${creds.url}).`);
+        return;
+    }
+    for (const id of ids) {
+        const detail = await client.getOdbcQueryDetail(id);
+        const file = path.join(outDir, `${fileSlug(detail.query_name)}.sql`);
+        writeFileSync(file, serializeSqlFile(detailToMeta(detail), detail.query_text));
+        console.log(`Pulled [#${id}] ${detail.query_name} → ${path.relative(cwd, file)}`);
+    }
+    console.log('\nEdit, then: dm sql run <file>  (read-only) or dm sql push <file>.');
+}
+/** `dm sql run <file> --param k=v` — read-only test-run against the engine. */
+export async function runSqlCommand(file, opts, deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const creds = requireCredentials();
+    const client = deps.client ?? new PlatformClient(creds.url, creds.token);
+    const filePath = path.resolve(cwd, file);
+    if (!existsSync(filePath))
+        throw new Error(`File not found: ${file}`);
+    const { meta, sql } = parseSqlFile(readFileSync(filePath, 'utf8'));
+    const credentialId = opts.credentialId !== undefined ? Number(opts.credentialId) : mnum(meta, 'credentialId');
+    if (credentialId === undefined || !Number.isInteger(credentialId) || credentialId <= 0) {
+        throw new Error('No credentialId — add it to the @dm-sql frontmatter (pull a query) or pass --credential-id <n>.');
+    }
+    const parameters = {};
+    for (const kv of opts.param ?? []) {
+        const eq = kv.indexOf('=');
+        if (eq === -1)
+            throw new Error(`--param expects key=value (got "${kv}")`);
+        parameters[kv.slice(0, eq)] = kv.slice(eq + 1);
+    }
+    const queryId = mnum(meta, 'queryId');
+    console.log(`Running SQL against ${creds.url} (test-run)…`);
+    const res = await client.testRunOdbc({
+        query_id: queryId !== undefined ? String(queryId) : undefined,
+        query_text: sql,
+        credential_id: credentialId,
+        parameters,
+        timeout_seconds: mnum(meta, 'timeoutSeconds') ?? 30,
+    });
+    if (res.status !== 'completed' && res.status !== 'success') {
+        console.log(`\n✗ ${res.status}: ${res.error ?? 'query failed'}`);
+        process.exitCode = 1;
+        return;
+    }
+    console.log(`\n✓ ${res.row_count ?? res.rows?.length ?? 0} rows in ${res.duration_ms ?? '?'}ms`);
+    if (res.columns?.length)
+        console.log(`  columns: ${res.columns.join(', ')}`);
+    for (const row of (res.rows ?? []).slice(0, 10))
+        console.log(`  ${JSON.stringify(row)}`);
+    if ((res.rows?.length ?? 0) > 10)
+        console.log(`  … (${res.rows.length - 10} more)`);
+}
+/** `dm sql push <file>` — create or update the query in place (ODBC has no versions). */
+export async function pushSqlCommand(file, opts, deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const creds = requireCredentials();
+    const client = deps.client ?? new PlatformClient(creds.url, creds.token);
+    const filePath = path.resolve(cwd, file);
+    if (!existsSync(filePath))
+        throw new Error(`File not found: ${file}`);
+    const { meta, sql } = parseSqlFile(readFileSync(filePath, 'utf8'));
+    const name = mstr(meta, 'name');
+    if (!name)
+        throw new Error('frontmatter is missing "name" — required to save a query.');
+    const body = {
+        query_name: name,
+        query_text: sql.trim(),
+        description: mstr(meta, 'description') ?? '',
+        parameters: metaParams(meta),
+        timeout_seconds: mnum(meta, 'timeoutSeconds') ?? 30,
+        credential_id: mnum(meta, 'credentialId') ?? null,
+    };
+    const id = opts.id !== undefined ? Number(opts.id) : mnum(meta, 'queryId');
+    if (id !== undefined && Number.isInteger(id) && id > 0) {
+        await client.updateOdbcQuery(id, body);
+        console.log(`Updated SQL query [#${id}] "${name}" on ${creds.url}.`);
+    }
+    else {
+        const newId = await client.createOdbcQuery(body);
+        meta['queryId'] = newId;
+        writeFileSync(filePath, serializeSqlFile(meta, sql));
+        console.log(`Created SQL query [#${newId}] "${name}" on ${creds.url}.`);
+    }
+}
+//# sourceMappingURL=sql.js.map

package/dist/commands/sql.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sql.js","sourceRoot":"","sources":["../../src/commands/sql.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7E,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAyE,MAAM,WAAW,CAAC;AAClH,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AAe7E,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACpF,OAAO,IAAI,IAAI,OAAO,CAAC;AACzB,CAAC;AAED,SAAS,YAAY,CAAC,CAAkB;IACtC,MAAM,IAAI,GAAY,EAAE,IAAI,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC;IAC7C,IAAI,CAAC,CAAC,WAAW;QAAE,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,WAAW,CAAC;IACvD,IAAI,CAAC,CAAC,eAAe;QAAE,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC;IAClE,IAAI,CAAC,CAAC,eAAe;QAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,eAAe,CAAC;IAC9D,IAAI,CAAC,CAAC,aAAa;QAAE,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,aAAa,CAAC;IAC5D,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM;QAAE,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,UAAU,CAAC;IAC3E,IAAI,CAAC,SAAS,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;IACrC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,CAAS,EAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AACtH,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,CAAS,EAAsB,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAE,CAAC,CAAC,CAAC,CAAY,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;AAEtH,SAAS,UAAU,CAAC,CAAU;IAC5B,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,CAAC,YAAY,CAA0B,CAAC,CAAC,CAAC,EAAE,CAAC;AACzF,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAoB,EAAE,OAAqD,EAAE;IAChH,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACzE,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,CAAC;IACpD,SAAS,CAAC,MAAM,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEvC,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,MAAM,CAAC,eAAe,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACxH,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,OAAO,CAAC,GAAG,CAAC,wCAAwC,KAAK,CAAC,GAAG,IAAI,CAAC,CAAC;QACnE,OAAO;IACT,CAAC;IACD,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;QACrB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,EAAE,CAAC,CAAC;QACnD,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,QAAQ,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC;QACrE,aAAa,CAAC,IAAI,EAAE,gBAAgB,CAAC,YAAY,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;QAC/E,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,KAAK,MAAM,CAAC,UAAU,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;IACpF,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,qEAAqE,CAAC,CAAC;AACrF,CAAC;AAED,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAAY,EAAE,IAAmB,EAAE,OAAqD,EAAE;IAC5H,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnE,MAAM,YAAY,GAAG,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;IAC9G,IAAI,YAAY,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,YAAY,CAAC,IAAI,YAAY,IAAI,CAAC,EAAE,CAAC;QACvF,MAAM,IAAI,KAAK,CAAC,iGAAiG,CAAC,CAAC;IACrH,CAAC;IACD,MAAM,UAAU,GAA4B,EAAE,CAAC;IAC/C,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,KAAK,IAAI,EAAE,EAAE,CAAC;QAClC,MAAM,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC3B,IAAI,EAAE,KAAK,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,mCAAmC,EAAE,IAAI,CAAC,CAAC;QAC1E,UAAU,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACjD,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAEtC,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,CAAC,GAAG,cAAc,CAAC,CAAC;IAC5D,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC;QACnC,QAAQ,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QAC7D,UAAU,EAAE,GAAG;QACf,aAAa,EAAE,YAAY;QAC3B,UAAU;QACV,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE;KACpD,CAAC,CAAC;IAEH,IAAI,GAAG,CAAC,MAAM,KAAK,WAAW,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,MAAM,KAAK,GAAG,CAAC,KAAK,IAAI,cAAc,EAAE,CAAC,CAAC;QACjE,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;QACrB,OAAO;IACT,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,YAAY,GAAG,CAAC,WAAW,IAAI,GAAG,IAAI,CAAC,CAAC;IACjG,IAAI,GAAG,CAAC,OAAO,EAAE,MAAM;QAAE,OAAO,CAAC,GAAG,CAAC,cAAc,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7E,KAAK,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;QAAE,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACzF,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,IAAI,CAAC,CAAC,GAAG,EAAE;QAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,CAAC,IAAK,CAAC,MAAM,GAAG,EAAE,QAAQ,CAAC,CAAC;AACvF,CAAC;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,IAAY,EAAE,IAAoB,EAAE,OAAqD,EAAE;IAC9H,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IACtC,MAAM,KAAK,GAAG,kBAAkB,EAAE,CAAC;IACnC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,IAAI,cAAc,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACzE,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACzC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,mBAAmB,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,YAAY,CAAC,YAAY,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAC;IAEnE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,2DAA2D,CAAC,CAAC;IACxF,MAAM,IAAI,GAAG;QACX,UAAU,EAAE,IAAI;QAChB,UAAU,EAAE,GAAG,CAAC,IAAI,EAAE;QACtB,WAAW,EAAE,IAAI,CAAC,IAAI,EAAE,aAAa,CAAC,IAAI,EAAE;QAC5C,UAAU,EAAE,UAAU,CAAC,IAAI,CAAC;QAC5B,eAAe,EAAE,IAAI,CAAC,IAAI,EAAE,gBAAgB,CAAC,IAAI,EAAE;QACnD,aAAa,EAAE,IAAI,CAAC,IAAI,EAAE,cAAc,CAAC,IAAI,IAAI;KAClD,CAAC;IAEF,MAAM,EAAE,GAAG,IAAI,CAAC,EAAE,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC3E,IAAI,EAAE,KAAK,SAAS,IAAI,MAAM,CAAC,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;QACvD,MAAM,MAAM,CAAC,eAAe,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACvC,OAAO,CAAC,GAAG,CAAC,uBAAuB,EAAE,MAAM,IAAI,QAAQ,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IACvE,CAAC;SAAM,CAAC;QACN,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC;QACxB,aAAa,CAAC,QAAQ,EAAE,gBAAgB,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,uBAAuB,KAAK,MAAM,IAAI,QAAQ,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC;IAC1E,CAAC;AACH,CAAC"}

package/dist/commands/typegen.d.ts

@@ -0,0 +1,13 @@
+export interface TypegenOptions {
+    watch?: boolean;
+    out?: string;
+}
+/**
+ * `dm typegen [--watch] [--out src/dm.generated.ts]`
+ *
+ * Reads `dm.config.json`, pulls metadata for every declared source / serial
+ * series / printer from the platform (builder bearer auth), and emits the
+ * deterministic typed module `src/dm.generated.ts`. With `--watch`, re-runs
+ * whenever `dm.config.json` changes.
+ */
+export declare function typegenCommand(opts: TypegenOptions): Promise<void>;

package/dist/commands/typegen.js

@@ -0,0 +1,50 @@
+import { mkdirSync, readFileSync, watch, writeFileSync, existsSync } from 'node:fs';
+import path from 'node:path';
+import { loadDmConfig } from '../config.js';
+import { PlatformClient } from '../api.js';
+import { requireCredentials } from '../credentials.js';
+import { loadTypegenMeta } from '../typegen/meta.js';
+import { emitGeneratedModule } from '../typegen/emit.js';
+/**
+ * `dm typegen [--watch] [--out src/dm.generated.ts]`
+ *
+ * Reads `dm.config.json`, pulls metadata for every declared source / serial
+ * series / printer from the platform (builder bearer auth), and emits the
+ * deterministic typed module `src/dm.generated.ts`. With `--watch`, re-runs
+ * whenever `dm.config.json` changes.
+ */
+export async function typegenCommand(opts) {
+    const outRel = opts.out ?? path.join('src', 'dm.generated.ts');
+    const cwd = process.cwd();
+    const run = async () => {
+        const config = loadDmConfig(cwd);
+        const creds = requireCredentials();
+        const client = new PlatformClient(creds.url, creds.token);
+        const meta = await loadTypegenMeta(config, client);
+        const code = emitGeneratedModule(meta);
+        const outFile = path.resolve(cwd, outRel);
+        mkdirSync(path.dirname(outFile), { recursive: true });
+        const before = existsSync(outFile) ? readFileSync(outFile, 'utf8') : null;
+        if (before === code) {
+            console.log(`${outRel} is up to date.`);
+            return;
+        }
+        writeFileSync(outFile, code);
+        console.log(`Wrote ${outRel} (${meta.tables.length} tables, ${meta.odbc.length} odbc, ${meta.scripts.length} scripts, ${meta.serials.length} series, ${meta.printers.length} printers).`);
+    };
+    await run();
+    if (opts.watch) {
+        const configFile = path.join(cwd, 'dm.config.json');
+        console.log(`Watching ${configFile} for changes... (ctrl-c to stop)`);
+        let timer;
+        watch(configFile, () => {
+            clearTimeout(timer);
+            timer = setTimeout(() => {
+                run().catch((err) => console.error(`typegen failed: ${String(err)}`));
+            }, 200);
+        });
+        // Keep the process alive while watching.
+        await new Promise(() => { });
+    }
+}
+//# sourceMappingURL=typegen.js.map

package/dist/commands/typegen.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,45 @@
+/** Source kinds declarable in `dm.config.json` (manifest §2.2). */
+export type SourceType = 'lookup_table' | 'odbc_query' | 'script';
+export interface SourceDecl {
+    sourceId: number;
+    type: SourceType;
+    alias: string;
+}
+export interface SerialSeriesDecl {
+    seriesId: number;
+    alias: string;
+}
+export interface PrinterDecl {
+    printerId: number;
+    alias: string;
+}
+export interface AppContract {
+    inputs: unknown[];
+    outputs: unknown[];
+    events: unknown[];
+}
+/** Parsed and validated `dm.config.json`. */
+export interface DmConfig {
+    appId: number;
+    entry: string;
+    sources: SourceDecl[];
+    serialSeries: SerialSeriesDecl[];
+    printers: PrinterDecl[] | 'all';
+    appContract: AppContract;
+}
+/** A valid alias / JS identifier (shared with `dm add`). */
+export declare const ALIAS_RE: RegExp;
+/** Error thrown for an invalid `dm.config.json`. */
+export declare class DmConfigError extends Error {
+    constructor(message: string);
+}
+/**
+ * Validates a raw parsed `dm.config.json` object and applies defaults.
+ *
+ * Rules: positive-integer ids; aliases must be valid JS identifiers and
+ * unique across ALL categories (they share one generated registry);
+ * `printers` is either a declaration list or the string `"all"`.
+ */
+export declare function validateDmConfig(raw: unknown): DmConfig;
+/** Loads and validates `dm.config.json` from `dir` (default: cwd). */
+export declare function loadDmConfig(dir?: string): DmConfig;

package/dist/config.js

@@ -0,0 +1,118 @@
+import { existsSync, readFileSync } from 'node:fs';
+import path from 'node:path';
+const SOURCE_TYPES = ['lookup_table', 'odbc_query', 'script'];
+/** A valid alias / JS identifier (shared with `dm add`). */
+export const ALIAS_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+/** Error thrown for an invalid `dm.config.json`. */
+export class DmConfigError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'DmConfigError';
+    }
+}
+/**
+ * Validates a raw parsed `dm.config.json` object and applies defaults.
+ *
+ * Rules: positive-integer ids; aliases must be valid JS identifiers and
+ * unique across ALL categories (they share one generated registry);
+ * `printers` is either a declaration list or the string `"all"`.
+ */
+export function validateDmConfig(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        throw new DmConfigError('dm.config.json must be a JSON object');
+    }
+    const o = raw;
+    const appId = o['appId'];
+    if (typeof appId !== 'number' || !Number.isInteger(appId) || appId <= 0) {
+        throw new DmConfigError('dm.config.json: "appId" must be a positive integer');
+    }
+    const entry = o['entry'] ?? 'index.html';
+    if (typeof entry !== 'string' || entry === '') {
+        throw new DmConfigError('dm.config.json: "entry" must be a non-empty string');
+    }
+    const seenAliases = new Set();
+    const checkAlias = (alias, where) => {
+        if (typeof alias !== 'string' || !ALIAS_RE.test(alias)) {
+            throw new DmConfigError(`dm.config.json: ${where}: alias ${JSON.stringify(alias)} must be a valid identifier (letters, digits, _, $; not starting with a digit)`);
+        }
+        if (seenAliases.has(alias)) {
+            throw new DmConfigError(`dm.config.json: duplicate alias "${alias}" (aliases must be unique across sources, serialSeries, and printers)`);
+        }
+        seenAliases.add(alias);
+        return alias;
+    };
+    const checkId = (v, where) => {
+        if (typeof v !== 'number' || !Number.isInteger(v) || v <= 0) {
+            throw new DmConfigError(`dm.config.json: ${where} must be a positive integer`);
+        }
+        return v;
+    };
+    const sourcesRaw = o['sources'] ?? [];
+    if (!Array.isArray(sourcesRaw))
+        throw new DmConfigError('dm.config.json: "sources" must be an array');
+    const sources = sourcesRaw.map((s, i) => {
+        const so = (s ?? {});
+        const type = so['type'];
+        if (typeof type !== 'string' || !SOURCE_TYPES.includes(type)) {
+            throw new DmConfigError(`dm.config.json: sources[${i}].type must be one of ${SOURCE_TYPES.join(', ')}`);
+        }
+        return {
+            sourceId: checkId(so['sourceId'], `sources[${i}].sourceId`),
+            type: type,
+            alias: checkAlias(so['alias'], `sources[${i}]`),
+        };
+    });
+    const seriesRaw = o['serialSeries'] ?? [];
+    if (!Array.isArray(seriesRaw))
+        throw new DmConfigError('dm.config.json: "serialSeries" must be an array');
+    const serialSeries = seriesRaw.map((s, i) => {
+        const so = (s ?? {});
+        return {
+            seriesId: checkId(so['seriesId'], `serialSeries[${i}].seriesId`),
+            alias: checkAlias(so['alias'], `serialSeries[${i}]`),
+        };
+    });
+    const printersRaw = o['printers'] ?? [];
+    let printers;
+    if (printersRaw === 'all') {
+        printers = 'all';
+    }
+    else if (Array.isArray(printersRaw)) {
+        printers = printersRaw.map((p, i) => {
+            const po = (p ?? {});
+            return {
+                printerId: checkId(po['printerId'], `printers[${i}].printerId`),
+                alias: checkAlias(po['alias'], `printers[${i}]`),
+            };
+        });
+    }
+    else {
+        throw new DmConfigError('dm.config.json: "printers" must be an array of declarations or the string "all"');
+    }
+    const contractRaw = (o['appContract'] ?? {});
+    if (typeof contractRaw !== 'object' || Array.isArray(contractRaw)) {
+        throw new DmConfigError('dm.config.json: "appContract" must be an object');
+    }
+    const appContract = {
+        inputs: Array.isArray(contractRaw['inputs']) ? contractRaw['inputs'] : [],
+        outputs: Array.isArray(contractRaw['outputs']) ? contractRaw['outputs'] : [],
+        events: Array.isArray(contractRaw['events']) ? contractRaw['events'] : [],
+    };
+    return { appId, entry, sources, serialSeries, printers, appContract };
+}
+/** Loads and validates `dm.config.json` from `dir` (default: cwd). */
+export function loadDmConfig(dir = process.cwd()) {
+    const file = path.join(dir, 'dm.config.json');
+    if (!existsSync(file)) {
+        throw new DmConfigError(`No dm.config.json found in ${dir}`);
+    }
+    let raw;
+    try {
+        raw = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        throw new DmConfigError(`dm.config.json is not valid JSON: ${String(err)}`);
+    }
+    return validateDmConfig(raw);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/credentials.d.ts

@@ -0,0 +1,17 @@
+/** Stored CLI credentials: platform URL + builder API key (`dcp_...`). */
+export interface Credentials {
+    url: string;
+    token: string;
+}
+/**
+ * Resolves the config directory. Honors `DM_CONFIG_DIR` (used by tests),
+ * defaulting to `~/.config/datamagik`.
+ */
+export declare function configDir(): string;
+export declare function credentialsPath(): string;
+/** Writes credentials with 0600 permissions (owner read/write only). */
+export declare function saveCredentials(creds: Credentials): string;
+/** Loads stored credentials, or null when not logged in. */
+export declare function loadCredentials(): Credentials | null;
+/** Loads credentials or exits with a helpful message. */
+export declare function requireCredentials(): Credentials;

package/dist/credentials.js

@@ -0,0 +1,49 @@
+import { chmodSync, existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import path from 'node:path';
+/**
+ * Resolves the config directory. Honors `DM_CONFIG_DIR` (used by tests),
+ * defaulting to `~/.config/datamagik`.
+ */
+export function configDir() {
+    return process.env['DM_CONFIG_DIR'] ?? path.join(homedir(), '.config', 'datamagik');
+}
+export function credentialsPath() {
+    return path.join(configDir(), 'credentials.json');
+}
+/** Writes credentials with 0600 permissions (owner read/write only). */
+export function saveCredentials(creds) {
+    const dir = configDir();
+    mkdirSync(dir, { recursive: true, mode: 0o700 });
+    const file = credentialsPath();
+    writeFileSync(file, JSON.stringify(creds, null, 2) + '\n', { mode: 0o600 });
+    // mode in writeFileSync only applies on create; enforce on overwrite too.
+    chmodSync(file, 0o600);
+    return file;
+}
+/** Loads stored credentials, or null when not logged in. */
+export function loadCredentials() {
+    const file = credentialsPath();
+    if (!existsSync(file))
+        return null;
+    try {
+        const raw = JSON.parse(readFileSync(file, 'utf8'));
+        if (typeof raw.url === 'string' && typeof raw.token === 'string') {
+            return { url: raw.url.replace(/\/$/, ''), token: raw.token };
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Loads credentials or exits with a helpful message. */
+export function requireCredentials() {
+    const creds = loadCredentials();
+    if (!creds) {
+        console.error('Not logged in. Run `dm login --url <platform-url>` first.');
+        process.exit(1);
+    }
+    return creds;
+}
+//# sourceMappingURL=credentials.js.map

package/dist/credentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials.js","sourceRoot":"","sources":["../src/credentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,SAAS,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACxF,OAAO,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAQ7B;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,WAAW,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,EAAE,kBAAkB,CAAC,CAAC;AACpD,CAAC;AAED,wEAAwE;AACxE,MAAM,UAAU,eAAe,CAAC,KAAkB;IAChD,MAAM,GAAG,GAAG,SAAS,EAAE,CAAC;IACxB,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACjD,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IAC5E,0EAA0E;IAC1E,SAAS,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,4DAA4D;AAC5D,MAAM,UAAU,eAAe;IAC7B,MAAM,IAAI,GAAG,eAAe,EAAE,CAAC;IAC/B,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyB,CAAC;QAC3E,IAAI,OAAO,GAAG,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;YACjE,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/D,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,yDAAyD;AACzD,MAAM,UAAU,kBAAkB;IAChC,MAAM,KAAK,GAAG,eAAe,EAAE,CAAC;IAChC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,CAAC,KAAK,CAAC,2DAA2D,CAAC,CAAC;QAC3E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};