camusdb 0.1.0

package/dist/transport/grpc/messages.d.ts

@@ -0,0 +1,221 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+/**
+ * The shapes `@grpc/proto-loader` builds from `camus_sql.proto`.
+ *
+ * The loader constructs these at run time, so they carry no types of their own. Writing them out
+ * here is what keeps the rest of the gRPC transport type-checked: a renamed field is then a
+ * compile error in one file rather than an `undefined` at run time.
+ *
+ * Two loader settings shape every declaration below. A 64-bit field arrives as a decimal string,
+ * because a JavaScript number cannot name every 64-bit integer. A `oneof` adds a discriminator
+ * field naming the branch that is set.
+ */
+/** A 64-bit field on the wire. The loader writes one as a decimal string. */
+export type Int64Wire = string;
+export declare const GrpcColumnType: {
+    readonly Null: 0;
+    readonly Id: 1;
+    readonly Integer64: 2;
+    readonly String: 3;
+    readonly Bool: 4;
+    readonly Float64: 5;
+    readonly Float32: 6;
+    readonly Bytes: 7;
+    readonly Date: 8;
+    readonly DateTime: 9;
+    readonly Array: 10;
+    readonly Uuid: 11;
+};
+export declare const GrpcIsolationLevel: {
+    readonly Unspecified: 0;
+    readonly ReadCommitted: 1;
+    readonly Serializable: 2;
+};
+export declare const GrpcTransactionMode: {
+    readonly Unspecified: 0;
+    readonly ReadWrite: 1;
+    readonly ReadOnly: 2;
+};
+export declare const GrpcLockingMode: {
+    readonly Unspecified: 0;
+    readonly Pessimistic: 1;
+    readonly Optimistic: 2;
+};
+export declare const GrpcRoutingDisposition: {
+    readonly Unspecified: 0;
+    readonly Prefer: 1;
+    readonly Clear: 2;
+};
+export declare const GrpcRoutingReuseScope: {
+    readonly Unspecified: 0;
+    readonly StatementParametersIndependent: 1;
+};
+/** Which branch of `Value.kind` is set. It is the field name, as the loader spells it. */
+export type ValueKind = 'nullValue' | 'idValue' | 'int64Value' | 'stringValue' | 'boolValue' | 'float64Value' | 'float32Value' | 'bytesValue' | 'dateValue' | 'datetimeValue' | 'arrayValue' | 'uuidValue';
+export interface GrpcValue {
+    kind?: ValueKind | undefined;
+    nullValue?: number;
+    idValue?: string;
+    int64Value?: Int64Wire;
+    stringValue?: string;
+    boolValue?: boolean;
+    float64Value?: number;
+    float32Value?: number;
+    bytesValue?: Buffer;
+    dateValue?: Int64Wire;
+    datetimeValue?: Int64Wire;
+    arrayValue?: GrpcArrayValue;
+    uuidValue?: Buffer;
+}
+export interface GrpcArrayValue {
+    elementType: number;
+    items: GrpcValue[];
+}
+export interface GrpcColumnSchema {
+    name: string;
+    type: number;
+}
+export interface GrpcResultSchema {
+    columns: GrpcColumnSchema[];
+}
+export interface GrpcResultRow {
+    values: GrpcValue[];
+}
+export interface GrpcHlcTimestamp {
+    l: Int64Wire;
+    c: number;
+}
+export interface GrpcCacheMetadata {
+    status: string;
+    bypassReason: string;
+    name: string;
+    cachedAtHlc?: GrpcHlcTimestamp | null;
+    ageMs?: Int64Wire | null;
+}
+export interface GrpcRoutingAdviceMessage {
+    version: number;
+    disposition: number;
+    preferredNodeId: string;
+    reuseScope: number;
+    dependencyToken: string;
+    maxAgeMs: number;
+    provenance: string;
+    reason: string;
+}
+export interface GrpcTxnHandle {
+    txnIdPt: Int64Wire;
+    txnIdCounter: number;
+    causalTokenN: number;
+    causalTokenL: Int64Wire;
+    causalTokenC: Int64Wire;
+}
+export interface GrpcSqlRequest {
+    database?: string;
+    sql?: string;
+    parameters?: Record<string, GrpcValue>;
+    txnHandle?: GrpcTxnHandle | null;
+    isolationLevel?: number;
+    transactionMode?: number;
+    locking?: number;
+    causalTokenL?: Int64Wire;
+    causalTokenC?: Int64Wire;
+    causalTokenN?: number;
+    statementId?: number;
+    positionalParameters?: GrpcValue[];
+    priority?: number;
+    routingAcceptVersion?: number;
+}
+export interface GrpcNonQueryReply {
+    affectedRows: number;
+    causalTokenL: Int64Wire;
+    causalTokenC: Int64Wire;
+    causalTokenN: number;
+    warning: string;
+    routing?: GrpcRoutingAdviceMessage | null;
+}
+export interface GrpcDdlReply {
+    causalTokenL: Int64Wire;
+    causalTokenC: Int64Wire;
+    causalTokenN: number;
+    affectedRows: number;
+    warning: string;
+}
+export interface GrpcCommitReply {
+    causalTokenL: Int64Wire;
+    causalTokenC: Int64Wire;
+    causalTokenN: number;
+}
+export interface GrpcPrepareReply {
+    statementId: number;
+    parameterNames: string[];
+}
+export interface GrpcQueryComplete {
+    total: Int64Wire;
+    causalTokenL: Int64Wire;
+    causalTokenC: Int64Wire;
+    causalTokenN: number;
+    cacheMetadata?: GrpcCacheMetadata | null;
+    routing?: GrpcRoutingAdviceMessage | null;
+}
+export interface GrpcBatchError {
+    code: string;
+    message: string;
+}
+/** The statement kinds `BatchExecute` multiplexes over one stream. */
+export declare const GrpcBatchStatementKind: {
+    readonly Unspecified: 0;
+    readonly Query: 1;
+    readonly NonQuery: 2;
+    readonly Start: 3;
+    readonly Commit: 4;
+    readonly Rollback: 5;
+    readonly Prepare: 6;
+    readonly Close: 7;
+};
+export type GrpcBatchStatementKind = (typeof GrpcBatchStatementKind)[keyof typeof GrpcBatchStatementKind];
+export interface GrpcBatchExecuteRequest {
+    requestId: number;
+    kind: GrpcBatchStatementKind;
+    request: GrpcSqlRequest;
+}
+/** Which branch of `BatchExecuteResponse.payload` is set. */
+export type BatchPayloadCase = 'schema' | 'row' | 'queryComplete' | 'nonQuery' | 'error' | 'startReply' | 'commitReply' | 'rollbackReply' | 'prepareReply' | 'closeReply';
+export interface GrpcBatchExecuteResponse {
+    requestId: number;
+    payload?: BatchPayloadCase | undefined;
+    schema?: GrpcResultSchema;
+    row?: GrpcResultRow;
+    queryComplete?: GrpcQueryComplete;
+    nonQuery?: GrpcNonQueryReply;
+    error?: GrpcBatchError;
+    startReply?: GrpcTxnHandle;
+    commitReply?: GrpcCommitReply;
+    rollbackReply?: Record<string, never>;
+    prepareReply?: GrpcPrepareReply;
+    closeReply?: Record<string, never>;
+}
+export interface GrpcLoginReply {
+    token: string;
+    expiresAtUnixMs: Int64Wire;
+    expiresInSeconds: Int64Wire;
+}
+export interface GrpcPingReply {
+    message: string;
+}
+export interface GrpcInsertRowRequest {
+    database: string;
+    table: string;
+    values: Record<string, GrpcValue>;
+    txnHandle?: GrpcTxnHandle | null;
+    causalTokenL?: Int64Wire;
+    causalTokenC?: Int64Wire;
+    causalTokenN?: number;
+    locking?: number;
+    priority?: number;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/transport/grpc/messages.d.ts.map

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

package/dist/transport/grpc/messages.js

@@ -0,0 +1,56 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+export const GrpcColumnType = {
+    Null: 0,
+    Id: 1,
+    Integer64: 2,
+    String: 3,
+    Bool: 4,
+    Float64: 5,
+    Float32: 6,
+    Bytes: 7,
+    Date: 8,
+    DateTime: 9,
+    Array: 10,
+    Uuid: 11,
+};
+export const GrpcIsolationLevel = {
+    Unspecified: 0,
+    ReadCommitted: 1,
+    Serializable: 2,
+};
+export const GrpcTransactionMode = {
+    Unspecified: 0,
+    ReadWrite: 1,
+    ReadOnly: 2,
+};
+export const GrpcLockingMode = {
+    Unspecified: 0,
+    Pessimistic: 1,
+    Optimistic: 2,
+};
+export const GrpcRoutingDisposition = {
+    Unspecified: 0,
+    Prefer: 1,
+    Clear: 2,
+};
+export const GrpcRoutingReuseScope = {
+    Unspecified: 0,
+    StatementParametersIndependent: 1,
+};
+/** The statement kinds `BatchExecute` multiplexes over one stream. */
+export const GrpcBatchStatementKind = {
+    Unspecified: 0,
+    Query: 1,
+    NonQuery: 2,
+    Start: 3,
+    Commit: 4,
+    Rollback: 5,
+    Prepare: 6,
+    Close: 7,
+};
+//# sourceMappingURL=messages.js.map

package/dist/transport/grpc/messages.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.js","sourceRoot":"","sources":["../../../src/transport/grpc/messages.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAiBH,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,IAAI,EAAE,CAAC;IACP,EAAE,EAAE,CAAC;IACL,SAAS,EAAE,CAAC;IACZ,MAAM,EAAE,CAAC;IACT,IAAI,EAAE,CAAC;IACP,OAAO,EAAE,CAAC;IACV,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;IACR,IAAI,EAAE,CAAC;IACP,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,WAAW,EAAE,CAAC;IACd,aAAa,EAAE,CAAC;IAChB,YAAY,EAAE,CAAC;CACP,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,WAAW,EAAE,CAAC;IACd,SAAS,EAAE,CAAC;IACZ,QAAQ,EAAE,CAAC;CACH,CAAC;AAEX,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,WAAW,EAAE,CAAC;IACd,WAAW,EAAE,CAAC;IACd,UAAU,EAAE,CAAC;CACL,CAAC;AAEX,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE,CAAC;IACd,MAAM,EAAE,CAAC;IACT,KAAK,EAAE,CAAC;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACnC,WAAW,EAAE,CAAC;IACd,8BAA8B,EAAE,CAAC;CACzB,CAAC;AA8IX,sEAAsE;AACtE,MAAM,CAAC,MAAM,sBAAsB,GAAG;IACpC,WAAW,EAAE,CAAC;IACd,KAAK,EAAE,CAAC;IACR,QAAQ,EAAE,CAAC;IACX,KAAK,EAAE,CAAC;IACR,MAAM,EAAE,CAAC;IACT,QAAQ,EAAE,CAAC;IACX,OAAO,EAAE,CAAC;IACV,KAAK,EAAE,CAAC;CACA,CAAC"}

package/dist/transport/grpc/proto.d.ts

@@ -0,0 +1,71 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+/**
+ * Loads the gRPC service definitions from `camus_sql.proto` — the same file that is the server's
+ * source of truth, so the REST and gRPC surfaces cannot drift apart.
+ *
+ * `@grpc/grpc-js` and `@grpc/proto-loader` are optional peer dependencies. A REST client is the
+ * common case and must not have to install a gRPC stack it will never open, so both are imported
+ * only when a gRPC client is actually built, and a missing one is reported with the command that
+ * installs it.
+ */
+/** The generated client stubs, kept as loose shapes because proto-loader builds them at run time. */
+export interface CamusGrpcClients {
+    readonly sql: GrpcServiceClient;
+    readonly auth: GrpcServiceClient;
+    readonly rows: GrpcServiceClient;
+    readonly close: () => void;
+}
+/** Enough of a grpc-js client to call it. The method names come from the service definition. */
+export interface GrpcServiceClient {
+    [method: string]: unknown;
+    close?: () => void;
+}
+/** The subset of `@grpc/grpc-js` this driver uses. */
+export interface GrpcRuntime {
+    readonly credentials: {
+        createInsecure: () => unknown;
+        createSsl: () => unknown;
+    };
+    readonly Metadata: new () => GrpcMetadata;
+    readonly loadPackageDefinition: (definition: unknown) => Record<string, unknown>;
+    readonly status: Record<string, number>;
+}
+export interface GrpcMetadata {
+    set: (key: string, value: string) => void;
+    get: (key: string) => (string | Buffer)[];
+}
+/** A duplex call as grpc-js hands it back. */
+export interface GrpcDuplexCall<TRequest, TResponse> {
+    write: (message: TRequest, callback?: (error?: Error | null) => void) => boolean;
+    end: () => void;
+    cancel: () => void;
+    on: ((event: 'data', listener: (message: TResponse) => void) => void) & ((event: 'error', listener: (error: GrpcStatusError) => void) => void) & ((event: 'end' | 'close', listener: () => void) => void);
+    once: (event: string, listener: (...args: never[]) => void) => void;
+    removeAllListeners: () => void;
+}
+/** A gRPC failure as grpc-js raises it. */
+export interface GrpcStatusError extends Error {
+    readonly code?: number;
+    readonly details?: string;
+    readonly metadata?: GrpcMetadata;
+}
+interface LoadedRuntime {
+    readonly runtime: GrpcRuntime;
+    readonly definition: Record<string, unknown>;
+}
+/**
+ * The gRPC runtime and the parsed service definitions, loaded once per process.
+ *
+ * Parsing the proto file costs real work and the result is immutable, so it is memoized. A failed
+ * load is not memoized, so a missing dependency installed later is picked up without a restart.
+ */
+export declare function loadGrpc(): Promise<LoadedRuntime>;
+/** The constructor for one service, taken from the loaded definitions. */
+export declare function serviceConstructor(definition: Record<string, unknown>, serviceName: string): new (address: string, credentials: unknown, options?: unknown) => GrpcServiceClient;
+export {};
+//# sourceMappingURL=proto.d.ts.map

package/dist/transport/grpc/proto.d.ts.map

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

package/dist/transport/grpc/proto.js

@@ -0,0 +1,67 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import { fileURLToPath } from 'node:url';
+import { CamusError } from '../../errors.js';
+import { CamusErrorCode } from '../../error-codes.js';
+let loaded;
+/**
+ * The gRPC runtime and the parsed service definitions, loaded once per process.
+ *
+ * Parsing the proto file costs real work and the result is immutable, so it is memoized. A failed
+ * load is not memoized, so a missing dependency installed later is picked up without a restart.
+ */
+export async function loadGrpc() {
+    loaded ??= loadOnce().catch((error) => {
+        loaded = undefined;
+        throw error;
+    });
+    return loaded;
+}
+async function loadOnce() {
+    const runtime = (await importOptional('@grpc/grpc-js'));
+    const protoLoader = (await importOptional('@grpc/proto-loader'));
+    const packageDefinition = protoLoader.loadSync(protoPath(), {
+        keepCase: false,
+        // A 64-bit field arrives as a decimal string and is converted to a bigint here. Reading it as
+        // a JavaScript number would round any value above 2^53, and this driver's whole int64 contract
+        // rests on that not happening.
+        longs: String,
+        enums: Number,
+        bytes: Buffer,
+        defaults: true,
+        oneofs: true,
+    });
+    return { runtime, definition: runtime.loadPackageDefinition(packageDefinition) };
+}
+async function importOptional(specifier) {
+    try {
+        return (await import(specifier));
+    }
+    catch (error) {
+        throw new CamusError(CamusErrorCode.Generic, `The gRPC transport needs the optional package '${specifier}'. Install it with ` +
+            "'npm install @grpc/grpc-js @grpc/proto-loader', or use the REST protocol.", { cause: error });
+    }
+}
+/**
+ * Where `camus_sql.proto` lives, relative to this module.
+ *
+ * The path holds for both the compiled layout (`dist/transport/grpc/`) and the source layout
+ * (`src/transport/grpc/`), because both sit three levels below the package root, and `proto/` is
+ * listed in the package's published files.
+ */
+function protoPath() {
+    return fileURLToPath(new URL('../../../proto/camus_sql.proto', import.meta.url));
+}
+/** The constructor for one service, taken from the loaded definitions. */
+export function serviceConstructor(definition, serviceName) {
+    const service = definition[serviceName];
+    if (typeof service !== 'function') {
+        throw new CamusError(CamusErrorCode.Generic, `camus_sql.proto declares no service named '${serviceName}'.`);
+    }
+    return service;
+}
+//# sourceMappingURL=proto.js.map

package/dist/transport/grpc/proto.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proto.js","sourceRoot":"","sources":["../../../src/transport/grpc/proto.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAkEtD,IAAI,MAA0C,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,KAAK,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC7C,MAAM,GAAG,SAAS,CAAC;QACnB,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,OAAO,GAAG,CAAC,MAAM,cAAc,CAAC,eAAe,CAAC,CAAgB,CAAC;IACvE,MAAM,WAAW,GAAG,CAAC,MAAM,cAAc,CAAC,oBAAoB,CAAC,CAE9D,CAAC;IAEF,MAAM,iBAAiB,GAAG,WAAW,CAAC,QAAQ,CAAC,SAAS,EAAE,EAAE;QAC1D,QAAQ,EAAE,KAAK;QACf,8FAA8F;QAC9F,+FAA+F;QAC/F,+BAA+B;QAC/B,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,IAAI;KACb,CAAC,CAAC;IAEH,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,qBAAqB,CAAC,iBAAiB,CAAC,EAAE,CAAC;AACnF,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,SAAiB;IAC7C,IAAI,CAAC;QACH,OAAO,CAAC,MAAM,MAAM,CAAC,SAAS,CAAC,CAAY,CAAC;IAC9C,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,OAAO,EACtB,kDAAkD,SAAS,qBAAqB;YAC9E,2EAA2E,EAC7E,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED;;;;;;GAMG;AACH,SAAS,SAAS;IAChB,OAAO,aAAa,CAAC,IAAI,GAAG,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACnF,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,kBAAkB,CAChC,UAAmC,EACnC,WAAmB;IAEnB,MAAM,OAAO,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAExC,IAAI,OAAO,OAAO,KAAK,UAAU,EAAE,CAAC;QAClC,MAAM,IAAI,UAAU,CAClB,cAAc,CAAC,OAAO,EACtB,8CAA8C,WAAW,IAAI,CAC9D,CAAC;IACJ,CAAC;IAED,OAAO,OAA8F,CAAC;AACxG,CAAC"}

package/dist/transport/http.d.ts

@@ -0,0 +1,62 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import type { CamusEndpointPool } from '../endpoint-pool.js';
+import { CamusError } from '../errors.js';
+/** How one HTTP call is made. */
+export interface HttpRequestInit {
+    /** The base URL of the node to call. */
+    readonly endpoint: string;
+    /** Path segments appended to the base URL. */
+    readonly path: readonly string[];
+    readonly method: 'GET' | 'POST';
+    /** The body, serialized with `stringifyLossless` so a 64-bit value stays exact. */
+    readonly body?: unknown;
+    /** Query string values. */
+    readonly query?: Readonly<Record<string, string>> | undefined;
+    /** The bearer token to present, when the client has one. */
+    readonly token?: string | undefined;
+    /** The `Accept` header. Defaults to `application/json`. */
+    readonly accept?: string | undefined;
+    /** How long to wait before giving up. Zero or less means no deadline. */
+    readonly timeoutSeconds: number;
+    /** The caller's own cancellation. */
+    readonly signal?: AbortSignal | undefined;
+}
+/**
+ * An HTTP response whose body has not been read yet. The streaming query endpoint needs the raw
+ * body, and every other route reads it as JSON.
+ */
+export interface HttpResponse {
+    readonly status: number;
+    readonly response: Response;
+}
+/**
+ * Sends one request and reports the response, whatever its status.
+ *
+ * A failure to reach the node at all — a refused connection, a DNS failure, a deadline — is turned
+ * into a `CamusError` here, and the endpoint is set aside in the pool. A non-2xx status is left to
+ * the caller, because only the caller knows whether the route treats one as an error.
+ *
+ * A cancellation the caller asked for is re-thrown as it is. It is not a database failure, the
+ * node is not unreachable, and turning it into a `CamusError` would hide the caller's own intent.
+ */
+export declare function sendHttp(pool: CamusEndpointPool | undefined, init: HttpRequestInit): Promise<HttpResponse>;
+/** Sends a request and reads a JSON body. A non-2xx status becomes a `CamusError`. */
+export declare function sendJson<T>(pool: CamusEndpointPool | undefined, init: HttpRequestInit): Promise<T>;
+/**
+ * Turns a failed HTTP call into a `CamusError`.
+ *
+ * The server's `{status, code, message}` body is preferred — it carries the `CADBxxxx` code the
+ * client layer keys its retry and refresh decisions off — falling back to the raw response text
+ * and finally to the status line. Every message the far end supplied goes through
+ * `sanitizeErrorText` first: the text ends in an exception that applications log verbatim, and
+ * none of it is this driver's.
+ */
+export declare function translateErrorBody(status: number, text: string): CamusError;
+/** Reads a body as text, reporting an empty string when it cannot be read. */
+export declare function readBody(response: Response): Promise<string>;
+//# sourceMappingURL=http.d.ts.map

package/dist/transport/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/transport/http.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAK1C,iCAAiC;AACjC,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,8CAA8C;IAC9C,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IAEjC,QAAQ,CAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IAEhC,mFAAmF;IACnF,QAAQ,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC;IAExB,2BAA2B;IAC3B,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAAG,SAAS,CAAC;IAE9D,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAEpC,2DAA2D;IAC3D,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAErC,yEAAyE;IACzE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAEhC,qCAAqC;IACrC,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC3C;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;CAC7B;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,iBAAiB,GAAG,SAAS,EACnC,IAAI,EAAE,eAAe,GACpB,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAED,sFAAsF;AACtF,wBAAsB,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,GAAG,SAAS,EAAE,IAAI,EAAE,eAAe,GAAG,OAAO,CAAC,CAAC,CAAC,CAgBxG;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,CAuB3E;AAED,8EAA8E;AAC9E,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAMlE"}

package/dist/transport/http.js

@@ -0,0 +1,169 @@
+/**
+ * This file is part of CamusDB
+ *
+ * For the full copyright and license information, please view the LICENSE.txt
+ * file that was distributed with this source code.
+ */
+import { CamusError } from '../errors.js';
+import { CamusErrorCode } from '../error-codes.js';
+import { parseLossless, stringifyLossless } from '../json.js';
+import { sanitizeErrorText } from './error-text.js';
+/**
+ * Sends one request and reports the response, whatever its status.
+ *
+ * A failure to reach the node at all — a refused connection, a DNS failure, a deadline — is turned
+ * into a `CamusError` here, and the endpoint is set aside in the pool. A non-2xx status is left to
+ * the caller, because only the caller knows whether the route treats one as an error.
+ *
+ * A cancellation the caller asked for is re-thrown as it is. It is not a database failure, the
+ * node is not unreachable, and turning it into a `CamusError` would hide the caller's own intent.
+ */
+export async function sendHttp(pool, init) {
+    const url = buildUrl(init.endpoint, init.path, init.query);
+    const headers = { Accept: init.accept ?? 'application/json' };
+    let body;
+    if (init.body !== undefined) {
+        headers['Content-Type'] = 'application/json';
+        body = stringifyLossless(init.body);
+    }
+    if (init.token !== undefined && init.token.length > 0) {
+        headers.Authorization = `Bearer ${init.token}`;
+    }
+    const { signal, dispose } = combineSignals(init.timeoutSeconds, init.signal);
+    try {
+        const response = await fetch(url, {
+            method: init.method,
+            headers,
+            ...(body === undefined ? {} : { body }),
+            signal: signal ?? null,
+            // A driver must never follow a redirect: a redirected statement would leave the endpoint the
+            // operator configured, taking its bearer token with it.
+            redirect: 'error',
+        });
+        return { status: response.status, response };
+    }
+    catch (error) {
+        // The caller ended the request. That is not a transport failure and the node is fine.
+        if (init.signal?.aborted === true)
+            throw error;
+        pool?.markUnreachable(init.endpoint);
+        throw new CamusError(CamusErrorCode.Generic, describeTransportFailure(url, error), { cause: error });
+    }
+    finally {
+        dispose();
+    }
+}
+/** Sends a request and reads a JSON body. A non-2xx status becomes a `CamusError`. */
+export async function sendJson(pool, init) {
+    const { response } = await sendHttp(pool, init);
+    const text = await readBody(response);
+    if (!response.ok)
+        throw translateErrorBody(response.status, text);
+    if (text.length === 0) {
+        throw new CamusError(CamusErrorCode.Generic, 'Empty result returned');
+    }
+    try {
+        return parseLossless(text);
+    }
+    catch (error) {
+        throw new CamusError(CamusErrorCode.Generic, 'Empty result returned', { cause: error });
+    }
+}
+/**
+ * Turns a failed HTTP call into a `CamusError`.
+ *
+ * The server's `{status, code, message}` body is preferred — it carries the `CADBxxxx` code the
+ * client layer keys its retry and refresh decisions off — falling back to the raw response text
+ * and finally to the status line. Every message the far end supplied goes through
+ * `sanitizeErrorText` first: the text ends in an exception that applications log verbatim, and
+ * none of it is this driver's.
+ */
+export function translateErrorBody(status, text) {
+    if (text.length > 0) {
+        try {
+            const body = parseLossless(text);
+            if (typeof body === 'object' && body !== null) {
+                const record = body;
+                if (typeof record.code === 'string' || typeof record.message === 'string') {
+                    return new CamusError(typeof record.code === 'string' ? record.code : CamusErrorCode.Generic, sanitizeErrorText(typeof record.message === 'string' ? record.message : ''));
+                }
+            }
+        }
+        catch {
+            // Not a JSON error envelope. The raw text is the next best diagnosis.
+        }
+        return new CamusError(CamusErrorCode.Generic, sanitizeErrorText(text));
+    }
+    return new CamusError(CamusErrorCode.Generic, `The server answered HTTP ${String(status)} with no body.`);
+}
+/** Reads a body as text, reporting an empty string when it cannot be read. */
+export async function readBody(response) {
+    try {
+        return await response.text();
+    }
+    catch {
+        return '';
+    }
+}
+function buildUrl(endpoint, path, query) {
+    let base = endpoint.trim();
+    if (!base.endsWith('/'))
+        base += '/';
+    const url = new URL(path.map((segment) => encodeURIComponent(segment)).join('/'), base);
+    if (query !== undefined) {
+        for (const [key, value] of Object.entries(query))
+            url.searchParams.set(key, value);
+    }
+    return url.toString();
+}
+/**
+ * One signal that ends the request when either the deadline passes or the caller cancels.
+ *
+ * `AbortSignal.any` keeps a strong reference to its inputs, and a timeout signal keeps a timer
+ * alive, so both are released once the request settles.
+ */
+function combineSignals(timeoutSeconds, callerSignal) {
+    const hasTimeout = timeoutSeconds > 0;
+    if (!hasTimeout)
+        return { signal: callerSignal, dispose: () => undefined };
+    const controller = new AbortController();
+    const timer = setTimeout(() => {
+        controller.abort(new CamusError(CamusErrorCode.Generic, `The request timed out after ${String(timeoutSeconds)}s.`));
+    }, timeoutSeconds * 1000);
+    // Node keeps the process alive for a pending timer; a driver's deadline must not do that.
+    timer.unref?.();
+    if (callerSignal === undefined) {
+        return { signal: controller.signal, dispose: () => clearTimeout(timer) };
+    }
+    const onAbort = () => controller.abort(callerSignal.reason);
+    if (callerSignal.aborted)
+        onAbort();
+    else
+        callerSignal.addEventListener('abort', onAbort, { once: true });
+    return {
+        signal: controller.signal,
+        dispose: () => {
+            clearTimeout(timer);
+            callerSignal.removeEventListener('abort', onAbort);
+        },
+    };
+}
+function describeTransportFailure(url, error) {
+    // The URL is this driver's own, not the far end's, so it is safe to name. The error text is not:
+    // fetch puts the request URL, and sometimes headers, in its own message.
+    const detail = error instanceof Error ? sanitizeErrorText(error.message) : '';
+    const cause = error?.cause?.code;
+    const host = safeHost(url);
+    if (cause !== undefined)
+        return `Cannot reach ${host}: ${cause}`;
+    return detail.length > 0 ? `Cannot reach ${host}: ${detail}` : `Cannot reach ${host}.`;
+}
+function safeHost(url) {
+    try {
+        return new URL(url).origin;
+    }
+    catch {
+        return 'the CamusDB endpoint';
+    }
+}
+//# sourceMappingURL=http.js.map