@kurrent/kurrentdb-client 1.0.4 → 1.1.1

package/generated/kurrentdb/protocols/v2/streams/streams_grpc_pb.d.ts

@@ -0,0 +1,44 @@
+// package: kurrentdb.protocol.v2.streams
+// file: kurrentdb/protocols/v2/streams/streams.proto
+
+/* tslint:disable */
+/* eslint-disable */
+
+import * as grpc from "@grpc/grpc-js";
+import * as kurrentdb_protocols_v2_streams_streams_pb from "../../../../kurrentdb/protocols/v2/streams/streams_pb";
+import * as google_protobuf_struct_pb from "google-protobuf/google/protobuf/struct_pb";
+
+interface IStreamsServiceService extends grpc.ServiceDefinition<grpc.UntypedServiceImplementation> {
+    appendSession: IStreamsServiceService_IAppendSession;
+}
+
+interface IStreamsServiceService_IAppendSession extends grpc.MethodDefinition<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest, kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse> {
+    path: "/kurrentdb.protocol.v2.streams.StreamsService/AppendSession";
+    requestStream: true;
+    responseStream: false;
+    requestSerialize: grpc.serialize<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    requestDeserialize: grpc.deserialize<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    responseSerialize: grpc.serialize<kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse>;
+    responseDeserialize: grpc.deserialize<kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse>;
+}
+
+export const StreamsServiceService: IStreamsServiceService;
+
+export interface IStreamsServiceServer extends grpc.UntypedServiceImplementation {
+    appendSession: grpc.handleClientStreamingCall<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest, kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse>;
+}
+
+export interface IStreamsServiceClient {
+    appendSession(callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    appendSession(metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    appendSession(options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    appendSession(metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+}
+
+export class StreamsServiceClient extends grpc.Client implements IStreamsServiceClient {
+    constructor(address: string, credentials: grpc.ChannelCredentials, options?: Partial<grpc.ClientOptions>);
+    public appendSession(callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    public appendSession(metadata: grpc.Metadata, callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    public appendSession(options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+    public appendSession(metadata: grpc.Metadata, options: Partial<grpc.CallOptions>, callback: (error: grpc.ServiceError | null, response: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse) => void): grpc.ClientWritableStream<kurrentdb_protocols_v2_streams_streams_pb.AppendRequest>;
+}

package/generated/kurrentdb/protocols/v2/streams/streams_grpc_pb.js

@@ -0,0 +1,69 @@
+// GENERATED CODE -- DO NOT EDIT!
+
+// Original file comments:
+// ******************************************************************************************
+// This protocol is UNSTABLE in the sense of being subject to change.
+// ******************************************************************************************
+//
+'use strict';
+var grpc = require('@grpc/grpc-js');
+var kurrentdb_protocols_v2_streams_streams_pb = require('../../../../kurrentdb/protocols/v2/streams/streams_pb.js');
+var google_protobuf_struct_pb = require('google-protobuf/google/protobuf/struct_pb.js');
+
+function serialize_kurrentdb_protocol_v2_streams_AppendRequest(arg) {
+  if (!(arg instanceof kurrentdb_protocols_v2_streams_streams_pb.AppendRequest)) {
+    throw new Error('Expected argument of type kurrentdb.protocol.v2.streams.AppendRequest');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_kurrentdb_protocol_v2_streams_AppendRequest(buffer_arg) {
+  return kurrentdb_protocols_v2_streams_streams_pb.AppendRequest.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+function serialize_kurrentdb_protocol_v2_streams_AppendSessionResponse(arg) {
+  if (!(arg instanceof kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse)) {
+    throw new Error('Expected argument of type kurrentdb.protocol.v2.streams.AppendSessionResponse');
+  }
+  return Buffer.from(arg.serializeBinary());
+}
+
+function deserialize_kurrentdb_protocol_v2_streams_AppendSessionResponse(buffer_arg) {
+  return kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse.deserializeBinary(new Uint8Array(buffer_arg));
+}
+
+
+var StreamsServiceService = exports.StreamsServiceService = {
+  // Appends records to multiple streams atomically within a single transaction.
+//
+// This is a client-streaming RPC where the client sends multiple AppendRequest messages
+// (one per stream) and receives a single AppendSessionResponse upon commit.
+//
+// Guarantees:
+// - Atomicity: All writes succeed or all fail together
+// - Optimistic Concurrency: Expected revisions are validated for all streams before commit
+// - Ordering: Records within each stream maintain send order
+//
+// Current Limitations:
+// - Each stream can only appear once per session (no multiple appends to same stream)
+//
+// Example flow:
+//   1. Client opens stream
+//   2. Client sends AppendRequest for stream "orders" with 3 records
+//   3. Client sends AppendRequest for stream "inventory" with 2 records
+//   4. Client completes the stream
+//   5. Server validates, commits, returns AppendSessionResponse with positions
+appendSession: {
+    path: '/kurrentdb.protocol.v2.streams.StreamsService/AppendSession',
+    requestStream: true,
+    responseStream: false,
+    requestType: kurrentdb_protocols_v2_streams_streams_pb.AppendRequest,
+    responseType: kurrentdb_protocols_v2_streams_streams_pb.AppendSessionResponse,
+    requestSerialize: serialize_kurrentdb_protocol_v2_streams_AppendRequest,
+    requestDeserialize: deserialize_kurrentdb_protocol_v2_streams_AppendRequest,
+    responseSerialize: serialize_kurrentdb_protocol_v2_streams_AppendSessionResponse,
+    responseDeserialize: deserialize_kurrentdb_protocol_v2_streams_AppendSessionResponse,
+  },
+};
+
+exports.StreamsServiceClient = grpc.makeGenericClientConstructor(StreamsServiceService, 'StreamsService');

package/generated/kurrentdb/protocols/v2/streams/streams_pb.d.ts

@@ -0,0 +1,176 @@
+// package: kurrentdb.protocol.v2.streams
+// file: kurrentdb/protocols/v2/streams/streams.proto
+
+/* tslint:disable */
+/* eslint-disable */
+
+import * as jspb from "google-protobuf";
+import * as google_protobuf_struct_pb from "google-protobuf/google/protobuf/struct_pb";
+
+export class AppendRequest extends jspb.Message { 
+    getStream(): string;
+    setStream(value: string): AppendRequest;
+    clearRecordsList(): void;
+    getRecordsList(): Array<AppendRecord>;
+    setRecordsList(value: Array<AppendRecord>): AppendRequest;
+    addRecords(value?: AppendRecord, index?: number): AppendRecord;
+
+    hasExpectedRevision(): boolean;
+    clearExpectedRevision(): void;
+    getExpectedRevision(): string | undefined;
+    setExpectedRevision(value: string): AppendRequest;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): AppendRequest.AsObject;
+    static toObject(includeInstance: boolean, msg: AppendRequest): AppendRequest.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: AppendRequest, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): AppendRequest;
+    static deserializeBinaryFromReader(message: AppendRequest, reader: jspb.BinaryReader): AppendRequest;
+}
+
+export namespace AppendRequest {
+    export type AsObject = {
+        stream: string,
+        recordsList: Array<AppendRecord.AsObject>,
+        expectedRevision?: string,
+    }
+}
+
+export class AppendResponse extends jspb.Message { 
+    getStream(): string;
+    setStream(value: string): AppendResponse;
+    getStreamRevision(): string;
+    setStreamRevision(value: string): AppendResponse;
+
+    hasPosition(): boolean;
+    clearPosition(): void;
+    getPosition(): string | undefined;
+    setPosition(value: string): AppendResponse;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): AppendResponse.AsObject;
+    static toObject(includeInstance: boolean, msg: AppendResponse): AppendResponse.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: AppendResponse, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): AppendResponse;
+    static deserializeBinaryFromReader(message: AppendResponse, reader: jspb.BinaryReader): AppendResponse;
+}
+
+export namespace AppendResponse {
+    export type AsObject = {
+        stream: string,
+        streamRevision: string,
+        position?: string,
+    }
+}
+
+export class AppendSessionResponse extends jspb.Message { 
+    clearOutputList(): void;
+    getOutputList(): Array<AppendResponse>;
+    setOutputList(value: Array<AppendResponse>): AppendSessionResponse;
+    addOutput(value?: AppendResponse, index?: number): AppendResponse;
+    getPosition(): string;
+    setPosition(value: string): AppendSessionResponse;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): AppendSessionResponse.AsObject;
+    static toObject(includeInstance: boolean, msg: AppendSessionResponse): AppendSessionResponse.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: AppendSessionResponse, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): AppendSessionResponse;
+    static deserializeBinaryFromReader(message: AppendSessionResponse, reader: jspb.BinaryReader): AppendSessionResponse;
+}
+
+export namespace AppendSessionResponse {
+    export type AsObject = {
+        outputList: Array<AppendResponse.AsObject>,
+        position: string,
+    }
+}
+
+export class SchemaInfo extends jspb.Message { 
+    getFormat(): SchemaFormat;
+    setFormat(value: SchemaFormat): SchemaInfo;
+    getName(): string;
+    setName(value: string): SchemaInfo;
+
+    hasId(): boolean;
+    clearId(): void;
+    getId(): string | undefined;
+    setId(value: string): SchemaInfo;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): SchemaInfo.AsObject;
+    static toObject(includeInstance: boolean, msg: SchemaInfo): SchemaInfo.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: SchemaInfo, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): SchemaInfo;
+    static deserializeBinaryFromReader(message: SchemaInfo, reader: jspb.BinaryReader): SchemaInfo;
+}
+
+export namespace SchemaInfo {
+    export type AsObject = {
+        format: SchemaFormat,
+        name: string,
+        id?: string,
+    }
+}
+
+export class AppendRecord extends jspb.Message { 
+
+    hasRecordId(): boolean;
+    clearRecordId(): void;
+    getRecordId(): string | undefined;
+    setRecordId(value: string): AppendRecord;
+
+    getPropertiesMap(): jspb.Map<string, google_protobuf_struct_pb.Value>;
+    clearPropertiesMap(): void;
+
+    hasSchema(): boolean;
+    clearSchema(): void;
+    getSchema(): SchemaInfo | undefined;
+    setSchema(value?: SchemaInfo): AppendRecord;
+    getData(): Uint8Array | string;
+    getData_asU8(): Uint8Array;
+    getData_asB64(): string;
+    setData(value: Uint8Array | string): AppendRecord;
+
+    serializeBinary(): Uint8Array;
+    toObject(includeInstance?: boolean): AppendRecord.AsObject;
+    static toObject(includeInstance: boolean, msg: AppendRecord): AppendRecord.AsObject;
+    static extensions: {[key: number]: jspb.ExtensionFieldInfo<jspb.Message>};
+    static extensionsBinary: {[key: number]: jspb.ExtensionFieldBinaryInfo<jspb.Message>};
+    static serializeBinaryToWriter(message: AppendRecord, writer: jspb.BinaryWriter): void;
+    static deserializeBinary(bytes: Uint8Array): AppendRecord;
+    static deserializeBinaryFromReader(message: AppendRecord, reader: jspb.BinaryReader): AppendRecord;
+}
+
+export namespace AppendRecord {
+    export type AsObject = {
+        recordId?: string,
+
+        propertiesMap: Array<[string, google_protobuf_struct_pb.Value.AsObject]>,
+        schema?: SchemaInfo.AsObject,
+        data: Uint8Array | string,
+    }
+}
+
+export enum SchemaFormat {
+    SCHEMA_FORMAT_UNSPECIFIED = 0,
+    SCHEMA_FORMAT_JSON = 1,
+    SCHEMA_FORMAT_PROTOBUF = 2,
+    SCHEMA_FORMAT_AVRO = 3,
+    SCHEMA_FORMAT_BYTES = 4,
+}
+
+export enum ExpectedRevisionConstants {
+    EXPECTED_REVISION_CONSTANTS_SINGLE_EVENT = 0,
+    EXPECTED_REVISION_CONSTANTS_NO_STREAM = -1,
+    EXPECTED_REVISION_CONSTANTS_ANY = -2,
+    EXPECTED_REVISION_CONSTANTS_EXISTS = -4,
+}