@datamagik/cli 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 DataMagik
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/assets/dm-script-globals.d.ts

@@ -0,0 +1,181 @@
+// ----------------------------------------------------------------------------
+// GENERATED by scripts/gen-script-globals.mjs — DO NOT EDIT.
+// Ambient types for the DataMagik script-engine V8 sandbox. Globals + method
+// names are scraped from services/v8_script_context.go; signatures come from a
+// curated overlay. Re-run the generator after changing the engine globals.
+// ----------------------------------------------------------------------------
+export {};
+
+declare global {
+  /** Caller-supplied input for this run (augment per script as needed). */
+  interface DmContext { [key: string]: unknown }
+  const context: DmContext;
+
+  const console: {
+    log(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+  };
+
+  /** Fetch a whitelisted external URL (auth via credentials.get). */
+  function fetch(url: string, opts?: Record<string, unknown>): Promise<{ ok: boolean; status: number; json(): Promise<any>; text(): Promise<string> }>;
+  function fetchAsync(url: string, opts?: Record<string, unknown>): Promise<any>;
+
+  /** Printers, sites, and connector file I/O. */
+  const connectors: {
+    copyFile(...args: any[]): Promise<any>;
+    deleteFile(...args: any[]): Promise<any>;
+    fileExists(...args: any[]): Promise<any>;
+    getConnectors(...args: any[]): Promise<any>;
+    getConnectorsBySite(...args: any[]): Promise<any>;
+    getPrinter(...args: any[]): Promise<any>;
+    getPrinterById(...args: any[]): Promise<any>;
+    getPrinters(...args: any[]): Promise<any>;
+    getSites(...args: any[]): Promise<any>;
+    listFiles(...args: any[]): Promise<any>;
+    mkdir(...args: any[]): Promise<any>;
+    moveFile(...args: any[]): Promise<any>;
+    printBatch(...args: any[]): Promise<any>;
+    printFromTemplate(...args: any[]): Promise<any>;
+    printLabel(...args: any[]): Promise<any>;
+    readFile(...args: any[]): Promise<any>;
+    writeFile(...args: any[]): Promise<any>;
+  };
+
+  /** Secret values configured for this script (never logged). */
+  const credentials: {
+    get(name: string): string;
+  };
+
+  /** Document generation. */
+  const documents: {
+    generate(templateId: number | string, data: Record<string, unknown>, opts?: Record<string, unknown>): Promise<{ requestId: string }>;
+    generateBatch(...args: any[]): Promise<any>;
+    generateSync(...args: any[]): Promise<any>;
+    getStatus(requestId: string): Promise<{ status: string; url?: string }>;
+    getTemplateId(...args: any[]): Promise<any>;
+    mergePdf(...args: any[]): Promise<any>;
+  };
+
+  /** Send email. */
+  const email: {
+    send(...args: any[]): Promise<any>;
+    sendWithTemplate(...args: any[]): Promise<any>;
+  };
+
+  /** Pure utility helpers (synchronous). */
+  const helpers: {
+    deepClone<T>(obj: T): T;
+    deepGet(obj: unknown, path: string): unknown;
+    format(...args: any[]): Promise<any>;
+    formatCurrency(value: number, currency?: string): string;
+    formatDate(date: string | number | Date, format?: string): string;
+    formatNumber(value: number, opts?: Record<string, unknown>): string;
+    getOrDefault<T>(value: T | null | undefined, fallback: T): T;
+    hash(input: string, algo?: string): string;
+    pad(value: string | number, length: number, char?: string): string;
+    parseCSV(csv: string): Record<string, string>[];
+    parseDate(value: string): Date;
+    parseExcel(...args: any[]): Promise<any>;
+    require(...args: any[]): Promise<any>;
+    truncate(text: string, length: number): string;
+    uuid(): string;
+  };
+
+  /** HTTP helpers (whitelisted hosts). */
+  const http: {
+    get(url: string, opts?: Record<string, unknown>): Promise<any>;
+  };
+
+  /** Pre-configured SQL/ODBC queries. */
+  const odbc: {
+    execute(...args: any[]): Promise<any>;
+    executeAsync(...args: any[]): Promise<any>;
+    /** Run a saved ODBC query by name. */
+    executeQuery(queryName: string, params?: Record<string, unknown>): Promise<{ rows: any[]; rowCount?: number; columns?: string[] }>;
+    executeQueryAsync(...args: any[]): Promise<any>;
+  };
+
+  /** Plex ERP data sources (handles URL routing, basic-auth, retry/backoff, size cap). */
+  const plex: {
+    /** Call a Plex data source. */
+    execute(opts: { companyCode?: string; credentialName?: string; dataSourceId: number; isTest?: boolean; body?: Record<string, unknown> }): Promise<{ rows?: any[]; outputs?: Record<string, unknown>; [k: string]: unknown }>;
+  };
+
+  /** Role administration. */
+  const roles: {
+    create(...args: any[]): Promise<any>;
+    delete(...args: any[]): Promise<any>;
+    get(...args: any[]): Promise<any>;
+    list(...args: any[]): Promise<any>;
+    update(...args: any[]): Promise<any>;
+  };
+
+  /** Call other scripts. */
+  const scripts: {
+    include(name: string): unknown;
+    run(name: string, inputs?: Record<string, unknown>): Promise<unknown>;
+    runAsync(name: string, inputs?: Record<string, unknown>): Promise<{ executionId: string }>;
+  };
+
+  /** Traceability serial-number series. */
+  const serial: {
+    batch(series: string, count: number, context?: Record<string, unknown>): Promise<Array<{ serialNumber: string; recordId: string }>>;
+    info(...args: any[]): Promise<any>;
+    list(...args: any[]): Promise<any>;
+    next(series: string, context?: Record<string, unknown>): Promise<{ serialNumber: string; recordId: string }>;
+    preview(series: string): Promise<string>;
+    register(...args: any[]): Promise<any>;
+  };
+
+  /** Shipping rates, labels, and tracking. */
+  const shipping: {
+    bookLTLQuote(...args: any[]): Promise<any>;
+    createLabel(...args: any[]): Promise<any>;
+    estimateRates(...args: any[]): Promise<any>;
+    getCarrier(...args: any[]): Promise<any>;
+    getLTLQuote(...args: any[]): Promise<any>;
+    getLTLSpotQuote(...args: any[]): Promise<any>;
+    getLabel(...args: any[]): Promise<any>;
+    getRates(...args: any[]): Promise<any>;
+    listCarrierServices(...args: any[]): Promise<any>;
+    listCarriers(...args: any[]): Promise<any>;
+    listLTLCarriers(...args: any[]): Promise<any>;
+    listPackageTypes(...args: any[]): Promise<any>;
+    trackByLabelId(...args: any[]): Promise<any>;
+    trackShipment(...args: any[]): Promise<any>;
+    validateAddress(...args: any[]): Promise<any>;
+    voidLabel(...args: any[]): Promise<any>;
+  };
+
+  /** Lookup tables (key/value). */
+  const tables: {
+    clear(...args: any[]): Promise<any>;
+    exists(table: string, key: string): Promise<boolean>;
+    get(table: string, key: string): Promise<unknown>;
+    getAll(table: string): Promise<Record<string, unknown>>;
+    getValue(table: string, key: string): Promise<unknown>;
+    list(...args: any[]): Promise<any>;
+    listTables(...args: any[]): Promise<any>;
+    set(table: string, key: string, value: unknown): Promise<void>;
+  };
+
+  /** User administration. */
+  const users: {
+    assignRole(...args: any[]): Promise<any>;
+    assignRoles(...args: any[]): Promise<any>;
+    getRoles(...args: any[]): Promise<any>;
+    list(...args: any[]): Promise<any>;
+    removeRole(...args: any[]): Promise<any>;
+    removeRoles(...args: any[]): Promise<any>;
+  };
+
+  /** ZPL label helpers. */
+  const zpl: {
+    fromTemplate(...args: any[]): Promise<any>;
+  };
+
+  /** Script entry point. */
+  function main(context: DmContext): unknown | Promise<unknown>;
+}

package/dist/api.d.ts

@@ -0,0 +1,247 @@
+/**
+ * Thin platform API client for the CLI (metadata fetch + publish).
+ *
+ * Endpoint paths and response field names verified against the Go handlers:
+ * - `GET /api/script-engine/lookup-tables/:id` → `{ success, table, data }`
+ *   (`internal/infrastructure/scriptEngineLookupHandlers.go:490`); the table's
+ *   `value_schema` is `[]SchemaField{ name, type, lookup_table_id?, description? }`
+ *   (`internal/models/script_engine_lookup.go:1151`).
+ * - `GET /api/odbc/queries/:id` → bare `ODBCQuery` object with
+ *   `parameters: [{ name, type, default }]` (`internal/infrastructure/odbcHandlers.go:91`,
+ *   `internal/models/odbc_query.go:17`). NOTE: the design doc said
+ *   `/api/sql/queries/:id`; the real route is `/api/odbc/queries/:id`
+ *   (`internal/infrastructure/scriptEngineRoutes.go:122`).
+ * - `GET /api/script-engine/scripts/:id` → `{ success, script }` with
+ *   `script.script_name` (`internal/infrastructure/scriptEngineHandlers.go:338`).
+ * - `GET /api/traceability/series/:id` → bare `TraceabilitySeries` (camelCase:
+ *   `name`, `formatString`, `contextSchema`; ids serialize as strings)
+ *   (`internal/infrastructure/traceabilityHandlers.go:211`,
+ *   `internal/models/manufacturing_printing.go:148`).
+ * - `GET /api/printers` → `{ printers: [...] }` (camelCase `Printer`,
+ *   `printerId` serialized as string) (`internal/infrastructure/connectorHandlers.go:704`).
+ */
+export interface SchemaField {
+    name: string;
+    type: string;
+    lookup_table_id?: number;
+    display_field?: string;
+    description?: string;
+}
+export interface LookupTableMeta {
+    lookup_table_id: number;
+    table_name: string;
+    description?: string | null;
+    value_schema?: SchemaField[] | null;
+}
+/** Lookup-table list item (`GET /api/script-engine/lookup-tables` → `tables`). */
+export interface LookupTableListItem {
+    lookup_table_id: number;
+    table_name: string;
+    description?: string | null;
+}
+export interface OdbcQueryParameter {
+    name: string;
+    type: string;
+    default?: string | null;
+}
+export interface OdbcQueryMeta {
+    query_id: string;
+    query_name: string;
+    description?: string | null;
+    parameters?: OdbcQueryParameter[] | null;
+}
+export interface ScriptMeta {
+    script_id: number;
+    script_name: string;
+    description?: string | null;
+}
+/** Full script record (`GET /scripts/:id` → `script`) — the attributes dm pulls. */
+export interface ScriptDetail {
+    script_id: number;
+    script_name: string;
+    description?: string | null;
+    category?: string | null;
+    tags?: string[] | null;
+    is_active?: boolean;
+    timeout_seconds?: number;
+    max_memory_mb?: number;
+    priority?: number;
+    is_report_generator?: boolean;
+    report_type?: string | null;
+    generate_documents?: boolean;
+    output_format?: string | null;
+    title_jsonpath?: string | null;
+    summary_jsonpath?: string | null;
+    wait_for_generation?: boolean;
+}
+/** Script version row (`GET /scripts/:id/versions` → `versions`). */
+export interface ScriptVersionRow {
+    version_id: string;
+    version_number: number;
+    script_code: string;
+    change_description?: string | null;
+    is_current: boolean;
+}
+/** Outcome of `POST /scripts/:id/test-run` (engine waits for completion). */
+export interface ScriptTestRunResult {
+    execution_id: string;
+    completed: boolean;
+    execution?: {
+        status: string;
+        output_data?: unknown;
+        error_message?: string | null;
+        error_code?: string | null;
+        execution_time_ms?: number;
+        console_logs?: string[];
+    };
+}
+/** Metadata fields accepted by `PUT /scripts/:id` (code goes via a version). */
+export interface ScriptUpdateBody {
+    script_name?: string;
+    description?: string | null;
+    category?: string | null;
+    is_report_generator?: boolean;
+    report_type?: string | null;
+    tags?: string[];
+    timeout_seconds?: number;
+    max_memory_mb?: number;
+    priority?: number;
+    is_active?: boolean;
+}
+/** Fields accepted by `POST /scripts` (create). */
+export interface ScriptCreateBody {
+    script_name: string;
+    description?: string | null;
+    category?: string | null;
+    is_report_generator?: boolean;
+    report_type?: string | null;
+    tags?: string[];
+    timeout_seconds?: number;
+    max_memory_mb?: number;
+    priority?: number;
+}
+/** Full ODBC query record (`GET /odbc/queries/:id`). */
+export interface OdbcQueryDetail {
+    query_id: string;
+    query_name: string;
+    query_text: string;
+    description?: string | null;
+    parameters?: OdbcQueryParameter[] | null;
+    timeout_seconds?: number;
+    credential_id?: number | null;
+    credential_name?: string | null;
+}
+/** Body for `POST`/`PUT /odbc/queries`. */
+export interface OdbcQueryBody {
+    query_name: string;
+    query_text: string;
+    description: string;
+    parameters: OdbcQueryParameter[];
+    timeout_seconds: number;
+    credential_id?: number | null;
+}
+/** Outcome of `POST /odbc/test-run` (engine waits for the worker result). */
+export interface OdbcTestRunResult {
+    execution_id: string;
+    status: string;
+    duration_ms?: number;
+    row_count?: number;
+    rows?: Record<string, unknown>[];
+    columns?: string[];
+    error?: string;
+}
+/** Script authoring client used by `dm script`. */
+export interface PlatformScriptClient {
+    getScriptDetail(id: number): Promise<ScriptDetail>;
+    getScriptVersions(id: number): Promise<ScriptVersionRow[]>;
+    testRunScript(id: number, scriptCode: string, inputContext: Record<string, unknown>): Promise<ScriptTestRunResult>;
+    updateScript(id: number, body: ScriptUpdateBody): Promise<void>;
+    createScript(body: ScriptCreateBody): Promise<number>;
+    createScriptVersion(id: number, scriptCode: string, versionNotes?: string): Promise<void>;
+}
+/** ODBC/SQL query client used by `dm sql`. */
+export interface PlatformSqlClient {
+    listOdbcQueries(): Promise<OdbcQueryMeta[]>;
+    getOdbcQueryDetail(id: number): Promise<OdbcQueryDetail>;
+    createOdbcQuery(body: OdbcQueryBody): Promise<number>;
+    updateOdbcQuery(id: number, body: OdbcQueryBody): Promise<void>;
+    testRunOdbc(body: {
+        query_id?: string;
+        query_text: string;
+        credential_id: number;
+        parameters: Record<string, unknown>;
+        timeout_seconds: number;
+    }): Promise<OdbcTestRunResult>;
+}
+export interface SeriesMeta {
+    seriesId: string;
+    name: string;
+    formatString: string;
+    contextSchema?: unknown;
+}
+export interface PrinterMeta {
+    printerId: string;
+    name: string;
+    type: string;
+    protocol?: string;
+    dpi?: number;
+    isZplCompatible?: boolean;
+}
+/** Abstract metadata client — stubbed in tests. */
+export interface PlatformMetadataClient {
+    getLookupTable(id: number): Promise<LookupTableMeta>;
+    getOdbcQuery(id: number): Promise<OdbcQueryMeta>;
+    getScript(id: number): Promise<ScriptMeta>;
+    getSeries(id: number): Promise<SeriesMeta>;
+    listPrinters(): Promise<PrinterMeta[]>;
+}
+/**
+ * Resource-listing client used by `dm add` to browse a tenant's resources.
+ * Each method maps to a company-scoped `GET` list endpoint (verified against
+ * the Go handlers — see the file header).
+ */
+export interface PlatformListClient {
+    listLookupTables(): Promise<LookupTableListItem[]>;
+    listOdbcQueries(): Promise<OdbcQueryMeta[]>;
+    listScripts(): Promise<ScriptMeta[]>;
+    listSeries(): Promise<SeriesMeta[]>;
+    listPrinters(): Promise<PrinterMeta[]>;
+}
+export declare class PlatformApiError extends Error {
+    readonly status: number;
+    readonly path: string;
+    constructor(status: number, path: string, message: string);
+}
+export declare class PlatformClient implements PlatformMetadataClient, PlatformListClient, PlatformScriptClient, PlatformSqlClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly fetchImpl;
+    constructor(baseUrl: string, token: string, fetchImpl?: typeof fetch);
+    private getJson;
+    private sendJson;
+    getLookupTable(id: number): Promise<LookupTableMeta>;
+    getOdbcQuery(id: number): Promise<OdbcQueryMeta>;
+    getScript(id: number): Promise<ScriptMeta>;
+    getSeries(id: number): Promise<SeriesMeta>;
+    listPrinters(): Promise<PrinterMeta[]>;
+    listLookupTables(): Promise<LookupTableListItem[]>;
+    listOdbcQueries(): Promise<OdbcQueryMeta[]>;
+    listScripts(): Promise<ScriptMeta[]>;
+    listSeries(): Promise<SeriesMeta[]>;
+    getScriptDetail(id: number): Promise<ScriptDetail>;
+    getScriptVersions(id: number): Promise<ScriptVersionRow[]>;
+    testRunScript(id: number, scriptCode: string, inputContext: Record<string, unknown>): Promise<ScriptTestRunResult>;
+    updateScript(id: number, body: ScriptUpdateBody): Promise<void>;
+    createScript(body: ScriptCreateBody): Promise<number>;
+    createScriptVersion(id: number, scriptCode: string, versionNotes?: string): Promise<void>;
+    getOdbcQueryDetail(id: number): Promise<OdbcQueryDetail>;
+    createOdbcQuery(body: OdbcQueryBody): Promise<number>;
+    updateOdbcQuery(id: number, body: OdbcQueryBody): Promise<void>;
+    testRunOdbc(body: {
+        query_id?: string;
+        query_text: string;
+        credential_id: number;
+        parameters: Record<string, unknown>;
+        timeout_seconds: number;
+    }): Promise<OdbcTestRunResult>;
+}

package/dist/api.js

@@ -0,0 +1,200 @@
+/**
+ * Thin platform API client for the CLI (metadata fetch + publish).
+ *
+ * Endpoint paths and response field names verified against the Go handlers:
+ * - `GET /api/script-engine/lookup-tables/:id` → `{ success, table, data }`
+ *   (`internal/infrastructure/scriptEngineLookupHandlers.go:490`); the table's
+ *   `value_schema` is `[]SchemaField{ name, type, lookup_table_id?, description? }`
+ *   (`internal/models/script_engine_lookup.go:1151`).
+ * - `GET /api/odbc/queries/:id` → bare `ODBCQuery` object with
+ *   `parameters: [{ name, type, default }]` (`internal/infrastructure/odbcHandlers.go:91`,
+ *   `internal/models/odbc_query.go:17`). NOTE: the design doc said
+ *   `/api/sql/queries/:id`; the real route is `/api/odbc/queries/:id`
+ *   (`internal/infrastructure/scriptEngineRoutes.go:122`).
+ * - `GET /api/script-engine/scripts/:id` → `{ success, script }` with
+ *   `script.script_name` (`internal/infrastructure/scriptEngineHandlers.go:338`).
+ * - `GET /api/traceability/series/:id` → bare `TraceabilitySeries` (camelCase:
+ *   `name`, `formatString`, `contextSchema`; ids serialize as strings)
+ *   (`internal/infrastructure/traceabilityHandlers.go:211`,
+ *   `internal/models/manufacturing_printing.go:148`).
+ * - `GET /api/printers` → `{ printers: [...] }` (camelCase `Printer`,
+ *   `printerId` serialized as string) (`internal/infrastructure/connectorHandlers.go:704`).
+ */
+// ---------------------------------------------------------------------------
+// HTTP implementation
+// ---------------------------------------------------------------------------
+export class PlatformApiError extends Error {
+    status;
+    path;
+    constructor(status, path, message) {
+        super(`${path}: ${message} (HTTP ${status})`);
+        this.status = status;
+        this.path = path;
+        this.name = 'PlatformApiError';
+    }
+}
+export class PlatformClient {
+    baseUrl;
+    token;
+    fetchImpl;
+    constructor(baseUrl, token, fetchImpl = fetch) {
+        this.baseUrl = baseUrl;
+        this.token = token;
+        this.fetchImpl = fetchImpl;
+        this.baseUrl = baseUrl.replace(/\/$/, '');
+    }
+    async getJson(path) {
+        const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            headers: { Authorization: `Bearer ${this.token}`, Accept: 'application/json' },
+        });
+        if (!res.ok) {
+            let message = res.statusText || 'request failed';
+            try {
+                const body = (await res.json());
+                const m = body['error'] ?? body['message'];
+                if (typeof m === 'string')
+                    message = m;
+            }
+            catch {
+                /* non-JSON body */
+            }
+            throw new PlatformApiError(res.status, path, message);
+        }
+        return res.json();
+    }
+    async sendJson(method, path, body) {
+        const res = await this.fetchImpl(`${this.baseUrl}${path}`, {
+            method,
+            headers: {
+                Authorization: `Bearer ${this.token}`,
+                Accept: 'application/json',
+                'Content-Type': 'application/json',
+            },
+            body: JSON.stringify(body),
+        });
+        if (!res.ok) {
+            let message = res.statusText || 'request failed';
+            try {
+                const errBody = (await res.json());
+                const m = errBody['error'] ?? errBody['message'];
+                if (typeof m === 'string')
+                    message = m;
+            }
+            catch {
+                /* non-JSON body */
+            }
+            throw new PlatformApiError(res.status, path, message);
+        }
+        return res.json();
+    }
+    async getLookupTable(id) {
+        const body = (await this.getJson(`/api/script-engine/lookup-tables/${id}`));
+        if (!body.table) {
+            throw new PlatformApiError(200, `/api/script-engine/lookup-tables/${id}`, 'response missing "table"');
+        }
+        const table = body.table;
+        // value_schema is JSONB (json.RawMessage): may arrive as array, null, or string.
+        let schema = [];
+        const vs = table.value_schema;
+        if (Array.isArray(vs))
+            schema = vs;
+        else if (typeof vs === 'string' && vs.trim() !== '') {
+            try {
+                const parsed = JSON.parse(vs);
+                if (Array.isArray(parsed))
+                    schema = parsed;
+            }
+            catch {
+                /* leave empty */
+            }
+        }
+        return { ...table, value_schema: schema };
+    }
+    async getOdbcQuery(id) {
+        return (await this.getJson(`/api/odbc/queries/${id}`));
+    }
+    async getScript(id) {
+        const body = (await this.getJson(`/api/script-engine/scripts/${id}`));
+        if (!body.script) {
+            throw new PlatformApiError(200, `/api/script-engine/scripts/${id}`, 'response missing "script"');
+        }
+        return body.script;
+    }
+    async getSeries(id) {
+        return (await this.getJson(`/api/traceability/series/${id}`));
+    }
+    async listPrinters() {
+        const body = (await this.getJson('/api/printers'));
+        return Array.isArray(body.printers) ? body.printers : [];
+    }
+    // --- Resource listing (dm add) -------------------------------------------
+    async listLookupTables() {
+        const body = (await this.getJson('/api/script-engine/lookup-tables'));
+        return Array.isArray(body.tables) ? body.tables : [];
+    }
+    async listOdbcQueries() {
+        const body = (await this.getJson('/api/odbc/queries'));
+        return Array.isArray(body.queries) ? body.queries : [];
+    }
+    async listScripts() {
+        const body = (await this.getJson('/api/script-engine/scripts'));
+        return Array.isArray(body.scripts) ? body.scripts : [];
+    }
+    async listSeries() {
+        const body = (await this.getJson('/api/traceability/series'));
+        return Array.isArray(body.series) ? body.series : [];
+    }
+    // --- Script authoring (dm script) ----------------------------------------
+    async getScriptDetail(id) {
+        const body = (await this.getJson(`/api/script-engine/scripts/${id}`));
+        if (!body.script) {
+            throw new PlatformApiError(200, `/api/script-engine/scripts/${id}`, 'response missing "script"');
+        }
+        return body.script;
+    }
+    async getScriptVersions(id) {
+        const body = (await this.getJson(`/api/script-engine/scripts/${id}/versions`));
+        return Array.isArray(body.versions) ? body.versions : [];
+    }
+    async testRunScript(id, scriptCode, inputContext) {
+        return (await this.sendJson('POST', `/api/script-engine/scripts/${id}/test-run`, {
+            script_code: scriptCode,
+            input_context: inputContext,
+        }));
+    }
+    async updateScript(id, body) {
+        await this.sendJson('PUT', `/api/script-engine/scripts/${id}`, body);
+    }
+    async createScript(body) {
+        const res = (await this.sendJson('POST', '/api/script-engine/scripts', body));
+        if (typeof res.script_id !== 'number') {
+            throw new PlatformApiError(200, '/api/script-engine/scripts', 'response missing "script_id"');
+        }
+        return res.script_id;
+    }
+    async createScriptVersion(id, scriptCode, versionNotes) {
+        await this.sendJson('POST', `/api/script-engine/scripts/${id}/versions`, {
+            script_code: scriptCode,
+            version_notes: versionNotes ?? null,
+        });
+    }
+    // --- SQL/ODBC authoring (dm sql) -----------------------------------------
+    async getOdbcQueryDetail(id) {
+        return (await this.getJson(`/api/odbc/queries/${id}`));
+    }
+    async createOdbcQuery(body) {
+        const res = (await this.sendJson('POST', '/api/odbc/queries', body));
+        const id = Number(res.query_id);
+        if (!Number.isInteger(id) || id <= 0) {
+            throw new PlatformApiError(200, '/api/odbc/queries', 'response missing "query_id"');
+        }
+        return id;
+    }
+    async updateOdbcQuery(id, body) {
+        await this.sendJson('PUT', `/api/odbc/queries/${id}`, body);
+    }
+    async testRunOdbc(body) {
+        return (await this.sendJson('POST', '/api/odbc/test-run', body));
+    }
+}
+//# sourceMappingURL=api.js.map

package/dist/api.js.map

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