@loxtep/sdk 0.2.3 → 0.4.0

package/dist/codegen/emit.js

@@ -0,0 +1,158 @@
+/**
+ * Stage 3: Emit — render typed TypeScript source from NormalizedContext.
+ *
+ * This pure function transforms a `NormalizedContext` into a string of TypeScript
+ * source code containing typed `as const` constants and a `workspace` namespace
+ * that aggregates all resource collections.
+ *
+ * Requirements: R2.1, R2.2, R2.3, R2.4, R2.5
+ *
+ * @module codegen/emit
+ */
+/**
+ * Computes a deterministic SHA-256-like hash of the normalized context for cache
+ * invalidation (R12.4). Uses a simple djb2-based hash over the JSON-serialized
+ * context to produce a stable hex string.
+ */
+function computeContextHash(norm) {
+    const serialized = JSON.stringify(norm);
+    let hash = 5381;
+    for (let i = 0; i < serialized.length; i++) {
+        hash = ((hash << 5) + hash + serialized.charCodeAt(i)) | 0;
+    }
+    // Convert to unsigned 32-bit hex
+    return (hash >>> 0).toString(16).padStart(8, '0');
+}
+/**
+ * Serializes a JavaScript value to a TypeScript literal string.
+ * Handles strings, numbers, booleans, null, arrays, and plain objects.
+ */
+function toLiteral(value, indent) {
+    const pad = '  '.repeat(indent);
+    const innerPad = '  '.repeat(indent + 1);
+    if (value === null) {
+        return 'null';
+    }
+    if (typeof value === 'string') {
+        return JSON.stringify(value);
+    }
+    if (typeof value === 'number' || typeof value === 'boolean') {
+        return String(value);
+    }
+    if (Array.isArray(value)) {
+        if (value.length === 0) {
+            return '[]';
+        }
+        const items = value.map((item) => `${innerPad}${toLiteral(item, indent + 1)}`);
+        return `[\n${items.join(',\n')}\n${pad}]`;
+    }
+    if (typeof value === 'object') {
+        const entries = Object.entries(value);
+        if (entries.length === 0) {
+            return '{}';
+        }
+        const props = entries.map(([key, val]) => `${innerPad}${safeKey(key)}: ${toLiteral(val, indent + 1)}`);
+        return `{\n${props.join(',\n')}\n${pad}}`;
+    }
+    return 'undefined';
+}
+/**
+ * Returns a safe object key — quoted if not a valid identifier, bare otherwise.
+ */
+function safeKey(key) {
+    if (/^[a-zA-Z_$][a-zA-Z0-9_$]*$/.test(key)) {
+        return key;
+    }
+    return JSON.stringify(key);
+}
+/**
+ * Emits a single resource entry as a TypeScript object literal line.
+ */
+function emitResourceEntry(key, fields) {
+    const props = Object.entries(fields)
+        .map(([k, v]) => `${safeKey(k)}: ${toLiteral(v, 2)}`)
+        .join(', ');
+    return `  ${safeKey(key)}: { ${props} }`;
+}
+/**
+ * Emits a resource collection as a typed `as const` export.
+ * Returns an empty object `{}` when the collection has no entries.
+ */
+function emitCollection(name, resources, fieldExtractor) {
+    if (resources.length === 0) {
+        return `export const ${name} = {} as const;`;
+    }
+    const entries = resources.map((r) => {
+        const fields = fieldExtractor(r.data);
+        return emitResourceEntry(r.key, fields);
+    });
+    return `export const ${name} = {\n${entries.join(',\n')},\n} as const;`;
+}
+/**
+ * Renders a `NormalizedContext` into a complete TypeScript source string.
+ *
+ * The output includes:
+ * - A header comment with an auto-generated notice and context hash (R12.4)
+ * - Per-resource-type `as const` exports with required fields (R2.1–R2.4)
+ * - A `workspace` namespace aggregating all collections (R2.5)
+ * - Empty objects for empty collections in the workspace namespace (R2.5)
+ *
+ * This is a pure function: same input always produces the same output (R2.6).
+ */
+export function emitArtifact(norm) {
+    const hash = computeContextHash(norm);
+    const header = [
+        `// .loxtep/generated/index.ts  (AUTO-GENERATED — do not edit)`,
+        `// Context hash: ${hash}`,
+        '',
+    ].join('\n');
+    const dataProductsBlock = emitCollection('dataProducts', norm.dataProducts, (dp) => ({
+        name: dp.name,
+        id: dp.id,
+        domain: dp.domain,
+        schema: dp.schema,
+    }));
+    const connectorsBlock = emitCollection('connectors', norm.connectors, (c) => ({
+        name: c.name,
+        type: c.type,
+        id: c.id,
+        connection_id: c.connection_id,
+    }));
+    const domainsBlock = emitCollection('domains', norm.domains, (d) => ({
+        name: d.name,
+        id: d.id,
+        data_product_ids: d.data_product_ids,
+    }));
+    const queuesBlock = emitCollection('queues', norm.queues, (q) => ({
+        name: q.name,
+        id: q.id,
+    }));
+    const flowsBlock = emitCollection('flows', norm.flows, (f) => ({
+        name: f.name,
+        id: f.id,
+    }));
+    const workflowsBlock = emitCollection('workflows', norm.workflows, (w) => ({
+        name: w.name,
+        id: w.id,
+    }));
+    const workspaceExport = 'export const workspace = { dataProducts, connectors, domains, queues, flows, workflows } as const;';
+    const parts = [
+        header,
+        dataProductsBlock,
+        '',
+        connectorsBlock,
+        '',
+        domainsBlock,
+        '',
+        queuesBlock,
+        '',
+        flowsBlock,
+        '',
+        workflowsBlock,
+        '',
+        workspaceExport,
+        '',
+    ];
+    return parts.join('\n');
+}
+//# sourceMappingURL=emit.js.map

package/dist/codegen/emit.js.map

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

package/dist/codegen/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Codegen module — typed Workspace Context generation pipeline.
+ *
+ * The pipeline has four stages:
+ * 1. load (I/O) — fetch resources from the control plane
+ * 2. normalize (pure) — deterministic key derivation + canonical ordering
+ * 3. emit (pure) — render typed TypeScript source
+ * 4. write (I/O) — atomic file write
+ *
+ * @module codegen
+ */
+export type { JsonSchema, WorkspaceContext, NormalizedContext, NormalizedResource, GenerateCounts, } from './types.js';
+export { loadWorkspaceContext } from './load-workspace-context.js';
+export { deriveKey, normalizeContext } from './normalize.js';
+export { emitArtifact } from './emit.js';
+export { writeArtifact, computeCounts } from './write-artifact.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/codegen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,cAAc,GACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/codegen/index.js

@@ -0,0 +1,16 @@
+/**
+ * Codegen module — typed Workspace Context generation pipeline.
+ *
+ * The pipeline has four stages:
+ * 1. load (I/O) — fetch resources from the control plane
+ * 2. normalize (pure) — deterministic key derivation + canonical ordering
+ * 3. emit (pure) — render typed TypeScript source
+ * 4. write (I/O) — atomic file write
+ *
+ * @module codegen
+ */
+export { loadWorkspaceContext } from './load-workspace-context.js';
+export { deriveKey, normalizeContext } from './normalize.js';
+export { emitArtifact } from './emit.js';
+export { writeArtifact, computeCounts } from './write-artifact.js';
+//# sourceMappingURL=index.js.map

package/dist/codegen/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/codegen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/codegen/load-workspace-context.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Stage 1 (I/O): Load the raw WorkspaceContext from the control plane.
+ *
+ * Queries the Loxtep API via LoxtepClient namespaces scoped to the project_id:
+ * - data_products (org-level, all available to the project)
+ * - connectors (org-level)
+ * - domains (org-level, with associated data product ids)
+ * - queues (instance-level, from observe)
+ * - flows (project-scoped)
+ * - workflows (project-scoped)
+ *
+ * @module codegen/load-workspace-context
+ */
+import type { LoxtepClient } from '../client/loxtep-client.js';
+import type { WorkspaceContext } from './types.js';
+/**
+ * Fetch all workspace resources from the control plane and assemble them into
+ * a WorkspaceContext. The client must be configured with a valid project_id.
+ *
+ * All list calls use large page sizes to fetch the complete resource set.
+ * Pagination is handled by fetching the maximum page size; projects with
+ * extremely large resource counts may need future iteration.
+ *
+ * @param client - An authenticated LoxtepClient instance
+ * @param projectId - The project to scope the context to
+ * @returns The assembled WorkspaceContext with all resource collections
+ * @throws If any control-plane query fails (caller should handle R2.8)
+ */
+export declare function loadWorkspaceContext(client: LoxtepClient, projectId: string): Promise<WorkspaceContext>;
+//# sourceMappingURL=load-workspace-context.d.ts.map

package/dist/codegen/load-workspace-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-workspace-context.d.ts","sourceRoot":"","sources":["../../src/codegen/load-workspace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD;;;;;;;;;;;;GAYG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,gBAAgB,CAAC,CAmF3B"}

package/dist/codegen/load-workspace-context.js

@@ -0,0 +1,127 @@
+/**
+ * Stage 1 (I/O): Load the raw WorkspaceContext from the control plane.
+ *
+ * Queries the Loxtep API via LoxtepClient namespaces scoped to the project_id:
+ * - data_products (org-level, all available to the project)
+ * - connectors (org-level)
+ * - domains (org-level, with associated data product ids)
+ * - queues (instance-level, from observe)
+ * - flows (project-scoped)
+ * - workflows (project-scoped)
+ *
+ * @module codegen/load-workspace-context
+ */
+/**
+ * Fetch all workspace resources from the control plane and assemble them into
+ * a WorkspaceContext. The client must be configured with a valid project_id.
+ *
+ * All list calls use large page sizes to fetch the complete resource set.
+ * Pagination is handled by fetching the maximum page size; projects with
+ * extremely large resource counts may need future iteration.
+ *
+ * @param client - An authenticated LoxtepClient instance
+ * @param projectId - The project to scope the context to
+ * @returns The assembled WorkspaceContext with all resource collections
+ * @throws If any control-plane query fails (caller should handle R2.8)
+ */
+export async function loadWorkspaceContext(client, projectId) {
+    // Fetch all resource types concurrently for performance.
+    // Project-scoped resources (flows, workflows) use projectId directly.
+    // Org-scoped resources (data products, connectors, domains) fetch all available.
+    const [dataProductsResult, connectorsResult, domainsResult, flowsResult, workflowsResult,] = await Promise.all([
+        client.data_products.list({ page: 1, page_size: 1000 }),
+        client.connectors.list({ page: 1, page_size: 1000 }),
+        client.domains.list({ page: 1, page_size: 1000 }),
+        client.flows.list({ project_id: projectId, page: 1, page_size: 1000 }),
+        client.workflows.listWorkflows({ project_id: projectId, page: 1, page_size: 1000 }),
+    ]);
+    // Fetch queues from the observe endpoint (instance-level).
+    // The observe.status() returns bot/queue info for the configured instance.
+    let queuesRaw = [];
+    try {
+        const observeData = await client.observe.status();
+        queuesRaw = extractQueuesFromObserve(observeData);
+    }
+    catch {
+        // If observe is not available (e.g. no instance configured), queues will be empty.
+        // This is acceptable — queues are instance-level and may not be reachable during
+        // initial setup.
+        queuesRaw = [];
+    }
+    // Map data products to workspace context shape
+    const dataProducts = (dataProductsResult?.items ?? []).map(dp => ({
+        name: dp.name,
+        id: dp.data_product_id,
+        domain: dp.domain_id ?? null,
+        schema: dp.schema ?? null,
+    }));
+    // Map connectors to workspace context shape
+    const connectors = (connectorsResult?.items ?? []).map(c => ({
+        type: c.connector_type,
+        id: c.connector_id,
+        connection_id: null, // Connectors at org-level don't have a project connection_id
+        name: c.metadata?.name ?? c.connector_type,
+    }));
+    // Map domains to workspace context shape
+    const domainsItems = domainsResult?.items ?? [];
+    const domains = domainsItems.map(d => ({
+        name: d.name,
+        id: d.domain_id,
+        data_product_ids: dataProducts
+            .filter(dp => dp.domain === d.domain_id)
+            .map(dp => dp.id),
+    }));
+    // Map flows to workspace context shape
+    const flowItems = flowsResult?.items ?? [];
+    const flows = flowItems.map(f => ({
+        name: f.name,
+        id: f.workflow_id,
+    }));
+    // Map workflows to workspace context shape
+    const workflowItems = workflowsResult?.items ?? [];
+    const workflows = workflowItems.map(w => ({
+        name: w.name,
+        id: w.workflow_id,
+    }));
+    return {
+        dataProducts,
+        connectors,
+        domains,
+        queues: queuesRaw,
+        flows,
+        workflows,
+    };
+}
+/**
+ * Extract queue names and ids from the observe status response.
+ * The observe endpoint returns various shapes; we extract queue-like entries
+ * that have a name/queue_name and an identifier.
+ */
+function extractQueuesFromObserve(observeData) {
+    if (!observeData || typeof observeData !== 'object')
+        return [];
+    const data = observeData;
+    // Try to extract queues from common observe response shapes
+    const queuesArray = data.queues ??
+        data.data?.queues ??
+        [];
+    if (!Array.isArray(queuesArray))
+        return [];
+    const result = [];
+    for (const q of queuesArray) {
+        if (!q || typeof q !== 'object')
+            continue;
+        const entry = q;
+        const name = entry.queue_name ??
+            entry.name ??
+            '';
+        const id = entry.queue_id ??
+            entry.id ??
+            '';
+        if (name) {
+            result.push({ name, id: id || name });
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=load-workspace-context.js.map

package/dist/codegen/load-workspace-context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"load-workspace-context.js","sourceRoot":"","sources":["../../src/codegen/load-workspace-context.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAoB,EACpB,SAAiB;IAEjB,yDAAyD;IACzD,sEAAsE;IACtE,iFAAiF;IACjF,MAAM,CACJ,kBAAkB,EAClB,gBAAgB,EAChB,aAAa,EACb,WAAW,EACX,eAAe,EAChB,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpB,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACvD,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACpD,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACjD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;QACtE,MAAM,CAAC,SAAS,CAAC,aAAa,CAAC,EAAE,UAAU,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;KACpF,CAAC,CAAC;IAEH,2DAA2D;IAC3D,2EAA2E;IAC3E,IAAI,SAAS,GAAwC,EAAE,CAAC;IACxD,IAAI,CAAC;QACH,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QAClD,SAAS,GAAG,wBAAwB,CAAC,WAAW,CAAC,CAAC;IACpD,CAAC;IAAC,MAAM,CAAC;QACP,mFAAmF;QACnF,iFAAiF;QACjF,iBAAiB;QACjB,SAAS,GAAG,EAAE,CAAC;IACjB,CAAC;IAED,+CAA+C;IAC/C,MAAM,YAAY,GAAqC,CACrD,kBAAkB,EAAE,KAAK,IAAI,EAAE,CAChC,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;QACX,IAAI,EAAE,EAAE,CAAC,IAAI;QACb,EAAE,EAAE,EAAE,CAAC,eAAe;QACtB,MAAM,EAAE,EAAE,CAAC,SAAS,IAAI,IAAI;QAC5B,MAAM,EAAG,EAAE,CAAC,MAA6D,IAAI,IAAI;KAClF,CAAC,CAAC,CAAC;IAEJ,4CAA4C;IAC5C,MAAM,UAAU,GAAmC,CACjD,gBAAgB,EAAE,KAAK,IAAI,EAAE,CAC9B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACV,IAAI,EAAE,CAAC,CAAC,cAAc;QACtB,EAAE,EAAE,CAAC,CAAC,YAAY;QAClB,aAAa,EAAE,IAAI,EAAE,6DAA6D;QAClF,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,IAAc,IAAI,CAAC,CAAC,cAAc;KACrD,CAAC,CAAC,CAAC;IAEJ,yCAAyC;IACzC,MAAM,YAAY,GAAG,aAAa,EAAE,KAAK,IAAI,EAAE,CAAC;IAChD,MAAM,OAAO,GAAgC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAClE,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,EAAE,EAAE,CAAC,CAAC,SAAS;QACf,gBAAgB,EAAE,YAAY;aAC3B,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,MAAM,KAAK,CAAC,CAAC,SAAS,CAAC;aACvC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;KACpB,CAAC,CAAC,CAAC;IAEJ,uCAAuC;IACvC,MAAM,SAAS,GAAG,WAAW,EAAE,KAAK,IAAI,EAAE,CAAC;IAC3C,MAAM,KAAK,GAA8B,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QAC3D,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,EAAE,EAAE,CAAC,CAAC,WAAW;KAClB,CAAC,CAAC,CAAC;IAEJ,2CAA2C;IAC3C,MAAM,aAAa,GAAG,eAAe,EAAE,KAAK,IAAI,EAAE,CAAC;IACnD,MAAM,SAAS,GAAkC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACvE,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,EAAE,EAAE,CAAC,CAAC,WAAW;KAClB,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,YAAY;QACZ,UAAU;QACV,OAAO;QACP,MAAM,EAAE,SAAS;QACjB,KAAK;QACL,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,SAAS,wBAAwB,CAC/B,WAAoB;IAEpB,IAAI,CAAC,WAAW,IAAI,OAAO,WAAW,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IAE/D,MAAM,IAAI,GAAG,WAAsC,CAAC;IAEpD,4DAA4D;IAC5D,MAAM,WAAW,GACd,IAAI,CAAC,MAAoB;QACxB,IAA0C,CAAC,IAAI,EAAE,MAAoB;QACvE,EAAE,CAAC;IAEL,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC;QAAE,OAAO,EAAE,CAAC;IAE3C,MAAM,MAAM,GAAwC,EAAE,CAAC;IACvD,KAAK,MAAM,CAAC,IAAI,WAAW,EAAE,CAAC;QAC5B,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,SAAS;QAC1C,MAAM,KAAK,GAAG,CAA4B,CAAC;QAC3C,MAAM,IAAI,GACP,KAAK,CAAC,UAAqB;YAC3B,KAAK,CAAC,IAAe;YACtB,EAAE,CAAC;QACL,MAAM,EAAE,GACL,KAAK,CAAC,QAAmB;YACzB,KAAK,CAAC,EAAa;YACpB,EAAE,CAAC;QACL,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACxC,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/codegen/normalize.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Stage 2: Normalize — deterministic key derivation + canonical ordering.
+ *
+ * This pure function transforms a raw `WorkspaceContext` into a `NormalizedContext`
+ * with stable, deterministic keys and canonical id-sorted ordering, ensuring
+ * byte-identical output for unchanged contexts (R2.6).
+ *
+ * @module codegen/normalize
+ */
+import type { WorkspaceContext, NormalizedContext } from './types.js';
+/**
+ * Derives a deterministic, valid TypeScript identifier key from a resource name.
+ *
+ * Rules:
+ * 1. Lowercase the name
+ * 2. Replace any run of non-alphanumeric characters with a single `_`
+ * 3. Trim leading/trailing `_`
+ * 4. If result is empty or starts with a digit, prefix with `_`
+ *
+ * Collision resolution is handled separately in `normalizeCollection`.
+ */
+export declare function deriveKey(name: string): string;
+/**
+ * Normalizes the entire workspace context.
+ *
+ * Transforms raw `WorkspaceContext` into `NormalizedContext` by:
+ * - Sorting each resource collection by id (ascending) for canonical ordering
+ * - Deriving deterministic keys from resource names
+ * - Resolving key collisions with `_2`, `_3`, … suffixes in id-sorted order
+ *
+ * This is a pure function: given the same input, it always produces the same output,
+ * guaranteeing byte-identical artifacts for unchanged contexts (R2.6).
+ */
+export declare function normalizeContext(ctx: WorkspaceContext): NormalizedContext;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/codegen/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../src/codegen/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAAsB,MAAM,YAAY,CAAC;AAE1F;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAgB9C;AAgCD;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,gBAAgB,GAAG,iBAAiB,CASzE"}

package/dist/codegen/normalize.js

@@ -0,0 +1,77 @@
+/**
+ * Stage 2: Normalize — deterministic key derivation + canonical ordering.
+ *
+ * This pure function transforms a raw `WorkspaceContext` into a `NormalizedContext`
+ * with stable, deterministic keys and canonical id-sorted ordering, ensuring
+ * byte-identical output for unchanged contexts (R2.6).
+ *
+ * @module codegen/normalize
+ */
+/**
+ * Derives a deterministic, valid TypeScript identifier key from a resource name.
+ *
+ * Rules:
+ * 1. Lowercase the name
+ * 2. Replace any run of non-alphanumeric characters with a single `_`
+ * 3. Trim leading/trailing `_`
+ * 4. If result is empty or starts with a digit, prefix with `_`
+ *
+ * Collision resolution is handled separately in `normalizeCollection`.
+ */
+export function deriveKey(name) {
+    // Step 1: lowercase
+    let key = name.toLowerCase();
+    // Step 2: replace any run of non-alphanumeric characters with a single `_`
+    key = key.replace(/[^a-z0-9]+/g, '_');
+    // Step 3: trim leading/trailing `_`
+    key = key.replace(/^_+|_+$/g, '');
+    // Step 4: if empty or starts with a digit, prefix with `_`
+    if (key === '' || /^[0-9]/.test(key)) {
+        key = '_' + key;
+    }
+    return key;
+}
+/**
+ * Normalizes a single resource collection:
+ * - Sorts resources by `id` in ascending lexicographic order (canonical ordering)
+ * - Derives a key from each resource's `name`
+ * - Resolves collisions by appending `_2`, `_3`, etc. in id-sorted order
+ *   (the first resource in id order keeps the base key, subsequent collisions get suffixes)
+ */
+function normalizeCollection(resources) {
+    // Sort by id ascending for canonical ordering
+    const sorted = [...resources].sort((a, b) => a.id.localeCompare(b.id));
+    // Group by derived base key to detect collisions
+    const keyGroups = new Map();
+    return sorted.map((resource) => {
+        const baseKey = deriveKey(resource.name);
+        // Track how many times we've seen this base key
+        const count = keyGroups.get(baseKey) ?? 0;
+        keyGroups.set(baseKey, count + 1);
+        // First occurrence keeps the base key; subsequent get _2, _3, etc.
+        const key = count === 0 ? baseKey : `${baseKey}_${count + 1}`;
+        return { key, data: resource };
+    });
+}
+/**
+ * Normalizes the entire workspace context.
+ *
+ * Transforms raw `WorkspaceContext` into `NormalizedContext` by:
+ * - Sorting each resource collection by id (ascending) for canonical ordering
+ * - Deriving deterministic keys from resource names
+ * - Resolving key collisions with `_2`, `_3`, … suffixes in id-sorted order
+ *
+ * This is a pure function: given the same input, it always produces the same output,
+ * guaranteeing byte-identical artifacts for unchanged contexts (R2.6).
+ */
+export function normalizeContext(ctx) {
+    return {
+        dataProducts: normalizeCollection(ctx.dataProducts),
+        connectors: normalizeCollection(ctx.connectors),
+        domains: normalizeCollection(ctx.domains),
+        queues: normalizeCollection(ctx.queues),
+        flows: normalizeCollection(ctx.flows),
+        workflows: normalizeCollection(ctx.workflows),
+    };
+}
+//# sourceMappingURL=normalize.js.map

package/dist/codegen/normalize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../src/codegen/normalize.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;;GAUG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,oBAAoB;IACpB,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAE7B,2EAA2E;IAC3E,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAEtC,oCAAoC;IACpC,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAElC,2DAA2D;IAC3D,IAAI,GAAG,KAAK,EAAE,IAAI,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QACrC,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;;GAMG;AACH,SAAS,mBAAmB,CAC1B,SAAc;IAEd,8CAA8C;IAC9C,MAAM,MAAM,GAAG,CAAC,GAAG,SAAS,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAEvE,iDAAiD;IACjD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE;QAC7B,MAAM,OAAO,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAEzC,gDAAgD;QAChD,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1C,SAAS,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QAElC,mEAAmE;QACnE,MAAM,GAAG,GAAG,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAE9D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAAqB;IACpD,OAAO;QACL,YAAY,EAAE,mBAAmB,CAAC,GAAG,CAAC,YAAY,CAAC;QACnD,UAAU,EAAE,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC;QAC/C,OAAO,EAAE,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC;QACzC,MAAM,EAAE,mBAAmB,CAAC,GAAG,CAAC,MAAM,CAAC;QACvC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,KAAK,CAAC;QACrC,SAAS,EAAE,mBAAmB,CAAC,GAAG,CAAC,SAAS,CAAC;KAC9C,CAAC;AACJ,CAAC"}

package/dist/codegen/types.d.ts

@@ -0,0 +1,89 @@
+/**
+ * Codegen types for the typed Workspace Context generation pipeline.
+ *
+ * The codegen pipeline compiles the connected Loxtep resources into a single
+ * typed SDK artifact at `.loxtep/generated/index.ts`. These types define the
+ * intermediate representations used across the pipeline stages.
+ */
+/**
+ * A JSON Schema representation. Matches the standard JSON Schema shape used
+ * across the Loxtep platform for data product schemas.
+ */
+export interface JsonSchema {
+    type?: string;
+    properties?: Record<string, JsonSchema>;
+    items?: JsonSchema;
+    required?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Raw workspace context fetched from the control plane.
+ * Each resource collection contains the minimal fields needed for typed codegen.
+ * This is the output of Stage 1 (I/O load) and input to Stage 2 (normalize).
+ */
+export interface WorkspaceContext {
+    dataProducts: {
+        name: string;
+        id: string;
+        domain: string | null;
+        schema: JsonSchema | null;
+    }[];
+    connectors: {
+        type: string;
+        id: string;
+        connection_id: string | null;
+        name: string;
+    }[];
+    domains: {
+        name: string;
+        id: string;
+        data_product_ids: string[];
+    }[];
+    queues: {
+        name: string;
+        id: string;
+    }[];
+    flows: {
+        name: string;
+        id: string;
+    }[];
+    workflows: {
+        name: string;
+        id: string;
+    }[];
+}
+/**
+ * A single normalized resource entry after deterministic key derivation.
+ * The `key` is the stable namespace accessor (e.g. `shopify_gql_customer`).
+ */
+export interface NormalizedResource<T> {
+    key: string;
+    data: T;
+}
+/**
+ * Normalized context after Stage 2 processing.
+ * Resources are sorted by id in ascending order with deterministic keys derived
+ * from resource names. This guarantees byte-identical output for unchanged contexts.
+ */
+export interface NormalizedContext {
+    dataProducts: NormalizedResource<WorkspaceContext['dataProducts'][number]>[];
+    connectors: NormalizedResource<WorkspaceContext['connectors'][number]>[];
+    domains: NormalizedResource<WorkspaceContext['domains'][number]>[];
+    queues: NormalizedResource<WorkspaceContext['queues'][number]>[];
+    flows: NormalizedResource<WorkspaceContext['flows'][number]>[];
+    workflows: NormalizedResource<WorkspaceContext['workflows'][number]>[];
+}
+/**
+ * Per-resource-type counts reported after artifact generation.
+ * Each field reports the number of typed constants written for that resource type.
+ * Reports 0 for resource types with no resources (R2.7).
+ */
+export interface GenerateCounts {
+    dataProducts: number;
+    connectors: number;
+    domains: number;
+    queues: number;
+    flows: number;
+    workflows: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/codegen/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/codegen/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACxC,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,gBAAgB;IAC/B,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;QACtB,MAAM,EAAE,UAAU,GAAG,IAAI,CAAC;KAC3B,EAAE,CAAC;IACJ,UAAU,EAAE;QACV,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAC7B,IAAI,EAAE,MAAM,CAAC;KACd,EAAE,CAAC;IACJ,OAAO,EAAE;QACP,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;QACX,gBAAgB,EAAE,MAAM,EAAE,CAAC;KAC5B,EAAE,CAAC;IACJ,MAAM,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;IACJ,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;IACJ,SAAS,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,EAAE,EAAE,MAAM,CAAC;KACZ,EAAE,CAAC;CACL;AAED;;;GAGG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,CAAC,CAAC;CACT;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,YAAY,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAC7E,UAAU,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACzE,OAAO,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACnE,MAAM,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IACjE,KAAK,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;IAC/D,SAAS,EAAE,kBAAkB,CAAC,gBAAgB,CAAC,WAAW,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;CACxE;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/codegen/types.js

@@ -0,0 +1,9 @@
+/**
+ * Codegen types for the typed Workspace Context generation pipeline.
+ *
+ * The codegen pipeline compiles the connected Loxtep resources into a single
+ * typed SDK artifact at `.loxtep/generated/index.ts`. These types define the
+ * intermediate representations used across the pipeline stages.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/codegen/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/codegen/types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/codegen/write-artifact.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Stage 4: Write — atomic file overwrite returning per-type counts.
+ *
+ * This I/O stage takes the emitted TypeScript source string and writes it
+ * atomically to the target path. "Atomic" means: write to a temporary file
+ * in the same directory, then rename over the target. If the process crashes
+ * or the write fails at any point, the prior artifact remains unchanged (R2.8).
+ *
+ * The function also computes and returns per-resource-type counts from the
+ * provided NormalizedContext so the CLI can print them (R2.7).
+ *
+ * Requirements: R2.6, R2.7, R2.8
+ *
+ * @module codegen/write-artifact
+ */
+import type { NormalizedContext, GenerateCounts } from './types.js';
+/**
+ * Computes per-resource-type counts from a NormalizedContext.
+ * Returns 0 for each resource type that has no resources (R2.7).
+ */
+export declare function computeCounts(norm: NormalizedContext): GenerateCounts;
+/**
+ * Writes the generated artifact source to disk atomically and returns per-type counts.
+ *
+ * Atomicity strategy:
+ * 1. Ensure the target directory exists.
+ * 2. Write the full source to a temporary file in the same directory (same filesystem).
+ * 3. Rename the temporary file over the target path (atomic on POSIX filesystems).
+ *
+ * If any step fails, the temporary file is cleaned up (best-effort) and the
+ * prior artifact at `targetPath` remains unchanged (R2.8). The error is re-thrown
+ * so the caller can handle it (e.g. exit non-zero, print the failure reason).
+ *
+ * @param targetPath - Absolute or relative path to the generated artifact file.
+ * @param source - The TypeScript source string produced by `emitArtifact`.
+ * @param norm - The NormalizedContext used to compute resource counts.
+ * @returns Per-resource-type counts written to the artifact (R2.7).
+ */
+export declare function writeArtifact(targetPath: string, source: string, norm: NormalizedContext): Promise<GenerateCounts>;
+//# sourceMappingURL=write-artifact.d.ts.map

package/dist/codegen/write-artifact.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-artifact.d.ts","sourceRoot":"","sources":["../../src/codegen/write-artifact.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEpE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,cAAc,CASrE;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,cAAc,CAAC,CAyBzB"}