@kronos-ts/kronosdb 0.1.0

package/dist/generated/command.d.ts

@@ -0,0 +1,169 @@
+import { BinaryReader, BinaryWriter } from "@bufbuild/protobuf/wire";
+import type { CallContext, CallOptions } from "nice-grpc-common";
+import { ErrorMessage, FlowControl, InstructionAck, MetadataValue, ProcessingInstruction, SerializedObject } from "./common.js";
+export declare const protobufPackage = "kronosdb.command";
+/** Messages sent FROM the command handler TO the server. */
+export interface CommandHandlerOutbound {
+    /** Register as a handler for a command type. */
+    subscribe?: CommandSubscription | undefined;
+    /** Unregister as a handler for a command type. */
+    unsubscribe?: CommandSubscription | undefined;
+    /** Grant the server permits to send more commands. */
+    flowControl?: FlowControl | undefined;
+    /** Return the result of processing a command. */
+    commandResponse?: CommandResponse | undefined;
+    /** Acknowledge a previously received instruction. */
+    ack?: InstructionAck | undefined;
+    /** If set, the server will acknowledge this instruction. */
+    instructionId: string;
+}
+/** Messages sent FROM the server TO the command handler. */
+export interface CommandHandlerInbound {
+    /** Acknowledgement of a handler instruction. */
+    ack?: InstructionAck | undefined;
+    /** A command to process. */
+    command?: Command | undefined;
+    /** If set, the handler should acknowledge this instruction. */
+    instructionId: string;
+}
+/** A command to be routed to a handler. */
+export interface Command {
+    /** Unique identifier for this command message. */
+    messageIdentifier: string;
+    /** The command name, used for routing to the correct handler. */
+    name: string;
+    /** Timestamp of command creation. */
+    timestamp: bigint;
+    /** The command payload. */
+    payload: SerializedObject | undefined;
+    /** Metadata providing context. */
+    metadata: {
+        [key: string]: MetadataValue;
+    };
+    /** Routing and processing instructions. */
+    processingInstructions: ProcessingInstruction[];
+    /** The client instance that dispatched this command. */
+    clientId: string;
+    /** The component name that dispatched this command. */
+    componentName: string;
+}
+export interface Command_MetadataEntry {
+    key: string;
+    value: MetadataValue | undefined;
+}
+/** Result of command handler execution. */
+export interface CommandResponse {
+    /** Unique identifier for this response. */
+    messageIdentifier: string;
+    /** Error code, if the command failed. */
+    errorCode: string;
+    /** Error details, if the command failed. */
+    errorMessage: ErrorMessage | undefined;
+    /** The result payload, if any. */
+    payload: SerializedObject | undefined;
+    /** Response metadata. */
+    metadata: {
+        [key: string]: MetadataValue;
+    };
+    /** Processing instructions for the response. */
+    processingInstructions: ProcessingInstruction[];
+    /** The identifier of the command this is a response to. */
+    requestIdentifier: string;
+}
+export interface CommandResponse_MetadataEntry {
+    key: string;
+    value: MetadataValue | undefined;
+}
+/** A handler's registration for a command type. */
+export interface CommandSubscription {
+    /** Unique identifier for this subscription message. */
+    messageId: string;
+    /** The command name this handler can process. */
+    command: string;
+    /** The component name of the handler. */
+    componentName: string;
+    /** The unique client instance identifier. */
+    clientId: string;
+    /**
+     * Relative load capacity. Higher = more commands routed here.
+     * 0 is treated as 100 (default).
+     */
+    loadFactor: number;
+}
+export declare const CommandHandlerOutbound: MessageFns<CommandHandlerOutbound>;
+export declare const CommandHandlerInbound: MessageFns<CommandHandlerInbound>;
+export declare const Command: MessageFns<Command>;
+export declare const Command_MetadataEntry: MessageFns<Command_MetadataEntry>;
+export declare const CommandResponse: MessageFns<CommandResponse>;
+export declare const CommandResponse_MetadataEntry: MessageFns<CommandResponse_MetadataEntry>;
+export declare const CommandSubscription: MessageFns<CommandSubscription>;
+/**
+ * Service for dispatching and handling commands.
+ * Commands are routed to exactly one handler, load-balanced across instances.
+ */
+export type CommandServiceDefinition = typeof CommandServiceDefinition;
+export declare const CommandServiceDefinition: {
+    readonly name: "CommandService";
+    readonly fullName: "kronosdb.command.CommandService";
+    readonly methods: {
+        /**
+         * Opens a bidirectional stream for a command handler.
+         * The client registers which command types it handles and receives
+         * commands to process. Responses are sent back on the same stream.
+         */
+        readonly openStream: {
+            readonly name: "OpenStream";
+            readonly requestType: typeof CommandHandlerOutbound;
+            readonly requestStream: true;
+            readonly responseType: typeof CommandHandlerInbound;
+            readonly responseStream: true;
+            readonly options: {};
+        };
+        /** Dispatches a command to a registered handler and returns the result. */
+        readonly dispatch: {
+            readonly name: "Dispatch";
+            readonly requestType: typeof Command;
+            readonly requestStream: false;
+            readonly responseType: typeof CommandResponse;
+            readonly responseStream: false;
+            readonly options: {};
+        };
+    };
+};
+export interface CommandServiceImplementation<CallContextExt = {}> {
+    /**
+     * Opens a bidirectional stream for a command handler.
+     * The client registers which command types it handles and receives
+     * commands to process. Responses are sent back on the same stream.
+     */
+    openStream(request: AsyncIterable<CommandHandlerOutbound>, context: CallContext & CallContextExt): ServerStreamingMethodResult<DeepPartial<CommandHandlerInbound>>;
+    /** Dispatches a command to a registered handler and returns the result. */
+    dispatch(request: Command, context: CallContext & CallContextExt): Promise<DeepPartial<CommandResponse>>;
+}
+export interface CommandServiceClient<CallOptionsExt = {}> {
+    /**
+     * Opens a bidirectional stream for a command handler.
+     * The client registers which command types it handles and receives
+     * commands to process. Responses are sent back on the same stream.
+     */
+    openStream(request: AsyncIterable<DeepPartial<CommandHandlerOutbound>>, options?: CallOptions & CallOptionsExt): AsyncIterable<CommandHandlerInbound>;
+    /** Dispatches a command to a registered handler and returns the result. */
+    dispatch(request: DeepPartial<Command>, options?: CallOptions & CallOptionsExt): Promise<CommandResponse>;
+}
+type Builtin = Date | Function | Uint8Array | string | number | boolean | bigint | undefined;
+export type DeepPartial<T> = T extends Builtin ? T : T extends globalThis.Array<infer U> ? globalThis.Array<DeepPartial<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+export type ServerStreamingMethodResult<Response> = {
+    [Symbol.asyncIterator](): AsyncIterator<Response, void>;
+};
+export interface MessageFns<T> {
+    encode(message: T, writer?: BinaryWriter): BinaryWriter;
+    decode(input: BinaryReader | Uint8Array, length?: number): T;
+    fromJSON(object: any): T;
+    toJSON(message: T): unknown;
+    create(base?: DeepPartial<T>): T;
+    fromPartial(object: DeepPartial<T>): T;
+}
+export {};
+//# sourceMappingURL=command.d.ts.map

package/dist/generated/command.d.ts.map

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