@loxtep/sdk 0.9.24 → 0.9.25

package/CHANGELOG.md

@@ -8,6 +8,24 @@ and this project adheres to
 
 ## [Unreleased]
 
+## [0.9.25] - 2026-10-10
+
+### Added
+
+- `data_products.query_receipt` keeps the native warehouse `query_id`, status, errors, timing, and execution metadata. `query` still returns rows, and only when status is `completed`. A failed query throws `WarehouseQueryError` with `query_id`. Any other status, including a missing status, is an error and is not rewritten to completed.
+- `data_products.iceberg` wraps enable, config, health, files, snapshots, rebuild, and cancel.
+- `data_products.export_events` reads retained trace events with an explicit start or `from_beginning`. It does not commit a reader checkpoint.
+- `define.quality_rules` wraps `/dataproducts/quality-rules`. `get` scans the list because there is no GET-by-id route.
+- `meaning.semantic.apply_glossary_bindings` posts `/semantic-layer/glossary/bindings`.
+- CLI: `data-products iceberg`, `data-products export`, `data-products primary-entity`, `data-products query --receipt`, `data-contracts update`, `quality-rules`, `define glossary`, and `define apply-glossary`. Usage is in `nodejs/docs/data-plane-cli.md`. `--wait` finishes only when health `job_id` or `backfill_job_id` is the accepted job.
+- HTTP requests send `x-loxtep-instance-id` from the client instance. `setInstanceId` changes it. Queue metadata for a name absent from that instance is `not_visible` or `empty_on_selected_instance` and does not invent checkpoints.
+
+### Notes
+
+- Python stays 0.7.2. `loxtep` on Python delegates these commands to the Node CLI. Python `DataProductsApi.query` still returns rows only.
+- Rebuild cancel returns the native error. Stage instances without a cancel route report `endpoint_missing`. A queued rebuild is not completion.
+- This package is source 0.9.25 until the `v0.9.25` tag is published. The deployed data-products service must include the read-only dry-run handler before a live dry run is read-only.
+
 ## [0.9.24] - 2026-10-09
 
 ### Added

package/README.md

@@ -350,6 +350,7 @@ await client.build.targets.delete('dp_abc123', webhook.consumption_id);
 - **[Code-first CLI](./docs/code-first-cli.md)** – `loxtep init`, attach, generate, test, deploy.
 - **[Quick reference](./docs/quick-reference.md)** – Single-page cheat sheet.
 - **[Event replay cookbook](./docs/event-replay-cookbook.md)** – Replay events from a data product or queue.
+- **[Data plane CLI](./docs/data-plane-cli.md)** – Iceberg rebuild and inspection, SQL receipts, read-only export.
 - **[SDK + agent pairing](./docs/sdk-pairing.md)** – When to use the SDK vs IDE agent integrations.
 - **Typed errors** – `import { … } from '@loxtep/sdk/errors'`.
 - **API reference** – `pnpm run docs` (Typedoc).

package/dist/cli/commands/data-plane-cmd.d.ts

@@ -0,0 +1,59 @@
+/**
+ * CLI for Iceberg control, read-only export, query receipts, and governance gaps.
+ * Commands call the existing REST API. A queued rebuild is not completion.
+ */
+import type { LoxtepClient } from '../../client/loxtep-client.js';
+import { type CreateCliClientOptions } from '../create-cli-client.js';
+export interface CliIo {
+    log: (line: string) => void;
+    error: (line: string) => void;
+}
+export declare function argValue(args: string[], name: string): string | undefined;
+export declare function hasFlag(args: string[], name: string): boolean;
+export declare function parseDurationMs(value: string): number | undefined;
+export interface RebuildRequestBody {
+    confirm: true;
+    backfill_from: string;
+    start_checkpoint?: string;
+    end_checkpoint?: string;
+    dry_run: boolean;
+}
+export declare function validateRebuildArgs(args: string[]): {
+    ok: true;
+    body: RebuildRequestBody;
+    end_bound: 'evergreen' | 'checkpoint';
+} | {
+    ok: false;
+    code: string;
+    message: string;
+};
+export declare function pollIcebergJob(input: {
+    readHealth: () => Promise<Record<string, unknown>>;
+    jobId: string;
+    waitMs: number;
+    intervalMs: number;
+    sleep?: (ms: number) => Promise<void>;
+    now?: () => number;
+}): Promise<{
+    exitCode: number;
+    body: Record<string, unknown>;
+}>;
+export interface IcebergClock {
+    now?: () => number;
+    sleep?: (ms: number) => Promise<void>;
+}
+export declare function executeIceberg(client: LoxtepClient, args: string[], io: CliIo, clock?: IcebergClock): Promise<number>;
+export declare function executeExport(client: LoxtepClient, args: string[], io?: CliIo): Promise<number>;
+export declare function executePrimaryEntity(client: LoxtepClient, productId: string, io?: CliIo, json?: boolean): Promise<number>;
+export declare function executeGlossary(client: LoxtepClient, args: string[], io?: CliIo): Promise<number>;
+export declare function executeContractUpdate(client: LoxtepClient, args: string[], io?: CliIo): Promise<number>;
+export declare function executeQualityRules(client: LoxtepClient, args: string[], io?: CliIo): Promise<number>;
+export declare function runDataPlaneIceberg(args: string[], options?: CreateCliClientOptions): Promise<void>;
+export declare function runDataPlaneExport(args: string[], options?: CreateCliClientOptions): Promise<void>;
+export declare function runPrimaryEntity(productId: string, options?: CreateCliClientOptions & {
+    json?: boolean;
+}): Promise<void>;
+export declare function runDefineGlossary(args: string[], options?: CreateCliClientOptions): Promise<void>;
+export declare function runDataContractsUpdate(args: string[], options?: CreateCliClientOptions): Promise<void>;
+export declare function runQualityRules(args: string[], options?: CreateCliClientOptions): Promise<void>;
+//# sourceMappingURL=data-plane-cmd.d.ts.map

package/dist/cli/commands/data-plane-cmd.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"data-plane-cmd.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/data-plane-cmd.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAAoB,KAAK,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AAKxF,MAAM,WAAW,KAAK;IACpB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC/B;AAyBD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAMzE;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAE7D;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUjE;AAMD,MAAM,WAAW,kBAAkB;IACjC,OAAO,EAAE,IAAI,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,mBAAmB,CACjC,IAAI,EAAE,MAAM,EAAE,GACb;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,SAAS,EAAE,WAAW,GAAG,YAAY,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAqD9H;AA8DD,wBAAsB,cAAc,CAAC,KAAK,EAAE;IAC1C,UAAU,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAAC,CA0D/D;AAgBD,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CACvC;AAED,wBAAsB,cAAc,CAClC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,EAAE,KAAK,EACT,KAAK,CAAC,EAAE,YAAY,GACnB,OAAO,CAAC,MAAM,CAAC,CAqOjB;AAED,wBAAsB,aAAa,CACjC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,KAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CA4BjB;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,MAAM,EACjB,EAAE,GAAE,KAAiB,EACrB,IAAI,UAAQ,GACX,OAAO,CAAC,MAAM,CAAC,CAgBjB;AAED,wBAAsB,eAAe,CACnC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,KAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CAwBjB;AAED,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,KAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,YAAY,EACpB,IAAI,EAAE,MAAM,EAAE,EACd,EAAE,GAAE,KAAiB,GACpB,OAAO,CAAC,MAAM,CAAC,CAmDjB;AAWD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,sBAAsB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAO,GACxD,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,eAAe,CACnC,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,GAAE,sBAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CAEf"}