@functional-systems/lambdadb-cli 0.1.0-dev.1

package/dist/errors.js

@@ -0,0 +1,41 @@
+import { LambdaDBError, ResponseValidationError, SDKValidationError } from '@functional-systems/lambdadb/models/errors';
+export class InputError extends Error {
+}
+// Never serialize SDK errors: they can contain credentials, response bodies and signed URLs.
+export function describeError(error) {
+    if (error instanceof InputError) {
+        return { code: 'INPUT_ERROR', message: error.message, hint: 'Check --help and the input file or configuration.' };
+    }
+    if (error instanceof ResponseValidationError) {
+        return { code: 'INVALID_RESPONSE', message: 'The API response does not match the SDK contract.', hint: 'Check SDK/API compatibility. A malformed write response does not prove the write failed.', httpStatus: error.statusCode };
+    }
+    if (error instanceof SDKValidationError) {
+        return { code: 'INPUT_ERROR', message: 'The request does not match the SDK contract.', hint: 'Check field names, types, index settings and ref selection.' };
+    }
+    if (error instanceof LambdaDBError) {
+        const status = error.statusCode;
+        const hint = status === 401 || status === 403
+            ? 'Verify the selected API-key environment variable and its access to this project.'
+            : status === 404 ? 'Verify endpoint, project, collection and ref names.'
+                : status === 409 ? 'Inspect the existing resource before choosing a different name.'
+                    : status === 429 ? 'Reduce load or retry later; a consistent-read overlay may exceed its limit.'
+                        : status === 413 ? 'Reduce the batch size or use bulk mode where supported.'
+                            : status >= 500 ? 'Check service availability. Inspect writes before retrying an uncertain mutation.'
+                                : 'Check the request against the public API contract and collection schema.';
+        return { code: status === 401 || status === 403 ? 'AUTH_ERROR' : 'API_ERROR', message: `LambdaDB returned HTTP ${status}.`, httpStatus: status, hint };
+    }
+    return {
+        code: 'REQUEST_FAILED',
+        message: 'The operation could not be completed or its response could not be verified.',
+        hint: 'Check endpoint, connectivity, timeout and SDK/API compatibility. Inspect writes before retrying.',
+    };
+}
+export function isInputError(error) {
+    // SDKValidationError uses Symbol.hasInstance and also matches response validation errors.
+    return error instanceof InputError || (error instanceof SDKValidationError && !(error instanceof ResponseValidationError));
+}
+export function definitelyRejected(error) {
+    return isInputError(error) || (error instanceof LambdaDBError
+        && error.statusCode >= 400 && error.statusCode < 500 && error.statusCode !== 408);
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AAExH,MAAM,OAAO,UAAW,SAAQ,KAAK;CAAG;AAIxC,6FAA6F;AAC7F,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAChC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,mDAAmD,EAAE,CAAC;IACpH,CAAC;IACD,IAAI,KAAK,YAAY,uBAAuB,EAAE,CAAC;QAC7C,OAAO,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,mDAAmD,EAAE,IAAI,EAAE,0FAA0F,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;IACpO,CAAC;IACD,IAAI,KAAK,YAAY,kBAAkB,EAAE,CAAC;QACxC,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,8CAA8C,EAAE,IAAI,EAAE,6DAA6D,EAAE,CAAC;IAC/J,CAAC;IACD,IAAI,KAAK,YAAY,aAAa,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,KAAK,CAAC,UAAU,CAAC;QAChC,MAAM,IAAI,GAAG,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG;YAC3C,CAAC,CAAC,kFAAkF;YACpF,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,qDAAqD;gBACxE,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,iEAAiE;oBACpF,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,6EAA6E;wBAChG,CAAC,CAAC,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,yDAAyD;4BAC5E,CAAC,CAAC,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,mFAAmF;gCACrG,CAAC,CAAC,0EAA0E,CAAC;QAC/E,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,GAAG,IAAI,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,EAAE,0BAA0B,MAAM,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;IACzJ,CAAC;IACD,OAAO;QACL,IAAI,EAAE,gBAAgB;QACtB,OAAO,EAAE,6EAA6E;QACtF,IAAI,EAAE,kGAAkG;KACzG,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,0FAA0F;IAC1F,OAAO,KAAK,YAAY,UAAU,IAAI,CAAC,KAAK,YAAY,kBAAkB,IAAI,CAAC,CAAC,KAAK,YAAY,uBAAuB,CAAC,CAAC,CAAC;AAC7H,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,YAAY,aAAa;WACxD,KAAK,CAAC,UAAU,IAAI,GAAG,IAAI,KAAK,CAAC,UAAU,GAAG,GAAG,IAAI,KAAK,CAAC,UAAU,KAAK,GAAG,CAAC,CAAC;AACtF,CAAC"}

package/dist/import-workflow.d.ts

@@ -0,0 +1,27 @@
+import type { ClientRequestOptions, CollectionDocs } from '@functional-systems/lambdadb';
+import { type SafeError } from './errors.js';
+import type { DocumentRow } from './input.js';
+export type Batch = {
+    rows: DocumentRow[];
+    bytes: number;
+};
+export type BatchResult = {
+    batch: number;
+    firstLine: number;
+    lastLine: number;
+    documents: number;
+    state: 'accepted' | 'failed' | 'unknown';
+    error?: SafeError;
+};
+export type ImportResult = {
+    state: 'accepted' | 'failed' | 'partial' | 'unknown';
+    total: number;
+    accepted: number;
+    failed: number;
+    unknown: number;
+    notAttempted: number;
+    searchable: 'not_verified';
+    batches: BatchResult[];
+};
+export declare function planBatches(rows: DocumentRow[], branch: string, batchSize: number, maxBytes: number, bulk: boolean): Batch[];
+export declare function importDocuments(docs: Pick<CollectionDocs, 'upsert' | 'bulkUpsertDocs'>, batches: Batch[], branch: string, bulk: boolean, options: ClientRequestOptions, progress?: (batch: BatchResult) => void): Promise<ImportResult>;

package/dist/import-workflow.js

@@ -0,0 +1,60 @@
+import { definitelyRejected, describeError, InputError } from './errors.js';
+export function planBatches(rows, branch, batchSize, maxBytes, bulk) {
+    const overhead = Buffer.byteLength(JSON.stringify(bulk ? { docs: [] } : { docs: [], branch }));
+    const batches = [];
+    let current = { rows: [], bytes: overhead };
+    for (const row of rows) {
+        if (overhead + row.bytes > maxBytes)
+            throw new InputError(`JSONL line ${row.line} exceeds the batch byte limit. Increase the limit within the mode's supported range.`);
+        if (current.rows.length && (current.rows.length >= batchSize || current.bytes + 1 + row.bytes > maxBytes)) {
+            batches.push(current);
+            current = { rows: [], bytes: overhead };
+        }
+        current.bytes += row.bytes + (current.rows.length ? 1 : 0);
+        current.rows.push(row);
+    }
+    if (current.rows.length)
+        batches.push(current);
+    return batches;
+}
+// Domain workflow: no terminal I/O. Stop on the first failure, preserving acknowledged progress.
+export async function importDocuments(docs, batches, branch, bulk, options, progress = () => { }) {
+    const total = batches.reduce((sum, b) => sum + b.rows.length, 0);
+    const result = {
+        state: 'accepted', total, accepted: 0, failed: 0, unknown: 0, notAttempted: total,
+        searchable: 'not_verified', batches: [],
+    };
+    for (const [index, batch] of batches.entries()) {
+        if (options.signal?.aborted) {
+            result.state = result.accepted > 0 ? 'partial' : 'failed';
+            break;
+        }
+        const item = {
+            batch: index + 1, firstLine: batch.rows[0].line, lastLine: batch.rows.at(-1).line,
+            documents: batch.rows.length, state: 'accepted',
+        };
+        try {
+            const body = { docs: batch.rows.map(row => row.doc), branch };
+            // Mutations are never automatically retried: no public idempotency/receipt contract.
+            const requestOptions = { ...options, retries: { strategy: 'none' } };
+            if (bulk)
+                await docs.bulkUpsertDocs(body, requestOptions);
+            else
+                await docs.upsert(body, requestOptions);
+        }
+        catch (error) {
+            item.state = definitelyRejected(error) ? 'failed' : 'unknown';
+            item.error = describeError(error);
+        }
+        result[item.state] += item.documents;
+        result.notAttempted -= item.documents;
+        result.batches.push(item);
+        progress(item);
+        if (item.state !== 'accepted') {
+            result.state = item.state === 'unknown' ? 'unknown' : result.accepted > 0 ? 'partial' : 'failed';
+            break;
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=import-workflow.js.map

package/dist/import-workflow.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"import-workflow.js","sourceRoot":"","sources":["../src/import-workflow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAc5F,MAAM,UAAU,WAAW,CAAC,IAAmB,EAAE,MAAc,EAAE,SAAiB,EAAE,QAAgB,EAAE,IAAa;IACjH,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC/F,MAAM,OAAO,GAAY,EAAE,CAAC;IAC5B,IAAI,OAAO,GAAU,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;IACnD,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,QAAQ,GAAG,GAAG,CAAC,KAAK,GAAG,QAAQ;YAAE,MAAM,IAAI,UAAU,CAAC,cAAc,GAAG,CAAC,IAAI,sFAAsF,CAAC,CAAC;QACxK,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,IAAI,SAAS,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,GAAG,GAAG,CAAC,KAAK,GAAG,QAAQ,CAAC,EAAE,CAAC;YAC1G,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,OAAO,GAAG,EAAE,IAAI,EAAE,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/C,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAuD,EACvD,OAAgB,EAAE,MAAc,EAAE,IAAa,EAAE,OAA6B,EAC9E,WAAyC,GAAG,EAAE,GAAE,CAAC;IAEjD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACjE,MAAM,MAAM,GAAiB;QAC3B,KAAK,EAAE,UAAU,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,YAAY,EAAE,KAAK;QACjF,UAAU,EAAE,cAAc,EAAE,OAAO,EAAE,EAAE;KACxC,CAAC;IACF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,IAAI,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;YAC5B,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YAC1D,MAAM;QACR,CAAC;QACD,MAAM,IAAI,GAAgB;YACxB,KAAK,EAAE,KAAK,GAAG,CAAC,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI;YACnF,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,UAAU;SAChD,CAAC;QACF,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,CAAC;YAC9D,qFAAqF;YACrF,MAAM,cAAc,GAAyB,EAAE,GAAG,OAAO,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CAAC;YAC3F,IAAI,IAAI;gBAAE,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;;gBACrD,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,KAAK,GAAG,kBAAkB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,IAAI,CAAC,KAAK,GAAG,aAAa,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;QACD,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC;QACrC,MAAM,CAAC,YAAY,IAAI,IAAI,CAAC,SAAS,CAAC;QACtC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,IAAI,IAAI,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC;YACjG,MAAM;QACR,CAAC;IACH,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,15 @@
+import type { CreateCollectionInput, QueryCollectionInput, ReadRef } from '@functional-systems/lambdadb';
+export declare const MAX_INPUT_BYTES: number;
+export declare const MAX_INPUT_DOCUMENTS = 100000;
+export declare function readText(path: string, limit?: number): Promise<string>;
+export declare function object(value: unknown, label: string): Record<string, unknown>;
+export declare function readJson(path: string): Promise<Record<string, unknown>>;
+export declare function parseRef(value: string): ReadRef;
+export declare function queryInput(body: Record<string, unknown>, ref: ReadRef): QueryCollectionInput;
+export declare function createInput(collectionName: string, indexConfigs: Record<string, unknown>): CreateCollectionInput;
+export type DocumentRow = {
+    line: number;
+    doc: Record<string, unknown>;
+    bytes: number;
+};
+export declare function readJsonl(path: string): Promise<DocumentRow[]>;

package/dist/input.js

@@ -0,0 +1,127 @@
+import { open } from 'node:fs/promises';
+import { TextDecoder } from 'node:util';
+import { createCollectionRequestToJSON, queryCollectionRequestBodyToJSON } from '@functional-systems/lambdadb/models/operations';
+import { InputError } from './errors.js';
+import { name } from './config.js';
+export const MAX_INPUT_BYTES = 64 * 1024 * 1024;
+export const MAX_INPUT_DOCUMENTS = 100_000;
+export async function readText(path, limit = MAX_INPUT_BYTES) {
+    let file;
+    try {
+        file = await open(path, 'r');
+    }
+    catch {
+        throw new InputError('Cannot open input file.');
+    }
+    try {
+        if (!(await file.stat()).isFile())
+            throw new InputError('Input must be a regular file.');
+        // Read one immutable in-memory input snapshot; never submit a partially validated file.
+        const chunks = [];
+        let size = 0;
+        for await (const chunk of file.createReadStream({ autoClose: false })) {
+            size += chunk.length;
+            if (size > limit)
+                throw new InputError(`Input exceeds the ${limit}-byte local limit. Split the file first.`);
+            chunks.push(chunk);
+        }
+        return new TextDecoder('utf-8', { fatal: true }).decode(Buffer.concat(chunks));
+    }
+    catch (error) {
+        if (error instanceof InputError)
+            throw error;
+        throw new InputError('Cannot read input as UTF-8.');
+    }
+    finally {
+        await file.close();
+    }
+}
+export function object(value, label) {
+    if (!value || typeof value !== 'object' || Array.isArray(value))
+        throw new InputError(`${label} must be a JSON object.`);
+    return value;
+}
+export async function readJson(path) {
+    const text = await readText(path, 4 * 1024 * 1024);
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new InputError('Input file contains invalid JSON.');
+    }
+    return object(value, 'Input');
+}
+export function parseRef(value) {
+    const [kind, refName, extra] = value.split(':');
+    if (!['branch', 'tag', 'alias'].includes(kind ?? '') || extra !== undefined) {
+        throw new InputError('Ref must be branch:NAME, tag:NAME or alias:NAME.');
+    }
+    return { kind: kind, name: name(refName, 'Ref name') };
+}
+export function queryInput(body, ref) {
+    if (body.ref !== undefined) {
+        const supplied = object(body.ref, 'File ref');
+        if (Object.keys(supplied).some(k => !['kind', 'name'].includes(k)) || supplied.kind !== ref.kind || supplied.name !== ref.name) {
+            throw new InputError('File ref conflicts with --ref. Use the same explicit target in both.');
+        }
+    }
+    const input = { ...body, ref };
+    // Public API accepts null size, while SDK 0.5.1 only accepts undefined/number.
+    if (input.size === null)
+        delete input.size;
+    if (input.size !== undefined && (!Number.isInteger(input.size) || Number(input.size) < 1 || Number(input.size) > 100)) {
+        throw new InputError('Query size must be an integer from 1 to 100, null or omitted.');
+    }
+    try {
+        queryCollectionRequestBodyToJSON(input);
+    }
+    catch {
+        throw new InputError('Invalid query request. Check request fields and types; consistentRead:true requires a branch ref.');
+    }
+    return input;
+}
+export function createInput(collectionName, indexConfigs) {
+    const input = { collectionName, indexConfigs };
+    try {
+        createCollectionRequestToJSON(input);
+    }
+    catch {
+        throw new InputError('Invalid index configuration. Provide a nonempty field-to-index map matching the SDK contract.');
+    }
+    return input;
+}
+export async function readJsonl(path) {
+    const text = await readText(path);
+    const rows = [];
+    // Do not allocate an array entry for every physical line (including blank ones).
+    let offset = 0;
+    let lineNumber = 0;
+    while (offset < text.length) {
+        const newline = text.indexOf('\n', offset);
+        const end = newline === -1 ? text.length : newline;
+        const line = text.slice(offset, end);
+        offset = end + 1;
+        lineNumber++;
+        if (!line.trim())
+            continue;
+        if (rows.length >= MAX_INPUT_DOCUMENTS) {
+            throw new InputError(`JSONL exceeds the ${MAX_INPUT_DOCUMENTS}-document local limit at line ${lineNumber}. Split the file first.`);
+        }
+        let doc;
+        try {
+            doc = object(JSON.parse(line), 'Document');
+        }
+        catch {
+            throw new InputError(`JSONL line ${lineNumber} must be a JSON object.`);
+        }
+        if ('id' in doc && (typeof doc.id !== 'string' || doc.id.length === 0)) {
+            throw new InputError(`JSONL line ${lineNumber} has an invalid id; use a nonempty string or omit it.`);
+        }
+        rows.push({ line: lineNumber, doc, bytes: Buffer.byteLength(JSON.stringify(doc)) });
+    }
+    if (rows.length === 0)
+        throw new InputError('JSONL input contains no documents.');
+    return rows;
+}
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

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

package/dist/output.d.ts

@@ -0,0 +1,17 @@
+import type { SafeError } from './errors.js';
+export type Envelope = {
+    schemaVersion: 1;
+    command: string;
+    ok: boolean;
+    target?: Record<string, unknown>;
+    data?: unknown;
+    error?: SafeError;
+};
+export declare class Output {
+    json: boolean;
+    private secrets;
+    protect(secret: string | undefined): void;
+    private redact;
+    diagnostic(message: string): void;
+    emit(envelope: Envelope, summary: string): void;
+}

package/dist/output.js

@@ -0,0 +1,68 @@
+// These values are CLI protocol tokens, never arbitrary API or document data.
+const protocolValues = new Set([
+    'command', 'error.code', 'target.ref.kind',
+    'data.state', 'data.searchable', 'data.batches.*.state', 'data.batches.*.error.code',
+    'data.checks.*.name', 'data.checks.*.status',
+]);
+// These document/metadata maps carry user-defined field names in MVP responses.
+const freeFormMaps = new Set(['doc', 'indexConfigs', 'tags']);
+export class Output {
+    json = false;
+    secrets = new Set();
+    protect(secret) { if (secret)
+        this.secrets.add(secret); }
+    redact(text) {
+        for (const secret of this.secrets)
+            text = text.split(secret).join('[REDACTED]');
+        return text;
+    }
+    diagnostic(message) {
+        // eslint-disable-next-line no-control-regex -- Strip terminal control bytes from diagnostics.
+        process.stderr.write(`${this.redact(message).replace(/[\x00-\x08\x0b-\x1f\x7f]/g, '')}\n`);
+    }
+    emit(envelope, summary) {
+        // Preserve the protocol while redacting variable values and arbitrary map keys.
+        // Normalize dates first, and redact before serialization to preserve valid JSON.
+        const sanitize = (value, path = '', freeForm = false) => {
+            if (typeof value === 'string')
+                return !freeForm && protocolValues.has(path) ? value : this.redact(value);
+            if (Array.isArray(value))
+                return value.map(item => sanitize(item, `${path}.*`, freeForm));
+            if (value && typeof value === 'object') {
+                const entries = Object.entries(value).map(([key, item]) => ({ key, item, name: freeForm ? this.redact(key) : key }));
+                // Reserve every base name, including unchanged keys that appear later.
+                // Only renamed keys receive suffixes; unrelated field names stay intact.
+                const reserved = new Set(entries.map(entry => entry.name));
+                const used = new Set(entries.filter(entry => entry.key === entry.name).map(entry => entry.name));
+                const suffixes = new Map();
+                return Object.fromEntries(entries.map(({ key, item, name }) => {
+                    let unique = name;
+                    if (key !== name && used.has(unique)) {
+                        let suffix = suffixes.get(name) ?? 1;
+                        do {
+                            unique = `${name}#${suffix++}`;
+                        } while (reserved.has(unique) || used.has(unique));
+                        suffixes.set(name, suffix);
+                    }
+                    used.add(unique);
+                    return [unique, sanitize(item, path ? `${path}.${key}` : key, freeForm || freeFormMaps.has(key))];
+                }));
+            }
+            return value;
+        };
+        const serialized = JSON.stringify(sanitize(JSON.parse(JSON.stringify(envelope))), null, this.json ? undefined : 2);
+        if (this.json)
+            process.stdout.write(`${serialized}\n`);
+        else {
+            const safe = JSON.parse(serialized);
+            process.stdout.write(`${this.redact(summary)}\n`);
+            if (safe.target)
+                process.stdout.write(`${JSON.stringify(safe.target)}\n`);
+            if (safe.data !== undefined)
+                process.stdout.write(`${JSON.stringify(safe.data, null, 2)}\n`);
+        }
+        if (envelope.error)
+            this.diagnostic(`${envelope.error.message} ${envelope.error.hint}`);
+    }
+}
+//# sourceMappingURL=output.js.map

package/dist/output.js.map

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

package/dist/runtime.d.ts

@@ -0,0 +1,7 @@
+import { LambdaDBClient, type ClientRequestOptions } from '@functional-systems/lambdadb';
+import type { Config } from './config.js';
+export declare function runtime(config: Config): {
+    client: LambdaDBClient;
+    options: ClientRequestOptions;
+    close(): void;
+};

package/dist/runtime.js

@@ -0,0 +1,39 @@
+import { HTTPClient, LambdaDBClient } from '@functional-systems/lambdadb';
+export function runtime(config) {
+    // A no-op logger still makes SDK 0.5.1 clone and drain request/response bodies.
+    // Disable its environment-controlled logger before construction instead.
+    delete process.env.LAMBDADB_DEBUG;
+    const controller = new AbortController();
+    const interrupt = () => controller.abort();
+    // Keep the command deadline alive across sequential SDK requests and transfers.
+    const deadline = setTimeout(() => controller.abort(new DOMException('Command deadline exceeded', 'TimeoutError')), config.timeoutMs);
+    deadline.unref();
+    process.once('SIGINT', interrupt);
+    process.once('SIGTERM', interrupt);
+    const options = {
+        signal: controller.signal, timeoutMs: config.timeoutMs,
+        retries: {
+            strategy: 'backoff', retryConnectionErrors: true,
+            backoff: { initialInterval: 200, maxInterval: 500, exponent: 1.5, maxElapsedTime: Math.min(2000, config.timeoutMs) },
+        },
+    };
+    // Bind the command signal at fetch dispatch as well as in SDK options, instead
+    // of relying only on the SDK's cloned Request signal chain.
+    // Keep authenticated API and unauthenticated transfer clients separate.
+    const fetcher = (input, init) => fetch(input, { ...init, signal: controller.signal });
+    const client = new LambdaDBClient({
+        baseUrl: config.endpoint, projectName: config.project, projectApiKey: config.apiKey,
+        timeoutMs: config.timeoutMs,
+        httpClient: new HTTPClient({ fetcher }),
+        transferClient: new HTTPClient({ fetcher }),
+    });
+    return {
+        client, options,
+        close() {
+            clearTimeout(deadline);
+            process.removeListener('SIGINT', interrupt);
+            process.removeListener('SIGTERM', interrupt);
+        },
+    };
+}
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","sourceRoot":"","sources":["../src/runtime.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAA2C,MAAM,8BAA8B,CAAC;AAGnH,MAAM,UAAU,OAAO,CAAC,MAAc;IACpC,gFAAgF;IAChF,yEAAyE;IACzE,OAAO,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IAClC,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IAC3C,gFAAgF;IAChF,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,YAAY,CAAC,2BAA2B,EAAE,cAAc,CAAC,CAAC,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IACrI,QAAQ,CAAC,KAAK,EAAE,CAAC;IACjB,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;IAClC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACnC,MAAM,OAAO,GAAyB;QACpC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS;QACtD,OAAO,EAAE;YACP,QAAQ,EAAE,SAAS,EAAE,qBAAqB,EAAE,IAAI;YAChD,OAAO,EAAE,EAAE,eAAe,EAAE,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,EAAE,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,SAAS,CAAC,EAAE;SACrH;KACF,CAAC;IACF,+EAA+E;IAC/E,4DAA4D;IAC5D,wEAAwE;IACxE,MAAM,OAAO,GAAY,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,GAAG,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;IAC/F,MAAM,MAAM,GAAG,IAAI,cAAc,CAAC;QAChC,OAAO,EAAE,MAAM,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,aAAa,EAAE,MAAM,CAAC,MAAM;QACnF,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,UAAU,EAAE,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;QACvC,cAAc,EAAE,IAAI,UAAU,CAAC,EAAE,OAAO,EAAE,CAAC;KAC5C,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,OAAO;QACf,KAAK;YACH,YAAY,CAAC,QAAQ,CAAC,CAAC;YACvB,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC;YAC5C,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;QAC/C,CAAC;KACF,CAAC;AACJ,CAAC"}

package/examples/documents.jsonl

@@ -0,0 +1,3 @@
+{"id":"doc-1","text":"LambdaDB supports serverless search.","category":"database"}
+{"id":"doc-2","text":"Developers can search documents using a shared CLI.","category":"developer-tools"}
+{"id":"doc-3","text":"A successful write is accepted before committed search visibility is verified.","category":"database"}

package/examples/index-config.json

@@ -0,0 +1,4 @@
+{
+  "text": { "type": "text", "analyzers": ["english"] },
+  "category": { "type": "keyword" }
+}

package/examples/query.json

@@ -0,0 +1,5 @@
+{
+  "size": 10,
+  "query": { "queryString": { "query": "serverless", "defaultField": "text" } },
+  "consistentRead": false
+}

package/package.json

@@ -0,0 +1,56 @@
+{
+  "name": "@functional-systems/lambdadb-cli",
+  "version": "0.1.0-dev.1",
+  "private": false,
+  "description": "Project-scoped LambdaDB command-line tools",
+  "type": "module",
+  "bin": {
+    "lambdadb": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "src",
+    "README.md",
+    "DESIGN.md",
+    "VALIDATION.md",
+    "CONTRIBUTING.md",
+    "examples",
+    "RELEASING.md",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": ">=22.14.0"
+  },
+  "scripts": {
+    "build": "tsc && node -e \"require('node:fs').chmodSync('dist/cli.js', 0o755)\"",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --test test/*.test.mjs",
+    "start": "node dist/cli.js",
+    "prepack": "npm run build",
+    "lint": "eslint .",
+    "check:version": "node scripts/check-release.mjs",
+    "test:package": "node scripts/test-package.mjs",
+    "test:live": "npm run build && node --test test/live/*.test.mjs"
+  },
+  "dependencies": {
+    "@functional-systems/lambdadb": "0.5.1",
+    "commander": "14.0.3"
+  },
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^22.0.0",
+    "eslint": "^10.10.0",
+    "globals": "^16.5.0",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.70.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/lambdadb/lambdadb-cli.git"
+  },
+  "homepage": "https://github.com/lambdadb/lambdadb-cli#readme",
+  "bugs": {
+    "url": "https://github.com/lambdadb/lambdadb-cli/issues"
+  },
+  "license": "Apache-2.0"
+}