@datamagik/cli 0.1.0

package/dist/typegen/emit.js

@@ -0,0 +1,255 @@
+/**
+ * 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 function emitGeneratedModule(meta) {
+    const tables = [...meta.tables].sort(byAlias);
+    const odbc = [...meta.odbc].sort(byAlias);
+    const scripts = [...meta.scripts].sort(byAlias);
+    const serials = [...meta.serials].sort(byAlias);
+    const printers = [...meta.printers].sort(byAlias);
+    const usesImageRef = tables.some((t) => t.fields.some((f) => f.type === 'picture'));
+    const usesScriptTypeOf = scripts.length > 0;
+    const typeImports = ['AliasRegistry'];
+    if (usesImageRef)
+        typeImports.push('DmImageRef');
+    if (usesScriptTypeOf)
+        typeImports.push('ScriptTypeOf');
+    typeImports.sort();
+    const out = [];
+    out.push('/* eslint-disable */');
+    out.push('// ----------------------------------------------------------------------------');
+    out.push('// Generated by `dm typegen` — DO NOT EDIT.');
+    out.push('// Aliases come from dm.config.json; the same declarations gate authorization');
+    out.push('// server-side, so this autocomplete surface equals the permission surface.');
+    out.push('// Commit this file so CI and editors work without platform access.');
+    out.push('// ----------------------------------------------------------------------------');
+    out.push("import { createDm } from '@datamagik/app-sdk';");
+    out.push(`import type { ${typeImports.join(', ')} } from '@datamagik/app-sdk';`);
+    out.push('');
+    for (const t of tables)
+        out.push(...emitTableInterface(t), '');
+    for (const q of odbc)
+        out.push(...emitOdbcTypes(q), '');
+    for (const s of serials)
+        out.push(...emitSerialContext(s), '');
+    out.push(...emitDmGenerated(tables, odbc, scripts, serials, printers), '');
+    out.push(...emitRegistry(tables, odbc, scripts, serials, printers), '');
+    out.push('/** Ready-to-use, fully typed SDK instance for this app. */');
+    out.push('export const dm = createDm<DmGenerated>(dmRegistry);');
+    out.push('');
+    return out.join('\n');
+}
+const byAlias = (a, b) => (a.alias < b.alias ? -1 : a.alias > b.alias ? 1 : 0);
+/** `parts` → `PartsRow`-style Pascal case. */
+export function pascal(alias) {
+    return alias.charAt(0).toUpperCase() + alias.slice(1);
+}
+const IDENT_RE = /^[A-Za-z_$][A-Za-z0-9_$]*$/;
+function propKey(name) {
+    return IDENT_RE.test(name) ? name : JSON.stringify(name);
+}
+/** Strips comment-terminators so descriptions cannot break out of TSDoc. */
+function safeComment(s) {
+    return s.replace(/\*\//g, '*\\/').replace(/[\r\n]+/g, ' ');
+}
+function tsdoc(lines, indent = '') {
+    const clean = lines.filter((l) => l !== '');
+    if (clean.length === 0)
+        return [];
+    if (clean.length === 1)
+        return [`${indent}/** ${safeComment(clean[0])} */`];
+    return [`${indent}/**`, ...clean.map((l) => `${indent} * ${safeComment(l)}`), `${indent} */`];
+}
+/**
+ * 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 function lookupFieldType(type) {
+    switch (type) {
+        case 'text':
+            return { ts: 'string' };
+        case 'number':
+            return { ts: 'number' };
+        case 'date':
+            return { ts: 'string', note: 'ISO 8601 date' };
+        case 'boolean':
+            return { ts: 'boolean' };
+        case 'picture':
+            return { ts: 'DmImageRef' };
+        case 'lookup_table':
+            return { ts: 'number', note: 'FK → lookup_data_id' };
+        default:
+            return { ts: 'unknown', note: `unrecognized schema type "${type}"` };
+    }
+}
+/** Maps an ODBC parameter type to TypeScript: string|int|float|bool. */
+export function odbcParamType(type) {
+    switch (type) {
+        case 'string':
+            return 'string';
+        case 'int':
+        case 'float':
+            return 'number';
+        case 'bool':
+            return 'boolean';
+        default:
+            return 'unknown';
+    }
+}
+function emitTableInterface(t) {
+    const lines = [];
+    const doc = [`Row of lookup table "${t.tableName}" (source #${t.sourceId}).`];
+    if (t.description)
+        doc.push(t.description);
+    lines.push(...tsdoc(doc));
+    lines.push(`export interface ${pascal(t.alias)}Row {`);
+    const fields = [...t.fields].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    for (const f of fields) {
+        const { ts, note } = lookupFieldType(f.type);
+        const fdoc = [];
+        if (f.description)
+            fdoc.push(f.description);
+        if (note)
+            fdoc.push(`(${note})`);
+        lines.push(...tsdoc([fdoc.join(' ')], '  '));
+        lines.push(`  ${propKey(f.name)}: ${ts};`);
+    }
+    lines.push('}');
+    return lines;
+}
+function emitOdbcTypes(q) {
+    const lines = [];
+    const name = pascal(q.alias);
+    const doc = [`Parameters of ODBC query "${q.queryName}" (source #${q.sourceId}).`];
+    if (q.description)
+        doc.push(q.description);
+    doc.push('Parameters with a default value are optional.');
+    lines.push(...tsdoc(doc));
+    lines.push(`export interface ${name}Params {`);
+    const params = [...q.parameters].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    for (const p of params) {
+        const optional = p.default !== undefined && p.default !== null;
+        const pdoc = [];
+        if (optional)
+            pdoc.push(`Default: ${JSON.stringify(p.default)}`);
+        lines.push(...tsdoc([pdoc.join(' ')], '  '));
+        lines.push(`  ${propKey(p.name)}${optional ? '?' : ''}: ${odbcParamType(p.type)};`);
+    }
+    lines.push('}');
+    lines.push(...tsdoc([
+        `Row of ODBC query "${q.queryName}" (source #${q.sourceId}).`,
+        'Columns are not statically declared by the platform; narrow this type manually if needed.',
+    ]));
+    lines.push(`export type ${name}Row = Record<string, unknown>;`);
+    return lines;
+}
+function emitSerialContext(s) {
+    const lines = [];
+    const doc = [
+        `Generation context for serial series "${s.name}" (series #${s.seriesId}).`,
+        `Format: \`${s.formatString}\` — \`generate()\` returns serial numbers in this shape.`,
+    ];
+    lines.push(...tsdoc(doc));
+    const name = `${pascal(s.alias)}Context`;
+    if (s.contextFields === null) {
+        lines.push(`export type ${name} = Record<string, unknown>;`);
+        return lines;
+    }
+    if (s.contextFields.length === 0) {
+        lines.push(`export type ${name} = Record<string, never>;`);
+        return lines;
+    }
+    lines.push(`export interface ${name} {`);
+    const fields = [...s.contextFields].sort((a, b) => (a.name < b.name ? -1 : a.name > b.name ? 1 : 0));
+    for (const f of fields) {
+        if (f.description)
+            lines.push(...tsdoc([f.description], '  '));
+        lines.push(`  ${propKey(f.name)}${f.required ? '' : '?'}: ${f.tsType};`);
+    }
+    lines.push('}');
+    return lines;
+}
+function printerFormatsUnion(p) {
+    const order = ['zpl', 'pdf', 'pdf_base64', 'html'];
+    const formats = order.filter((f) => p.formats.includes(f));
+    return (formats.length > 0 ? formats : order).map((f) => `'${f}'`).join(' | ');
+}
+function emitDmGenerated(tables, odbc, scripts, serials, printers) {
+    const lines = [];
+    lines.push(...tsdoc([
+        'Typed alias surface for this app. Passed as the generic of `createDm` so',
+        'every alias autocompletes in any TypeScript-aware editor.',
+    ]));
+    lines.push('export interface DmGenerated {');
+    lines.push('  tables: {');
+    for (const t of tables) {
+        lines.push(...tsdoc([`Lookup table "${t.tableName}" (#${t.sourceId})`], '    '));
+        lines.push(`    ${propKey(t.alias)}: ${pascal(t.alias)}Row;`);
+    }
+    lines.push('  };');
+    lines.push('  odbc: {');
+    for (const q of odbc) {
+        lines.push(...tsdoc([`ODBC query "${q.queryName}" (#${q.sourceId})`], '    '));
+        lines.push(`    ${propKey(q.alias)}: { params: ${pascal(q.alias)}Params; row: ${pascal(q.alias)}Row };`);
+    }
+    lines.push('  };');
+    lines.push('  scripts: {');
+    for (const s of scripts) {
+        lines.push(...tsdoc([
+            `Script "${s.scriptName}" (#${s.sourceId}).${s.description ? ` ${s.description}` : ''}`,
+            'Scripts have no declared IO schema; types default to `unknown`.',
+            `Augment \`DmScriptTypes\` in '@datamagik/app-sdk' to type this script.`,
+        ], '    '));
+        lines.push(`    ${propKey(s.alias)}: ScriptTypeOf<'${s.alias}'>;`);
+    }
+    lines.push('  };');
+    lines.push('  serials: {');
+    for (const s of serials) {
+        lines.push(...tsdoc([`Serial series "${s.name}" (#${s.seriesId}) — format \`${s.formatString}\``], '    '));
+        lines.push(`    ${propKey(s.alias)}: { context: ${pascal(s.alias)}Context };`);
+    }
+    lines.push('  };');
+    lines.push('  printers: {');
+    for (const p of printers) {
+        const caps = [`Printer "${p.name}" (#${p.printerId})`];
+        const detail = [p.type];
+        if (p.protocol)
+            detail.push(p.protocol);
+        if (p.dpi)
+            detail.push(`${p.dpi}dpi`);
+        if (p.isZplCompatible)
+            detail.push('ZPL-compatible');
+        caps.push(`— ${detail.join(', ')}`);
+        lines.push(...tsdoc([caps.join(' ')], '    '));
+        lines.push(`    ${propKey(p.alias)}: { formats: ${printerFormatsUnion(p)} };`);
+    }
+    lines.push('  };');
+    lines.push('}');
+    return lines;
+}
+function emitRegistry(tables, odbc, scripts, serials, printers) {
+    const lines = [];
+    lines.push(...tsdoc([
+        'Runtime alias → { type, id } registry. The SDK uses it to map aliases to',
+        'the numeric ids the platform APIs (and authorization gates) operate on.',
+    ]));
+    lines.push('export const dmRegistry: AliasRegistry = {');
+    const entries = [
+        ...tables.map((t) => ({ alias: t.alias, type: 'lookup_table', id: t.sourceId })),
+        ...odbc.map((q) => ({ alias: q.alias, type: 'odbc_query', id: q.sourceId })),
+        ...scripts.map((s) => ({ alias: s.alias, type: 'script', id: s.sourceId })),
+        ...serials.map((s) => ({ alias: s.alias, type: 'serial_series', id: s.seriesId })),
+        ...printers.map((p) => ({ alias: p.alias, type: 'printer', id: p.printerId })),
+    ].sort((a, b) => (a.alias < b.alias ? -1 : a.alias > b.alias ? 1 : 0));
+    for (const e of entries) {
+        lines.push(`  ${propKey(e.alias)}: { type: '${e.type}', id: ${e.id} },`);
+    }
+    lines.push('};');
+    return lines;
+}
+//# sourceMappingURL=emit.js.map

package/dist/typegen/emit.js.map

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

package/dist/typegen/meta.d.ts

@@ -0,0 +1,84 @@
+import type { DmConfig } from '../config.js';
+import type { PlatformMetadataClient, SchemaField, OdbcQueryParameter } from '../api.js';
+/** Normalized metadata that drives code emission (fetched once per run). */
+export interface TypegenMeta {
+    tables: TableMeta[];
+    odbc: OdbcMeta[];
+    scripts: ScriptAliasMeta[];
+    serials: SerialAliasMeta[];
+    printers: PrinterAliasMeta[];
+}
+export interface TableMeta {
+    alias: string;
+    sourceId: number;
+    tableName: string;
+    description?: string;
+    fields: SchemaField[];
+}
+export interface OdbcMeta {
+    alias: string;
+    sourceId: number;
+    queryName: string;
+    description?: string;
+    parameters: OdbcQueryParameter[];
+}
+export interface ScriptAliasMeta {
+    alias: string;
+    sourceId: number;
+    scriptName: string;
+    description?: string;
+}
+/** A serial-series context field (parsed from the series' context schema). */
+export interface ContextField {
+    name: string;
+    /** TS type to emit, e.g. `string` or `number`. */
+    tsType: string;
+    required: boolean;
+    description?: string;
+}
+export interface SerialAliasMeta {
+    alias: string;
+    seriesId: number;
+    name: string;
+    formatString: string;
+    /** null when the context schema is absent/unparseable → free-form context. */
+    contextFields: ContextField[] | null;
+}
+export interface PrinterAliasMeta {
+    alias: string;
+    printerId: number;
+    name: string;
+    type: string;
+    protocol?: string;
+    dpi?: number;
+    isZplCompatible: boolean;
+    /** Supported print formats (subset of zpl|pdf|pdf_base64|html). */
+    formats: string[];
+}
+/**
+ * Fetches metadata for every declaration in `dm.config.json`.
+ * `printers: "all"` expands to every printer in the company registry, with
+ * aliases derived from printer names.
+ */
+export declare function loadTypegenMeta(config: DmConfig, client: PlatformMetadataClient): Promise<TypegenMeta>;
+/**
+ * Derives the supported print formats for a printer:
+ * - `zpl` for ZPL-compatible printers (raw-socket Zebra path);
+ * - `pdf` and `pdf_base64` for IPP printers;
+ * - `html` is always available (server-side rendering before delivery).
+ * If nothing else matched, the full union is allowed (capability unknown).
+ */
+export declare function printerFormats(p: {
+    protocol?: string;
+    isZplCompatible?: boolean;
+}): string[];
+/**
+ * Parses a series `contextSchema` (free-form JSONB) into typed fields.
+ * Supports the two shapes seen in practice:
+ * - an array of `{ name, type?, required?, description? }`
+ * - an object map `{ NAME: "string" | { type, required?, description? } }`
+ * Anything else → `null` (context stays `Record<string, unknown>`).
+ */
+export declare function parseContextSchema(schema: unknown): ContextField[] | null;
+/** Converts a printer display name to a camelCase identifier alias. */
+export declare function aliasFromName(name: string): string;

package/dist/typegen/meta.js

@@ -0,0 +1,209 @@
+/**
+ * Fetches metadata for every declaration in `dm.config.json`.
+ * `printers: "all"` expands to every printer in the company registry, with
+ * aliases derived from printer names.
+ */
+export async function loadTypegenMeta(config, client) {
+    const tables = [];
+    const odbc = [];
+    const scripts = [];
+    for (const source of config.sources) {
+        switch (source.type) {
+            case 'lookup_table': {
+                const t = await client.getLookupTable(source.sourceId);
+                tables.push({
+                    alias: source.alias,
+                    sourceId: source.sourceId,
+                    tableName: t.table_name,
+                    description: t.description ?? undefined,
+                    fields: t.value_schema ?? [],
+                });
+                break;
+            }
+            case 'odbc_query': {
+                const q = await client.getOdbcQuery(source.sourceId);
+                odbc.push({
+                    alias: source.alias,
+                    sourceId: source.sourceId,
+                    queryName: q.query_name,
+                    description: q.description ?? undefined,
+                    parameters: q.parameters ?? [],
+                });
+                break;
+            }
+            case 'script': {
+                const s = await client.getScript(source.sourceId);
+                scripts.push({
+                    alias: source.alias,
+                    sourceId: source.sourceId,
+                    scriptName: s.script_name,
+                    description: s.description ?? undefined,
+                });
+                break;
+            }
+        }
+    }
+    const serials = [];
+    for (const decl of config.serialSeries) {
+        const s = await client.getSeries(decl.seriesId);
+        serials.push({
+            alias: decl.alias,
+            seriesId: decl.seriesId,
+            name: s.name,
+            formatString: s.formatString,
+            contextFields: parseContextSchema(s.contextSchema),
+        });
+    }
+    const printers = [];
+    if (config.printers === 'all') {
+        const all = await client.listPrinters();
+        const used = new Set();
+        for (const p of all) {
+            printers.push(toPrinterMeta(uniqueAlias(aliasFromName(p.name), used), p));
+        }
+    }
+    else if (config.printers.length > 0) {
+        const all = await client.listPrinters();
+        const byId = new Map(all.map((p) => [String(p.printerId), p]));
+        for (const decl of config.printers) {
+            const p = byId.get(String(decl.printerId));
+            if (!p) {
+                throw new Error(`Printer ${decl.printerId} (alias "${decl.alias}") not found in the company printer registry (GET /api/printers)`);
+            }
+            printers.push(toPrinterMeta(decl.alias, p));
+        }
+    }
+    return { tables, odbc, scripts, serials, printers };
+}
+function toPrinterMeta(alias, p) {
+    return {
+        alias,
+        printerId: Number(p.printerId),
+        name: p.name,
+        type: p.type,
+        protocol: p.protocol,
+        dpi: p.dpi,
+        isZplCompatible: p.isZplCompatible === true,
+        formats: printerFormats(p),
+    };
+}
+/**
+ * Derives the supported print formats for a printer:
+ * - `zpl` for ZPL-compatible printers (raw-socket Zebra path);
+ * - `pdf` and `pdf_base64` for IPP printers;
+ * - `html` is always available (server-side rendering before delivery).
+ * If nothing else matched, the full union is allowed (capability unknown).
+ */
+export function printerFormats(p) {
+    const formats = [];
+    if (p.isZplCompatible === true)
+        formats.push('zpl');
+    if (p.protocol === 'ipp')
+        formats.push('pdf', 'pdf_base64');
+    formats.push('html');
+    if (formats.length === 1)
+        return ['zpl', 'pdf', 'pdf_base64', 'html'];
+    return formats;
+}
+/**
+ * Parses a series `contextSchema` (free-form JSONB) into typed fields.
+ * Supports the two shapes seen in practice:
+ * - an array of `{ name, type?, required?, description? }`
+ * - an object map `{ NAME: "string" | { type, required?, description? } }`
+ * Anything else → `null` (context stays `Record<string, unknown>`).
+ */
+export function parseContextSchema(schema) {
+    let value = schema;
+    if (typeof value === 'string') {
+        try {
+            value = JSON.parse(value);
+        }
+        catch {
+            return null;
+        }
+    }
+    if (!value || typeof value !== 'object')
+        return null;
+    const toTs = (t) => {
+        switch (typeof t === 'string' ? t.toLowerCase() : '') {
+            case 'number':
+            case 'int':
+            case 'integer':
+            case 'float':
+                return 'number';
+            case 'boolean':
+            case 'bool':
+                return 'boolean';
+            case 'string':
+            case 'text':
+            case 'date':
+                return 'string';
+            default:
+                return 'string';
+        }
+    };
+    if (Array.isArray(value)) {
+        const fields = [];
+        for (const item of value) {
+            if (!item || typeof item !== 'object')
+                return null;
+            const o = item;
+            if (typeof o['name'] !== 'string' || o['name'] === '')
+                return null;
+            fields.push({
+                name: o['name'],
+                tsType: toTs(o['type']),
+                required: o['required'] === true,
+                description: typeof o['description'] === 'string' ? o['description'] : undefined,
+            });
+        }
+        return fields;
+    }
+    // Object map form.
+    const entries = Object.entries(value);
+    if (entries.length === 0)
+        return [];
+    const fields = [];
+    for (const [name, v] of entries) {
+        if (typeof v === 'string') {
+            fields.push({ name, tsType: toTs(v), required: false });
+        }
+        else if (v && typeof v === 'object' && !Array.isArray(v)) {
+            const o = v;
+            fields.push({
+                name,
+                tsType: toTs(o['type']),
+                required: o['required'] === true,
+                description: typeof o['description'] === 'string' ? o['description'] : undefined,
+            });
+        }
+        else {
+            return null;
+        }
+    }
+    return fields;
+}
+/** Converts a printer display name to a camelCase identifier alias. */
+export function aliasFromName(name) {
+    const parts = name
+        .replace(/[^A-Za-z0-9]+/g, ' ')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean);
+    if (parts.length === 0)
+        return 'printer';
+    const [first, ...rest] = parts;
+    let alias = first.toLowerCase() + rest.map((p) => p.charAt(0).toUpperCase() + p.slice(1).toLowerCase()).join('');
+    if (/^[0-9]/.test(alias))
+        alias = `p${alias}`;
+    return alias;
+}
+function uniqueAlias(base, used) {
+    let alias = base;
+    let n = 2;
+    while (used.has(alias))
+        alias = `${base}${n++}`;
+    used.add(alias);
+    return alias;
+}
+//# sourceMappingURL=meta.js.map

package/dist/typegen/meta.js.map

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

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@datamagik/cli",
+  "version": "0.1.0",
+  "description": "DataMagik dm CLI: login, typegen, dev server, and SPA publish for app-designer SPA apps",
+  "license": "MIT",
+  "type": "module",
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "dm": "./dist/index.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "assets"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "gen:globals": "node scripts/gen-script-globals.mjs",
+    "gen:globals:check": "node scripts/gen-script-globals.mjs --check",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "archiver": "^7.0.1",
+    "commander": "^12.1.0"
+  },
+  "devDependencies": {
+    "@types/archiver": "^6.0.3",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.6.0",
+    "vitest": "^3.2.0"
+  }
+}