@datamagik/cli 0.1.0

package/dist/commands/add.d.ts

@@ -0,0 +1,28 @@
+import { type PlatformListClient } from '../api.js';
+/** The resource kinds `dm add` can declare. */
+export type ResourceType = 'lookup_table' | 'odbc_query' | 'script' | 'serial_series' | 'printer';
+export interface AddOptions {
+    /** Resource type (positional). Prompts when omitted on a TTY. */
+    type?: string;
+    /** Numeric id (selects directly) or a search term (filters the list). */
+    query?: string;
+    /** Alias to declare; derived from the resource name when omitted. */
+    alias?: string;
+    /** Skip the post-add `dm typegen`. */
+    noTypegen?: boolean;
+    /** Assume "yes" for prompts (non-interactive). */
+    yes?: boolean;
+}
+/** `Open Orders` → `openOrders`; falls back to `resource` when empty. */
+export declare function toAlias(name: string): string;
+/**
+ * `dm add [type] [id|search] [--alias <a>] [--no-typegen]`
+ *
+ * Browses the active tenant's resources, lets you pick one, declares it in
+ * dm.config.json with a chosen alias, and re-runs `dm typegen`. Interactive
+ * when run on a TTY; fully scriptable via positional args and `--yes`.
+ */
+export declare function addCommand(opts: AddOptions, deps?: {
+    client?: PlatformListClient;
+    cwd?: string;
+}): Promise<void>;

package/dist/commands/add.js

@@ -0,0 +1,260 @@
+import { createInterface } from 'node:readline/promises';
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { requireCredentials } from '../credentials.js';
+import { PlatformClient } from '../api.js';
+import { ALIAS_RE } from '../config.js';
+import { typegenCommand } from './typegen.js';
+const num = (v) => (typeof v === 'number' ? v : Number(v));
+const KINDS = {
+    lookup_table: {
+        type: 'lookup_table',
+        label: 'Lookup table',
+        configArray: 'sources',
+        idKey: 'sourceId',
+        async fetch(c) {
+            return (await c.listLookupTables()).map((t) => ({ id: t.lookup_table_id, name: t.table_name, description: t.description ?? undefined }));
+        },
+        decl: (id, alias) => ({ sourceId: id, type: 'lookup_table', alias }),
+    },
+    odbc_query: {
+        type: 'odbc_query',
+        label: 'ODBC query',
+        configArray: 'sources',
+        idKey: 'sourceId',
+        async fetch(c) {
+            return (await c.listOdbcQueries()).map((q) => ({ id: num(q.query_id), name: q.query_name, description: q.description ?? undefined }));
+        },
+        decl: (id, alias) => ({ sourceId: id, type: 'odbc_query', alias }),
+    },
+    script: {
+        type: 'script',
+        label: 'Script',
+        configArray: 'sources',
+        idKey: 'sourceId',
+        async fetch(c) {
+            return (await c.listScripts()).map((s) => ({ id: s.script_id, name: s.script_name, description: s.description ?? undefined }));
+        },
+        decl: (id, alias) => ({ sourceId: id, type: 'script', alias }),
+    },
+    serial_series: {
+        type: 'serial_series',
+        label: 'Serial series',
+        configArray: 'serialSeries',
+        idKey: 'seriesId',
+        async fetch(c) {
+            return (await c.listSeries()).map((s) => ({ id: num(s.seriesId), name: s.name }));
+        },
+        decl: (id, alias) => ({ seriesId: id, alias }),
+    },
+    printer: {
+        type: 'printer',
+        label: 'Printer',
+        configArray: 'printers',
+        idKey: 'printerId',
+        async fetch(c) {
+            return (await c.listPrinters()).map((p) => ({ id: num(p.printerId), name: p.name, description: p.type }));
+        },
+        decl: (id, alias) => ({ printerId: id, alias }),
+    },
+};
+/** Accepts the canonical type or a friendly synonym. */
+const TYPE_SYNONYMS = {
+    lookup_table: 'lookup_table', lookup: 'lookup_table', table: 'lookup_table',
+    odbc_query: 'odbc_query', odbc: 'odbc_query', query: 'odbc_query', sql: 'odbc_query',
+    script: 'script',
+    serial_series: 'serial_series', serial: 'serial_series', series: 'serial_series',
+    printer: 'printer', printers: 'printer',
+};
+/** `Open Orders` → `openOrders`; falls back to `resource` when empty. */
+export function toAlias(name) {
+    const words = name.replace(/[^A-Za-z0-9]+/g, ' ').trim().split(/\s+/).filter(Boolean);
+    if (words.length === 0)
+        return 'resource';
+    const camel = words
+        .map((w, i) => (i === 0 ? w.toLowerCase() : w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()))
+        .join('');
+    return /^[0-9]/.test(camel) ? `r${camel}` : camel;
+}
+function resolveType(raw) {
+    const key = raw.trim().toLowerCase();
+    const t = TYPE_SYNONYMS[key];
+    if (!t) {
+        throw new Error(`Unknown resource type "${raw}". Use one of: lookup_table, odbc_query, script, serial_series, printer.`);
+    }
+    return t;
+}
+async function promptType(rl) {
+    const order = ['lookup_table', 'odbc_query', 'script', 'serial_series', 'printer'];
+    console.log('What kind of resource do you want to add?');
+    order.forEach((t, i) => console.log(`  ${i + 1}) ${KINDS[t].label}`));
+    const ans = (await rl.question('Choose [1]: ')).trim().toLowerCase();
+    if (ans === '')
+        return 'lookup_table';
+    const n = Number(ans);
+    if (Number.isInteger(n) && n >= 1 && n <= order.length)
+        return order[n - 1];
+    return resolveType(ans);
+}
+function readRawConfig(dir) {
+    const file = path.join(dir, 'dm.config.json');
+    if (!existsSync(file)) {
+        throw new Error(`No dm.config.json in ${dir}. Run \`dm init\` first, or create one.`);
+    }
+    let obj;
+    try {
+        obj = JSON.parse(readFileSync(file, 'utf8'));
+    }
+    catch (err) {
+        throw new Error(`dm.config.json is not valid JSON: ${String(err)}`);
+    }
+    if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+        throw new Error('dm.config.json must be a JSON object');
+    }
+    return { file, obj: obj };
+}
+/** Every alias already declared, across all categories (they share a registry). */
+function existingAliases(obj) {
+    const out = new Set();
+    for (const key of ['sources', 'serialSeries', 'printers']) {
+        const arr = obj[key];
+        if (!Array.isArray(arr))
+            continue;
+        for (const d of arr) {
+            const alias = d?.['alias'];
+            if (typeof alias === 'string')
+                out.add(alias);
+        }
+    }
+    return out;
+}
+function filterRows(rows, term) {
+    if (!term)
+        return rows;
+    const t = term.toLowerCase();
+    return rows.filter((r) => r.name.toLowerCase().includes(t) || String(r.id) === term);
+}
+/**
+ * `dm add [type] [id|search] [--alias <a>] [--no-typegen]`
+ *
+ * Browses the active tenant's resources, lets you pick one, declares it in
+ * dm.config.json with a chosen alias, and re-runs `dm typegen`. Interactive
+ * when run on a TTY; fully scriptable via positional args and `--yes`.
+ */
+export async function addCommand(opts, deps = {}) {
+    const cwd = deps.cwd ?? process.cwd();
+    const { file, obj } = readRawConfig(cwd);
+    const creds = requireCredentials();
+    const client = deps.client ?? new PlatformClient(creds.url, creds.token);
+    const tty = !!process.stdin.isTTY && !opts.yes;
+    const rl = tty ? createInterface({ input: process.stdin, output: process.stdout }) : null;
+    try {
+        let type;
+        if (opts.type)
+            type = resolveType(opts.type);
+        else if (rl)
+            type = await promptType(rl);
+        else
+            throw new Error('Resource type required in non-interactive mode (e.g. `dm add lookup_table 17`).');
+        const kind = KINDS[type];
+        const rows = await kind.fetch(client);
+        if (rows.length === 0) {
+            console.log(`No ${kind.label.toLowerCase()}s found in this tenant (${creds.url}).`);
+            return;
+        }
+        // Direct id match short-circuits selection.
+        let chosen;
+        if (opts.query !== undefined && /^[0-9]+$/.test(opts.query.trim())) {
+            chosen = rows.find((r) => r.id === Number(opts.query));
+            if (!chosen)
+                throw new Error(`No ${kind.label.toLowerCase()} with id ${opts.query} in this tenant.`);
+        }
+        if (!chosen) {
+            let candidates = filterRows(rows, opts.query);
+            if (candidates.length === 0) {
+                console.log(`No ${kind.label.toLowerCase()} matches "${opts.query}".`);
+                return;
+            }
+            if (candidates.length === 1) {
+                chosen = candidates[0];
+            }
+            else if (rl) {
+                // Optional interactive search to narrow a long list.
+                if (opts.query === undefined && candidates.length > 12) {
+                    const term = (await rl.question(`Search ${kind.label.toLowerCase()}s (blank = list all): `)).trim();
+                    if (term)
+                        candidates = filterRows(rows, term);
+                }
+                console.log(`\n${kind.label}s (${creds.url}):`);
+                candidates.slice(0, 50).forEach((r, i) => {
+                    const desc = r.description ? `  — ${r.description}` : '';
+                    console.log(`  ${String(i + 1).padStart(2)}) [#${r.id}] ${r.name}${desc}`);
+                });
+                if (candidates.length > 50)
+                    console.log(`  … and ${candidates.length - 50} more (refine with a search term)`);
+                const pick = Number((await rl.question('Select #: ')).trim());
+                if (!Number.isInteger(pick) || pick < 1 || pick > Math.min(candidates.length, 50)) {
+                    throw new Error('No valid selection made.');
+                }
+                chosen = candidates[pick - 1];
+            }
+            else {
+                throw new Error(`"${opts.query ?? ''}" matched ${candidates.length} ${kind.label.toLowerCase()}s; pass an id or a unique search term.`);
+            }
+        }
+        const selected = chosen;
+        // Resolve the alias (suggest from name; ensure uniqueness). An explicit
+        // blank --alias falls back to the derived name, same as omitting it.
+        const taken = existingAliases(obj);
+        let alias = opts.alias?.trim() || toAlias(selected.name);
+        if (rl && !opts.alias) {
+            const ans = (await rl.question(`Alias [${alias}]: `)).trim();
+            if (ans)
+                alias = ans;
+        }
+        if (!ALIAS_RE.test(alias)) {
+            throw new Error(`Alias "${alias}" is not a valid identifier (letters, digits, _, $; not starting with a digit).`);
+        }
+        if (taken.has(alias)) {
+            throw new Error(`Alias "${alias}" is already declared in dm.config.json (aliases are unique across all resources).`);
+        }
+        // Locate the target array, guarding hand-edited / malformed config.
+        const current = obj[kind.configArray];
+        if (kind.type === 'printer' && current === 'all') {
+            console.log('printers is set to "all" — every printer is already available. Nothing to add.');
+            return;
+        }
+        if (current !== undefined && !Array.isArray(current)) {
+            throw new Error(`dm.config.json: "${kind.configArray}" must be an array; refusing to overwrite it.`);
+        }
+        const arr = Array.isArray(current) ? current : [];
+        if (arr.some((d) => Number(d?.[kind.idKey]) === selected.id)) {
+            console.log(`[#${selected.id}] ${selected.name} is already declared. Nothing to add.`);
+            return;
+        }
+        arr.push(kind.decl(selected.id, alias));
+        obj[kind.configArray] = arr;
+        writeFileSync(file, JSON.stringify(obj, null, 2) + '\n');
+        console.log(`Added ${kind.label.toLowerCase()} [#${selected.id}] "${selected.name}" as alias \`${alias}\` to dm.config.json.`);
+        // Regenerate types so the new alias is immediately usable.
+        if (!opts.noTypegen) {
+            let run = true;
+            if (rl) {
+                const ans = (await rl.question('Run `dm typegen` now to update src/dm.generated.ts? [Y/n]: ')).trim().toLowerCase();
+                run = ans === '' || ans === 'y' || ans === 'yes';
+            }
+            if (run) {
+                rl?.close();
+                await typegenCommand({});
+                return;
+            }
+        }
+        else {
+            console.log('Run `dm typegen` to regenerate src/dm.generated.ts.');
+        }
+    }
+    finally {
+        rl?.close();
+    }
+}
+//# sourceMappingURL=add.js.map

package/dist/commands/add.js.map

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

package/dist/commands/dev.d.ts

@@ -0,0 +1,25 @@
+export interface DevOptions {
+    app?: string;
+    context?: string[];
+    port?: string;
+}
+/**
+ * `dm dev [--app <id>] [--context key=val ...]`
+ *
+ * Runs the user project's Vite dev server (via the Vite JS API) with an
+ * injected plugin that:
+ * - proxies `/api/*` to the platform URL, adding the builder bearer;
+ * - serves `GET /__dm/context` with a simulated `dm-context-init` payload
+ *   (`surface: 'dev'`, `--context key=val` flags become `context.params`);
+ * - forces `base: './'` so built asset URLs stay relative (token-path serving).
+ *
+ * Also prints the in-platform dev URL
+ * `<url>/datamagik/app-designer/<id>/view?dev_server=http://localhost:5173`.
+ */
+export declare function devCommand(opts: DevOptions): Promise<void>;
+/**
+ * The injected Vite plugin: serves the simulated context and pins `base`.
+ * Defined as a plain object so it works with whatever Vite major the user
+ * project has installed (the plugin API surface used here is stable).
+ */
+export declare function dmDevPlugin(contextInit: unknown): Record<string, unknown>;

package/dist/commands/dev.js

@@ -0,0 +1,113 @@
+import { createRequire } from 'node:module';
+import { pathToFileURL } from 'node:url';
+import { loadDmConfig } from '../config.js';
+import { requireCredentials } from '../credentials.js';
+import { typegenCommand } from './typegen.js';
+/**
+ * `dm dev [--app <id>] [--context key=val ...]`
+ *
+ * Runs the user project's Vite dev server (via the Vite JS API) with an
+ * injected plugin that:
+ * - proxies `/api/*` to the platform URL, adding the builder bearer;
+ * - serves `GET /__dm/context` with a simulated `dm-context-init` payload
+ *   (`surface: 'dev'`, `--context key=val` flags become `context.params`);
+ * - forces `base: './'` so built asset URLs stay relative (token-path serving).
+ *
+ * Also prints the in-platform dev URL
+ * `<url>/datamagik/app-designer/<id>/view?dev_server=http://localhost:5173`.
+ */
+export async function devCommand(opts) {
+    const cwd = process.cwd();
+    const config = loadDmConfig(cwd);
+    const creds = requireCredentials();
+    const appId = opts.app ? Number(opts.app) : config.appId;
+    if (!Number.isInteger(appId) || appId <= 0) {
+        console.error(`Invalid app id: ${opts.app ?? config.appId}`);
+        process.exit(1);
+    }
+    const port = opts.port ? Number(opts.port) : 5173;
+    // Best-effort typegen on start (design §7.2) — dev keeps working offline.
+    try {
+        await typegenCommand({});
+    }
+    catch (err) {
+        console.warn(`typegen on start failed (continuing): ${String(err)}`);
+    }
+    const params = {};
+    for (const kv of opts.context ?? []) {
+        const eq = kv.indexOf('=');
+        if (eq <= 0) {
+            console.error(`Invalid --context value '${kv}' — expected key=val`);
+            process.exit(1);
+        }
+        params[kv.slice(0, eq)] = kv.slice(eq + 1);
+    }
+    const contextInit = {
+        context: {
+            appId,
+            appName: `App ${appId} (dev)`,
+            version: 0,
+            surface: 'dev',
+            params,
+            user: { id: 0, name: 'dev' },
+            company: { id: 0, name: 'dev' },
+        },
+        sdkProtocolVersion: 1,
+    };
+    // Resolve vite from the USER's project, not the CLI's own dependencies.
+    let viteUrl;
+    try {
+        const require = createRequire(`${cwd}/package.json`);
+        viteUrl = pathToFileURL(require.resolve('vite')).href;
+    }
+    catch {
+        console.error('Could not resolve `vite` from this project. `dm dev` wraps your project’s Vite dev server —\n' +
+            'install it first: npm install -D vite');
+        process.exit(1);
+    }
+    const vite = (await import(viteUrl));
+    const server = await vite.createServer({
+        root: cwd,
+        base: './',
+        server: {
+            port,
+            strictPort: true,
+            proxy: {
+                '/api': {
+                    target: creds.url,
+                    changeOrigin: true,
+                    headers: { Authorization: `Bearer ${creds.token}` },
+                },
+            },
+        },
+        plugins: [dmDevPlugin(contextInit)],
+    });
+    await server.listen();
+    server.printUrls();
+    console.log('');
+    console.log(`  dm context:  http://localhost:${port}/__dm/context (surface: dev)`);
+    console.log(`  In-platform dev URL:`);
+    console.log(`  ${creds.url}/datamagik/app-designer/${appId}/view?dev_server=http://localhost:${port}`);
+    console.log('  (requires Builder permission and ALLOW_SPA_DEV_SERVER=true on a non-production env)');
+}
+/**
+ * The injected Vite plugin: serves the simulated context and pins `base`.
+ * Defined as a plain object so it works with whatever Vite major the user
+ * project has installed (the plugin API surface used here is stable).
+ */
+export function dmDevPlugin(contextInit) {
+    return {
+        name: 'datamagik:dev',
+        config() {
+            return { base: './' };
+        },
+        configureServer(server) {
+            server.middlewares.use('/__dm/context', (_req, res) => {
+                res.setHeader('Content-Type', 'application/json');
+                res.setHeader('Cache-Control', 'no-store');
+                res.end(JSON.stringify(contextInit));
+            });
+        },
+    };
+}
+//# sourceMappingURL=dev.js.map

package/dist/commands/dev.js.map

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

package/dist/commands/init.d.ts

@@ -0,0 +1,23 @@
+/** The two scaffolds `dm init` can produce. */
+export type StarterTemplate = 'simple' | 'showcase';
+export interface InitOptions {
+    /** Target directory (positional arg). Defaults to the current directory. */
+    dir?: string;
+    /** Which starter to scaffold; prompts when omitted on a TTY. */
+    template?: string;
+    /** Application id to write into dm.config.json. */
+    app?: string;
+    /** Overwrite / merge into a non-empty directory. */
+    force?: boolean;
+}
+/**
+ * `dm init [dir] [--template simple|showcase] [--app <id>]`
+ *
+ * Scaffolds a Vue 3 + Vite starter for the app SDK. `showcase` is a
+ * platform-styled app with working examples for every SDK area (context, data
+ * query, scripts, serials, printing, navigation, output events); `simple` is a
+ * minimal connect-and-query starter. The generated `dm.config.json` carries
+ * placeholder resource ids — set `appId` and the real ids, then run
+ * `dm typegen` / `dm dev`.
+ */
+export declare function initCommand(opts: InitOptions): Promise<void>;

package/dist/commands/init.js

@@ -0,0 +1,136 @@
+import { createInterface } from 'node:readline/promises';
+import { existsSync, mkdirSync, readdirSync, readFileSync, statSync, writeFileSync } from 'node:fs';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+const TEMPLATES = ['simple', 'showcase'];
+/** Files copied verbatim apart from the leading-underscore rename below. */
+const RENAME_ON_COPY = {
+    // npm refuses to publish a file literally named `.gitignore`, so the
+    // template stores it as `_gitignore` and we restore the dotfile on copy.
+    _gitignore: '.gitignore',
+};
+/** Extensions copied byte-for-byte (no text token substitution). */
+const BINARY_EXT = new Set([
+    '.png', '.jpg', '.jpeg', '.gif', '.webp', '.ico',
+    '.woff', '.woff2', '.ttf', '.otf', '.pdf', '.zip',
+]);
+/** Token replacements applied to every copied text file. */
+function render(contents, vars) {
+    return contents
+        .replaceAll('__APP_NAME__', vars.appName)
+        .replaceAll('__PKG_NAME__', vars.pkgName)
+        .replaceAll('__APP_ID__', String(vars.appId));
+}
+/** Coerces a directory name into a valid npm package name. */
+function toPackageName(name) {
+    const slug = name
+        .toLowerCase()
+        .replace(/[^a-z0-9._-]+/g, '-')
+        .replace(/^[._-]+|[._-]+$/g, '');
+    return slug || 'datamagik-app';
+}
+/** Locates the bundled template tree (works from both src/ and dist/). */
+function templateRoot(template) {
+    const here = path.dirname(fileURLToPath(import.meta.url));
+    return path.resolve(here, '..', '..', 'templates', template);
+}
+function copyTree(src, dest, vars) {
+    const written = [];
+    for (const entry of readdirSync(src, { withFileTypes: true })) {
+        const from = path.join(src, entry.name);
+        const targetName = RENAME_ON_COPY[entry.name] ?? entry.name;
+        const to = path.join(dest, targetName);
+        if (entry.isDirectory()) {
+            mkdirSync(to, { recursive: true });
+            written.push(...copyTree(from, to, vars));
+        }
+        else {
+            mkdirSync(path.dirname(to), { recursive: true });
+            if (BINARY_EXT.has(path.extname(entry.name).toLowerCase())) {
+                writeFileSync(to, readFileSync(from)); // copy bytes verbatim
+            }
+            else {
+                writeFileSync(to, render(readFileSync(from, 'utf8'), vars));
+            }
+            written.push(to);
+        }
+    }
+    return written;
+}
+/** Resolves the template from the flag, or prompts on a TTY (default: showcase). */
+async function resolveTemplate(flag) {
+    if (flag !== undefined) {
+        if (!TEMPLATES.includes(flag)) {
+            throw new Error(`--template must be one of ${TEMPLATES.join(', ')} (got "${flag}")`);
+        }
+        return flag;
+    }
+    if (!process.stdin.isTTY)
+        return 'showcase';
+    console.log('Which starter would you like?');
+    console.log('  1) showcase  — platform-styled app demonstrating every SDK area (recommended)');
+    console.log('  2) simple    — minimal app: connect, show context, one data query');
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    try {
+        const answer = (await rl.question('Choose [1]: ')).trim().toLowerCase();
+        if (answer === '2' || answer === 'simple')
+            return 'simple';
+        return 'showcase';
+    }
+    finally {
+        rl.close();
+    }
+}
+/**
+ * `dm init [dir] [--template simple|showcase] [--app <id>]`
+ *
+ * Scaffolds a Vue 3 + Vite starter for the app SDK. `showcase` is a
+ * platform-styled app with working examples for every SDK area (context, data
+ * query, scripts, serials, printing, navigation, output events); `simple` is a
+ * minimal connect-and-query starter. The generated `dm.config.json` carries
+ * placeholder resource ids — set `appId` and the real ids, then run
+ * `dm typegen` / `dm dev`.
+ */
+export async function initCommand(opts) {
+    const targetDir = path.resolve(opts.dir ?? '.');
+    const appName = path.basename(targetDir);
+    const appId = opts.app !== undefined ? Number(opts.app) : 0;
+    if (opts.app !== undefined && (!Number.isInteger(appId) || appId <= 0)) {
+        throw new Error(`--app must be a positive integer (got "${opts.app}")`);
+    }
+    const template = await resolveTemplate(opts.template);
+    if (existsSync(targetDir)) {
+        if (!statSync(targetDir).isDirectory()) {
+            throw new Error(`${targetDir} exists and is not a directory.`);
+        }
+        const existing = readdirSync(targetDir);
+        if (existing.length > 0 && !opts.force) {
+            throw new Error(`${targetDir} is not empty. Re-run with --force to scaffold into it anyway.`);
+        }
+    }
+    mkdirSync(targetDir, { recursive: true });
+    const root = templateRoot(template);
+    if (!existsSync(root)) {
+        throw new Error(`Starter template "${template}" not found at ${root} (corrupt installation?)`);
+    }
+    const written = copyTree(root, targetDir, { appName, pkgName: toPackageName(appName), appId });
+    const rel = opts.dir && opts.dir !== '.' ? opts.dir : '.';
+    console.log(`Scaffolded the ${template} starter in ${targetDir} (${written.length} files).`);
+    console.log('');
+    console.log('Next steps:');
+    if (rel !== '.')
+        console.log(`  cd ${rel}`);
+    console.log('  npm install');
+    console.log('  npx dm login --url https://staging.data-magik.com   # or https://data-magik.com');
+    if (appId <= 0) {
+        console.log('  # set "appId" in dm.config.json to your application id (App Studio header)');
+    }
+    console.log('  npx dm dev         # run it now — uses the bundled demo types');
+    console.log('');
+    console.log('Then wire your own platform resources (the starter ships placeholders):');
+    console.log('  npx dm add         # search this tenant and declare a real resource');
+    console.log('  npx dm typegen     # regenerate src/dm.generated.ts from your resources');
+    console.log('  # tip: remove the unused placeholder entries from dm.config.json so');
+    console.log('  #      dm typegen does not try to fetch ids that do not exist.');
+}
+//# sourceMappingURL=init.js.map

package/dist/commands/init.js.map

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

package/dist/commands/login.d.ts

@@ -0,0 +1,16 @@
+export interface LoginOptions {
+    url?: string;
+    token?: string;
+}
+/**
+ * `dm login [--url <platform>] [--token <dcp_...>]`
+ *
+ * Stores `{ url, token }` in `~/.config/datamagik/credentials.json` (0600).
+ * When `--token` is omitted, prompts on stdin for an API key created in the
+ * platform UI (Settings → API Keys).
+ *
+ * TODO(browser OAuth): the design (§7.2) calls for a browser flow where the
+ * server mints a builder bearer via `CreateSystemAPIKey` and delivers it to a
+ * localhost callback. Until that endpoint ships, paste a `dcp_` API key.
+ */
+export declare function loginCommand(opts: LoginOptions): Promise<void>;