@riffdb/client 0.2.0 → 0.2.2

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { DriverApplicationTransport, type DriverApplicationError, type DriverCompactQueryResult, type DriverPackedQueryResult, type DriverOperation } from "./driver.js";
+import { DriverApplicationTransport, type DriverApplicationError, type DriverApplicationTransportOptions, type DriverBatchResult, type DriverConnectFromEnvOptions, type DriverCompactQueryResult, type DriverInvokeOptions, type DriverPackedQueryResult, type DriverOperation, type DriverResult, type DriverValue, type ResolvedDriverApplicationIdentity } from "./driver.js";
 export type ApplicationValueSchema = {
     readonly kind: "bool" | "i64" | "u64" | "string" | "uuid" | "bytes" | "date" | "timestamp" | "cursor" | "limit";
     readonly maximumBytes?: number;
@@ -51,12 +51,52 @@ export interface ExactDecimalValue {
     readonly coefficientTwosComplement: Uint8Array;
     readonly scale: number;
     readonly precision: number;
+    toString?(): string;
+    toJSON?(): string;
 }
 /** One exact currency value accepted by generated `money<CURRENCY>` fields. */
 export interface ExactMoneyValue<Currency extends string = string> {
     readonly currency: Currency;
     readonly amount: ExactDecimalValue;
+    toString?(): string;
+    toJSON?(): {
+        readonly currency: Currency;
+        readonly amount: string;
+    };
 }
+/** One exact UTC timestamp returned by generated query and command fields. */
+export interface TimestampValue {
+    readonly seconds: bigint;
+    readonly nanos: number;
+    toISOString(): string;
+    toDate(): Date;
+    toJSON(): string;
+    toString(): string;
+}
+export type TimestampInput = TimestampValue | {
+    readonly seconds: bigint | number | string;
+    readonly nanos?: number;
+} | Date | string;
+export type IntegerInput = bigint | number | string;
+export declare class RiffTimestamp implements TimestampValue {
+    readonly seconds: bigint;
+    readonly nanos: number;
+    constructor(seconds: bigint, nanos?: number);
+    static from(value: TimestampInput): TimestampValue;
+    static now(): TimestampValue;
+    toISOString(): string;
+    toDate(): Date;
+    toJSON(): string;
+    toString(): string;
+}
+export declare function createTimestampValue(seconds: bigint, nanos: number): TimestampValue;
+export declare function formatTimestampIso(seconds: bigint, nanos: number): string;
+export declare function formatExactDecimal(value: {
+    readonly coefficientTwosComplement: Uint8Array;
+    readonly scale: number;
+}): string;
+export declare function toJsonValue(value: unknown, key?: string): unknown;
+export declare function attachRecordToJson<T extends Record<string, unknown>>(record: T): T;
 /**
  * Constructs an exact fixed-point value from decimal text without using a
  * JavaScript floating-point number.
@@ -198,8 +238,10 @@ export interface ContextualBatch<E> {
     readonly status: ReactiveConsumerStatus;
 }
 export interface ReactiveConsumerStatus {
+    readonly kind?: "exact" | "protected";
     readonly revision: bigint;
     readonly checkpoint: string;
+    readonly progressCursor?: string;
     readonly historyIncarnation: bigint;
     readonly liveLeases: number;
     readonly retries: number;
@@ -294,8 +336,15 @@ export declare class CliApplicationTransport {
 export declare class DriverGeneratedApplicationTransport {
     private readonly driver;
     constructor(driver: DriverApplicationTransport);
+    static connect(options: DriverApplicationTransportOptions): Promise<DriverGeneratedApplicationTransport>;
+    static connectFromEnv(options?: DriverConnectFromEnvOptions): Promise<DriverGeneratedApplicationTransport>;
     /** Returns the bound tenant identifier when this session is tenant-scoped. */
     get tenant(): string | undefined;
+    /** Returns the resolved application identity verified during driver handshake. */
+    get identity(): ResolvedDriverApplicationIdentity;
+    invoke(operation: DriverOperation, input: Readonly<Record<string, DriverValue>>, options?: DriverInvokeOptions): Promise<DriverResult>;
+    batch(operation: DriverOperation, items: ReadonlyArray<Readonly<Record<string, DriverValue>>>, concurrency: number, checkpoint: number, options?: DriverInvokeOptions): Promise<DriverBatchResult>;
+    shutdown(): Promise<void>;
     executeNamedQuery<P, R>(request: NamedQueryRequest<P, R>, options?: QueryOptions): Promise<TypedQueryResult<R>>;
     executeCommand<I, R>(request: CommandRequest<I, R>, attemptBudget: number): Promise<TypedCommandResult<R>>;
     executeVectorInspection<P, R>(request: VectorInspectionRequest<P, R>, options?: VectorInspectionOptions): Promise<TypedVectorInspectionResult<R>>;
@@ -328,5 +377,39 @@ export declare class DriverGeneratedApplicationTransport {
     }): AsyncIterable<LiveQueryUpdate<T>>;
     private mutateDriverLease;
 }
-export { DRIVER_ERROR_REGISTRY_HASH, DRIVER_PROTOCOL_VERSION, DRIVER_VALUE_REGISTRY_HASH, DriverApplicationError, DriverApplicationTransport, } from "./driver.js";
-export type { DriverApplicationIdentity, DriverApplicationTransportOptions, DriverBatchItem, DriverBatchResult, DriverBatchSuccess, DriverDecimal, DriverErrorDetails, DriverInvokeOptions, DriverMoney, DriverOperation, DriverPackedColumn, DriverPackedQueryResult, DriverResult, DriverTimestamp, DriverValue, } from "./driver.js";
+declare module "./driver.js" {
+    interface DriverApplicationTransport {
+        executeNamedQuery<P, R>(request: NamedQueryRequest<P, R>, options?: QueryOptions): Promise<TypedQueryResult<R>>;
+        executeCommand<I, R>(request: CommandRequest<I, R>, attemptBudget: number): Promise<TypedCommandResult<R>>;
+        executeVectorInspection<P, R>(request: VectorInspectionRequest<P, R>, options?: VectorInspectionOptions): Promise<TypedVectorInspectionResult<R>>;
+        executeCommandBatch<I, R>(request: CommandRequest<I, R>, inputs: ReadonlyArray<I>, concurrency: number, checkpoint: number, attemptBudget: number): Promise<{
+            readonly items: ReadonlyArray<{
+                readonly index: number;
+                readonly result?: TypedCommandResult<R>;
+                readonly error?: DriverApplicationError;
+            }>;
+            readonly checkpoint: number;
+        }>;
+        consumeEventStream<P, E>(request: ReactiveConsumerRequest<P>, options?: ReactiveConsumerOptions): AsyncIterable<ReactiveConsumerBatch<E>>;
+        acknowledgeEvent<P>(request: ReactiveConsumerRequest<P>, delivery: ReactiveEventDelivery<unknown>): Promise<ReactiveEventMutationResult>;
+        negativeAcknowledgeEvent<P>(request: ReactiveConsumerRequest<P>, delivery: ReactiveEventDelivery<unknown>, retryDelayMs?: number): Promise<ReactiveEventMutationResult>;
+        seekEventConsumer<P>(request: ReactiveConsumerRequest<P>, checkpoint: string): Promise<ReactiveEventMutationResult>;
+        eventConsumerStatus<P>(request: ReactiveConsumerRequest<P>): Promise<ReactiveConsumerStatus | undefined>;
+        consumeContextualSubscription<P, E>(request: ReactiveConsumerRequest<P>, maximumWaitMs?: number, signal?: AbortSignal): Promise<ContextualBatch<E>>;
+        acknowledgeContextualItem<P>(request: ReactiveConsumerRequest<P>, item: ContextualWorkItem<unknown>): Promise<ReactiveEventMutationResult>;
+        negativeAcknowledgeContextualItem<P>(request: ReactiveConsumerRequest<P>, item: ContextualWorkItem<unknown>, retryDelayMs?: number): Promise<ReactiveEventMutationResult>;
+        contextualSubscriptionStatus<P>(request: ReactiveConsumerRequest<P>): Promise<ReactiveConsumerStatus | undefined>;
+        executeContextualReaction<P, I, R>(request: ReactiveConsumerRequest<P>, reaction: ContextualReaction, command: CommandRequest<I, R>): Promise<TypedCommandResult<R>>;
+        watchNamedQuery<P, T>(request: {
+            readonly driverOperations?: Readonly<Record<string, DriverOperation>>;
+            readonly reactiveModuleHash: string;
+            readonly operationName: string;
+            readonly parameters: P;
+            readonly parameterSchema: ApplicationValueSchema;
+            readonly cursor?: string;
+            readonly signal?: AbortSignal;
+        }): AsyncIterable<LiveQueryUpdate<T>>;
+    }
+}
+export { DRIVER_ERROR_REGISTRY_HASH, DRIVER_PROTOCOL_VERSION, DRIVER_VALUE_REGISTRY_HASH, DriverApplicationError, DriverApplicationTransport, resolveTransportOptionsFromEnv, } from "./driver.js";
+export type { DriverApplicationIdentity, DriverApplicationTransportOptions, DriverConnectFromEnvOptions, DriverBatchItem, DriverBatchResult, DriverBatchSuccess, DriverDecimal, DriverErrorDetails, DriverInvokeOptions, DriverMoney, DriverOperation, DriverPackedColumn, DriverPackedQueryResult, DriverResult, DriverTimestamp, DriverValue, ResolvedDriverApplicationIdentity, } from "./driver.js";