@loxtep/sdk 0.7.22 → 0.7.26

package/dist/lib/entity-json-schemas/validate-entity.js.map

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

package/dist/lib/sdk-ingest-bundle.d.ts

@@ -1,7 +1,11 @@
 /**
- * Build SDK ingest workflow bundle files (connector + connection + source data product).
+ * Build local-first SDK ingest workflow package files
+ * (connector + workflow + connection + source data product).
  */
-export interface SdkIngestBundleParams {
+import type { Connector } from '../client/connectors-types.js';
+/** Placeholder starter template id for SDK-provisioned ingestion flows. */
+export declare const SDK_INGEST_TEMPLATE_ID = "00000000-0000-4000-8000-0000000000a1";
+export interface SdkIngestPackageParams {
     organization_id: string;
     project_id: string;
     domain_id: string;
@@ -12,13 +16,67 @@ export interface SdkIngestBundleParams {
     workflow_id?: string;
     connection_id?: string;
     data_product_id?: string;
+    /** When set, include a schema-valid local connector file. */
+    connector?: Connector | LocalConnectorStub;
+    include_connector_file?: boolean;
+    /** When true, set storage.iceberg_enabled on the source data product. */
+    iceberg_enabled?: boolean;
 }
-export interface SdkIngestBundleResult {
+export interface LocalConnectorStub {
+    connector_id: string;
+    organization_id: string;
+    connector_type: string;
+    metadata?: Record<string, unknown>;
+    created_at?: string;
+    updated_at?: string;
+}
+export interface SdkIngestPackageResult {
     workflow_id: string;
     connection_id: string;
     data_product_id: string;
     data_product_name: string;
+    connector_id: string;
+    /** Project-relative path → entity JSON */
     files: Record<string, Record<string, unknown>>;
 }
-export declare function buildSdkIngestBundle(params: SdkIngestBundleParams): SdkIngestBundleResult;
+/**
+ * Map an API connector (or stub) into a schema-valid local connector entity.
+ * Entity schema uses catalog-style fields (name, category, auth_type) that differ
+ * from the connectors API shape.
+ */
+export declare function toLocalConnectorEntity(connector: Connector | LocalConnectorStub, now?: string): Record<string, unknown>;
+/**
+ * Build project-local JSON files for an SDK ingest topology.
+ * Paths match the customer workspace layout (not the flat save_workflow_bundle map).
+ */
+export declare function buildSdkIngestLocalPackage(params: SdkIngestPackageParams): SdkIngestPackageResult;
+/**
+ * Flat bundle map for `save_workflow_bundle` / `bundle save` (workflow-relative keys).
+ */
+export declare function buildSdkIngestBundle(params: {
+    organization_id: string;
+    project_id: string;
+    domain_id: string;
+    connector_id: string;
+    data_product_name: string;
+    workflow_name?: string;
+    user_id?: string;
+    workflow_id?: string;
+    connection_id?: string;
+    data_product_id?: string;
+}): {
+    workflow_id: string;
+    connection_id: string;
+    data_product_id: string;
+    data_product_name: string;
+    files: Record<string, Record<string, unknown>>;
+};
+export type SdkIngestBundleParams = Parameters<typeof buildSdkIngestBundle>[0];
+export type SdkIngestBundleResult = ReturnType<typeof buildSdkIngestBundle>;
+/** Validate every entity in a local package map; returns field-level errors. */
+export declare function validateSdkIngestPackageFiles(files: Record<string, Record<string, unknown>>): Array<{
+    path: string;
+    entity_type: string;
+    message: string;
+}>;
 //# sourceMappingURL=sdk-ingest-bundle.d.ts.map

package/dist/lib/sdk-ingest-bundle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-ingest-bundle.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-ingest-bundle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CAChD;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,qBAAqB,GAAG,qBAAqB,CAqEzF"}
+{"version":3,"file":"sdk-ingest-bundle.d.ts","sourceRoot":"","sources":["../../src/lib/sdk-ingest-bundle.ts"],"names":[],"mappings":"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"}

package/dist/lib/sdk-ingest-bundle.js

@@ -1,73 +1,169 @@
 /**
- * Build SDK ingest workflow bundle files (connector + connection + source data product).
+ * Build local-first SDK ingest workflow package files
+ * (connector + workflow + connection + source data product).
  */
 import { randomUUID } from 'node:crypto';
-export function buildSdkIngestBundle(params) {
+import { EntityType, validateEntity } from './entity-json-schemas/index.js';
+/** Placeholder starter template id for SDK-provisioned ingestion flows. */
+export const SDK_INGEST_TEMPLATE_ID = '00000000-0000-4000-8000-0000000000a1';
+/**
+ * Map an API connector (or stub) into a schema-valid local connector entity.
+ * Entity schema uses catalog-style fields (name, category, auth_type) that differ
+ * from the connectors API shape.
+ */
+export function toLocalConnectorEntity(connector, now = new Date().toISOString()) {
+    const meta = connector.metadata ?? {};
+    const name = (typeof meta.name === 'string' && meta.name.trim()) ||
+        `${connector.connector_type} connector`;
+    const description = (typeof meta.description === 'string' && meta.description.trim()) ||
+        `Local stub for ${connector.connector_type} connector`;
+    return {
+        connector_id: connector.connector_id,
+        organization_id: connector.organization_id,
+        connector_type: connector.connector_type,
+        name,
+        description,
+        category: 'custom',
+        // Entity schema enum has no "jwt"; use custom and keep API auth in metadata.
+        auth_type: 'custom',
+        version: '1.0.0',
+        metadata: { ...meta, sdk_auth_type: 'jwt' },
+        created_at: connector.created_at ?? now,
+        updated_at: connector.updated_at ?? now,
+    };
+}
+/**
+ * Build project-local JSON files for an SDK ingest topology.
+ * Paths match the customer workspace layout (not the flat save_workflow_bundle map).
+ */
+export function buildSdkIngestLocalPackage(params) {
     const workflowId = params.workflow_id ?? randomUUID();
     const connectionId = params.connection_id ?? randomUUID();
     const dataProductId = params.data_product_id ?? randomUUID();
     const now = new Date().toISOString();
     const workflowName = params.workflow_name ?? 'SDK App Events Ingest';
-    const files = {
-        'workflow.json': {
-            workflow_id: workflowId,
-            organization_id: params.organization_id,
-            project_id: params.project_id,
-            name: workflowName,
-            workflow_type: 'ingestion',
-            domain_id: params.domain_id,
-            status: 'active',
-            configuration: {},
-            metadata: { ingestion_method: 'sdk' },
-            created_at: now,
-            updated_at: now,
+    const files = {};
+    if (params.include_connector_file !== false && params.connector) {
+        files[`connectors/${params.connector_id}.json`] = toLocalConnectorEntity(params.connector, now);
+    }
+    files[`workflows/${workflowId}/workflow.json`] = {
+        workflow_id: workflowId,
+        organization_id: params.organization_id,
+        project_id: params.project_id,
+        name: workflowName,
+        template_id: SDK_INGEST_TEMPLATE_ID,
+        workflow_type: 'ingestion',
+        domain_id: params.domain_id,
+        status: 'active',
+        configuration: {},
+        metadata: { ingestion_method: 'sdk' },
+        created_at: now,
+        updated_at: now,
+    };
+    files[`workflows/${workflowId}/connections/${connectionId}.json`] = {
+        connection_id: connectionId,
+        organization_id: params.organization_id,
+        project_id: params.project_id,
+        workflow_id: workflowId,
+        connector_id: params.connector_id,
+        key: 'sdk-input',
+        name: 'SDK Input',
+        type: 'sdk',
+        status: 'active',
+        configuration: {
+            sdk_type: 'nodejs',
+            event_type: params.data_product_name,
         },
-        [`connections/${connectionId}.json`]: {
-            connection_id: connectionId,
-            organization_id: params.organization_id,
-            project_id: params.project_id,
-            workflow_id: workflowId,
-            connector_id: params.connector_id,
-            key: 'sdk-input',
-            name: 'SDK Input',
-            type: 'sdk',
-            status: 'active',
-            configuration: {
-                sdk_type: 'nodejs',
-                event_type: params.data_product_name,
-            },
-            created_at: now,
-            updated_at: now,
+        created_at: now,
+        updated_at: now,
+    };
+    const dataProduct = {
+        data_product_id: dataProductId,
+        organization_id: params.organization_id,
+        workflow_id: workflowId,
+        upstream_entity_id: connectionId,
+        upstream_entity_type: 'connections',
+        domain_id: params.domain_id,
+        name: params.data_product_name,
+        status: 'draft',
+        governance: {
+            classification: 'internal',
+            pii_fields: [],
+            compliance_requirements: [],
+            tags: [],
         },
-        [`data-products/${dataProductId}.json`]: {
-            data_product_id: dataProductId,
-            organization_id: params.organization_id,
-            project_id: params.project_id,
-            workflow_id: workflowId,
-            upstream_entity_id: connectionId,
-            upstream_entity_type: 'connections',
-            domain_id: params.domain_id,
-            name: params.data_product_name,
+        metadata: {
             kind: 'source',
-            status: 'draft',
-            owner: params.user_id ? { user_id: params.user_id } : {},
-            governance: {
-                classification: 'internal',
-                pii_fields: [],
-                compliance_requirements: [],
-                tags: [],
-            },
-            metadata: {},
-            created_at: now,
-            updated_at: now,
+            project_id: params.project_id,
         },
+        created_at: now,
+        updated_at: now,
     };
+    if (params.iceberg_enabled) {
+        dataProduct.storage = { iceberg_enabled: true };
+    }
+    if (params.user_id) {
+        dataProduct.owner = { user_id: params.user_id };
+    }
+    files[`workflows/${workflowId}/data-products/${dataProductId}.json`] = dataProduct;
     return {
         workflow_id: workflowId,
         connection_id: connectionId,
         data_product_id: dataProductId,
         data_product_name: params.data_product_name,
+        connector_id: params.connector_id,
         files,
     };
 }
+/**
+ * Flat bundle map for `save_workflow_bundle` / `bundle save` (workflow-relative keys).
+ */
+export function buildSdkIngestBundle(params) {
+    const local = buildSdkIngestLocalPackage({ ...params, include_connector_file: false });
+    const wf = local.workflow_id;
+    const files = {
+        'workflow.json': local.files[`workflows/${wf}/workflow.json`],
+        [`connections/${local.connection_id}.json`]: local.files[`workflows/${wf}/connections/${local.connection_id}.json`],
+        [`data-products/${local.data_product_id}.json`]: local.files[`workflows/${wf}/data-products/${local.data_product_id}.json`],
+    };
+    return {
+        workflow_id: local.workflow_id,
+        connection_id: local.connection_id,
+        data_product_id: local.data_product_id,
+        data_product_name: local.data_product_name,
+        files,
+    };
+}
+/** Validate every entity in a local package map; returns field-level errors. */
+export function validateSdkIngestPackageFiles(files) {
+    const errors = [];
+    for (const [path, entity] of Object.entries(files)) {
+        let entityType = null;
+        if (path.startsWith('connectors/') && path.endsWith('.json')) {
+            entityType = EntityType.CONNECTOR;
+        }
+        else if (path.endsWith('/workflow.json') || path === 'workflow.json') {
+            entityType = EntityType.WORKFLOW;
+        }
+        else if (path.includes('/connections/') || path.startsWith('connections/')) {
+            entityType = EntityType.CONNECTION;
+        }
+        else if (path.includes('/data-products/') || path.startsWith('data-products/')) {
+            entityType = EntityType.DATA_PRODUCT;
+        }
+        if (!entityType)
+            continue;
+        const result = validateEntity(entityType, entity);
+        if (!result.valid && result.errors) {
+            for (const err of result.errors) {
+                errors.push({
+                    path: `${path}${err.path}`,
+                    entity_type: entityType,
+                    message: err.message,
+                });
+            }
+        }
+    }
+    return errors;
+}
 //# sourceMappingURL=sdk-ingest-bundle.js.map

package/dist/lib/sdk-ingest-bundle.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-ingest-bundle.js","sourceRoot":"","sources":["../../src/lib/sdk-ingest-bundle.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAuBzC,MAAM,UAAU,oBAAoB,CAAC,MAA6B;IAChE,MAAM,UAAU,GAAG,MAAM,CAAC,WAAW,IAAI,UAAU,EAAE,CAAC;IACtD,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,IAAI,UAAU,EAAE,CAAC;IAC1D,MAAM,aAAa,GAAG,MAAM,CAAC,eAAe,IAAI,UAAU,EAAE,CAAC;IAC7D,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,YAAY,GAAG,MAAM,CAAC,aAAa,IAAI,uBAAuB,CAAC;IAErE,MAAM,KAAK,GAA4C;QACrD,eAAe,EAAE;YACf,WAAW,EAAE,UAAU;YACvB,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,IAAI,EAAE,YAAY;YAClB,aAAa,EAAE,WAAW;YAC1B,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE,EAAE;YACjB,QAAQ,EAAE,EAAE,gBAAgB,EAAE,KAAK,EAAE;YACrC,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;SAChB;QACD,CAAC,eAAe,YAAY,OAAO,CAAC,EAAE;YACpC,aAAa,EAAE,YAAY;YAC3B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,UAAU;YACvB,YAAY,EAAE,MAAM,CAAC,YAAY;YACjC,GAAG,EAAE,WAAW;YAChB,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,QAAQ;YAChB,aAAa,EAAE;gBACb,QAAQ,EAAE,QAAQ;gBAClB,UAAU,EAAE,MAAM,CAAC,iBAAiB;aACrC;YACD,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;SAChB;QACD,CAAC,iBAAiB,aAAa,OAAO,CAAC,EAAE;YACvC,eAAe,EAAE,aAAa;YAC9B,eAAe,EAAE,MAAM,CAAC,eAAe;YACvC,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,WAAW,EAAE,UAAU;YACvB,kBAAkB,EAAE,YAAY;YAChC,oBAAoB,EAAE,aAAa;YACnC,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,IAAI,EAAE,MAAM,CAAC,iBAAiB;YAC9B,IAAI,EAAE,QAAQ;YACd,MAAM,EAAE,OAAO;YACf,KAAK,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE;YACxD,UAAU,EAAE;gBACV,cAAc,EAAE,UAAU;gBAC1B,UAAU,EAAE,EAAE;gBACd,uBAAuB,EAAE,EAAE;gBAC3B,IAAI,EAAE,EAAE;aACT;YACD,QAAQ,EAAE,EAAE;YACZ,UAAU,EAAE,GAAG;YACf,UAAU,EAAE,GAAG;SAChB;KACF,CAAC;IAEF,OAAO;QACL,WAAW,EAAE,UAAU;QACvB,aAAa,EAAE,YAAY;QAC3B,eAAe,EAAE,aAAa;QAC9B,iBAAiB,EAAE,MAAM,CAAC,iBAAiB;QAC3C,KAAK;KACN,CAAC;AACJ,CAAC"}
+{"version":3,"file":"sdk-ingest-bundle.js","sourceRoot":"","sources":["../../src/lib/sdk-ingest-bundle.ts"],"names":[],"mappings":"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"}

package/dist/lib/workspace-lint.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Offline lint of a local Loxtep project package (entity schemas + relationships).
+ */
+export interface LintIssue {
+    path: string;
+    severity: 'error';
+    message: string;
+}
+export interface LintResult {
+    ok: boolean;
+    issues: LintIssue[];
+    files_checked: number;
+}
+export interface LintOptions {
+    /** Project root (contains workflows/, connectors/). */
+    projectDir: string;
+    /** When set, only lint this workflow directory under workflows/<id>/. */
+    workflow_id?: string;
+}
+/**
+ * Lint local entity JSON against shipped schemas and basic relationship checks.
+ */
+export declare function lintLocalPackage(options: LintOptions): LintResult;
+/**
+ * True when the project has at least one entity JSON package file to lint.
+ */
+export declare function hasLocalEntityPackage(projectDir: string): boolean;
+//# sourceMappingURL=workspace-lint.d.ts.map

package/dist/lib/workspace-lint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workspace-lint.d.ts","sourceRoot":"","sources":["../../src/lib/workspace-lint.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,OAAO,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,uDAAuD;IACvD,UAAU,EAAE,MAAM,CAAC;IACnB,yEAAyE;IACzE,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAqGD;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,UAAU,CAkGjE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAQjE"}

package/dist/lib/workspace-lint.js

@@ -0,0 +1,199 @@
+/**
+ * Offline lint of a local Loxtep project package (entity schemas + relationships).
+ */
+import { existsSync, readdirSync, readFileSync, statSync } from 'node:fs';
+import { join, relative } from 'node:path';
+import { EntityType, validateEntity } from './entity-json-schemas/index.js';
+function readJsonObject(filePath) {
+    try {
+        const raw = JSON.parse(readFileSync(filePath, 'utf8'));
+        if (raw && typeof raw === 'object' && !Array.isArray(raw)) {
+            return raw;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+function listJsonFiles(dir) {
+    if (!existsSync(dir))
+        return [];
+    const out = [];
+    for (const name of readdirSync(dir)) {
+        const full = join(dir, name);
+        let st;
+        try {
+            st = statSync(full);
+        }
+        catch {
+            continue;
+        }
+        if (st.isDirectory()) {
+            out.push(...listJsonFiles(full));
+        }
+        else if (name.endsWith('.json')) {
+            out.push(full);
+        }
+    }
+    return out;
+}
+function classifyEntity(projectDir, filePath) {
+    const rel = relative(projectDir, filePath).replace(/\\/g, '/');
+    if (rel.startsWith('connectors/') && rel.endsWith('.json')) {
+        return EntityType.CONNECTOR;
+    }
+    if (rel.match(/^workflows\/[^/]+\/workflow\.json$/)) {
+        return EntityType.WORKFLOW;
+    }
+    if (rel.match(/^workflows\/[^/]+\/connections\/[^/]+\.json$/)) {
+        return EntityType.CONNECTION;
+    }
+    if (rel.match(/^workflows\/[^/]+\/data-products\/[^/]+\.json$/)) {
+        return EntityType.DATA_PRODUCT;
+    }
+    if (rel.match(/^workflows\/[^/]+\/transformations\/[^/]+\.json$/)) {
+        return EntityType.TRANSFORMATION;
+    }
+    if (rel.match(/^workflows\/[^/]+\/validations\/[^/]+\.json$/)) {
+        return EntityType.VALIDATION;
+    }
+    if (rel.startsWith('domains/') && rel.endsWith('.json')) {
+        return EntityType.DOMAIN;
+    }
+    return null;
+}
+function discoverEntities(projectDir, workflowId) {
+    const entities = [];
+    const roots = [join(projectDir, 'connectors'), join(projectDir, 'domains')];
+    if (workflowId) {
+        roots.push(join(projectDir, 'workflows', workflowId));
+    }
+    else {
+        roots.push(join(projectDir, 'workflows'));
+    }
+    for (const root of roots) {
+        for (const filePath of listJsonFiles(root)) {
+            const entityType = classifyEntity(projectDir, filePath);
+            if (!entityType)
+                continue;
+            const data = readJsonObject(filePath);
+            const rel = relative(projectDir, filePath).replace(/\\/g, '/');
+            if (!data) {
+                entities.push({
+                    path: rel,
+                    entityType,
+                    data: {},
+                });
+                // mark unreadable via empty + special handling below
+                continue;
+            }
+            entities.push({ path: rel, entityType, data });
+        }
+    }
+    return entities;
+}
+/**
+ * Lint local entity JSON against shipped schemas and basic relationship checks.
+ */
+export function lintLocalPackage(options) {
+    const { projectDir, workflow_id } = options;
+    const issues = [];
+    if (!existsSync(projectDir)) {
+        return {
+            ok: false,
+            files_checked: 0,
+            issues: [{ path: projectDir, severity: 'error', message: 'Project directory not found' }],
+        };
+    }
+    const entities = discoverEntities(projectDir, workflow_id);
+    const byId = new Map();
+    for (const entity of entities) {
+        if (Object.keys(entity.data).length === 0) {
+            issues.push({
+                path: entity.path,
+                severity: 'error',
+                message: 'Invalid or unreadable JSON object',
+            });
+            continue;
+        }
+        const result = validateEntity(entity.entityType, entity.data);
+        if (!result.valid && result.errors) {
+            for (const err of result.errors) {
+                issues.push({
+                    path: `${entity.path}${err.path}`,
+                    severity: 'error',
+                    message: err.message,
+                });
+            }
+        }
+        const idKey = entity.data.connector_id ||
+            entity.data.connection_id ||
+            entity.data.workflow_id ||
+            entity.data.data_product_id ||
+            entity.data.domain_id;
+        if (idKey) {
+            byId.set(idKey, entity);
+        }
+    }
+    // Relationship checks
+    for (const entity of entities) {
+        if (entity.entityType === EntityType.CONNECTION) {
+            const connectorId = entity.data.connector_id;
+            if (typeof connectorId === 'string' && connectorId.length > 0) {
+                // connector may exist only remotely; warn only if local connectors/ is present
+                // and does not contain this id — keep as error when local connector file expected.
+                const localConnectors = entities.filter(e => e.entityType === EntityType.CONNECTOR);
+                if (localConnectors.length > 0 &&
+                    !localConnectors.some(c => c.data.connector_id === connectorId)) {
+                    issues.push({
+                        path: entity.path,
+                        severity: 'error',
+                        message: `connector_id "${connectorId}" not found under connectors/`,
+                    });
+                }
+            }
+            else {
+                issues.push({
+                    path: entity.path,
+                    severity: 'error',
+                    message: 'connection is missing connector_id',
+                });
+            }
+        }
+        if (entity.entityType === EntityType.DATA_PRODUCT) {
+            const upstream = entity.data.upstream_entity_id;
+            if (typeof upstream === 'string' && upstream.length > 0 && !byId.has(upstream)) {
+                // Upstream may be a connection in the same workflow — check connection ids
+                const conn = entities.find(e => e.entityType === EntityType.CONNECTION && e.data.connection_id === upstream);
+                if (!conn) {
+                    issues.push({
+                        path: entity.path,
+                        severity: 'error',
+                        message: `upstream_entity_id "${upstream}" not found in local package`,
+                    });
+                }
+            }
+        }
+    }
+    return {
+        ok: issues.length === 0,
+        issues,
+        files_checked: entities.length,
+    };
+}
+/**
+ * True when the project has at least one entity JSON package file to lint.
+ */
+export function hasLocalEntityPackage(projectDir) {
+    const workflowsDir = join(projectDir, 'workflows');
+    if (!existsSync(workflowsDir))
+        return false;
+    for (const name of readdirSync(workflowsDir)) {
+        const wfJson = join(workflowsDir, name, 'workflow.json');
+        if (existsSync(wfJson))
+            return true;
+    }
+    return existsSync(join(projectDir, 'connectors')) && listJsonFiles(join(projectDir, 'connectors')).length > 0;
+}
+//# sourceMappingURL=workspace-lint.js.map

package/dist/lib/workspace-lint.js.map

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

package/dist/skills/loader.d.ts

@@ -19,34 +19,34 @@ declare const SkillDefinitionSchema: z.ZodObject<{
     }, z.core.$strip>;
     permissions: z.ZodObject<{
         data_products: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
-            write: "write";
-            read: "read";
             create: "create";
             delete: "delete";
-        }>>>>;
-        connectors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             write: "write";
             read: "read";
+        }>>>>;
+        connectors: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             create: "create";
             delete: "delete";
-        }>>>>;
-        workflows: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             write: "write";
             read: "read";
+        }>>>>;
+        workflows: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             create: "create";
             delete: "delete";
-        }>>>>;
-        domains: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             write: "write";
             read: "read";
+        }>>>>;
+        domains: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             create: "create";
             delete: "delete";
-        }>>>>;
-        queues: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             write: "write";
             read: "read";
+        }>>>>;
+        queues: z.ZodOptional<z.ZodOptional<z.ZodArray<z.ZodEnum<{
             create: "create";
             delete: "delete";
+            write: "write";
+            read: "read";
         }>>>>;
     }, z.core.$strip>;
 }, z.core.$strip>;

package/docs/getting-started.md

@@ -170,6 +170,8 @@ from your application:
 
 ```bash
 pnpm exec loxtep ingest provision --name app-events
+pnpm exec loxtep lint
+pnpm exec loxtep deploy
 pnpm exec loxtep data-products list
 ```
 

package/docs/quick-reference.md

@@ -193,6 +193,7 @@ pnpm exec loxtep generate
 
 ```bash
 pnpm exec loxtep ingest provision --name app-events
+pnpm exec loxtep lint && pnpm exec loxtep deploy
 ```
 
 See [Write to a data product](./sdk-first-ingest.md).