@ironflow/core 0.1.0-test.2 → 0.2.0

package/README.md

@@ -15,15 +15,19 @@ npm install @ironflow/core
 ### Types
 
 ```typescript
-import type { IronflowEvent, Run, Step, FunctionConfig, Logger } from '@ironflow/core';
+import type {
+  IronflowEvent, Run, FunctionConfig, StepClient, Logger,
+  RunStatus, EmitOptions, Subscription, SubscribeOptions,
+  RunId, FunctionId, StepId, EventId,
+} from '@ironflow/core';
 ```
 
 ### Schemas (Zod)
 
 ```typescript
-import { EventSchema, RunSchema } from '@ironflow/core';
+import { RunStatusSchema, PushRequestSchema, TriggerResponseSchema } from '@ironflow/core';
 
-const event = EventSchema.parse(rawData);
+const status = RunStatusSchema.parse(rawStatus);
 ```
 
 ### Constants

package/dist/config-types.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Config Management API Type Definitions
+ *
+ * Types for the Ironflow Config Management service.
+ * Config Management provides environment-scoped configuration
+ * built on top of the KV store.
+ */
+/**
+ * A config entry with full data.
+ * Returned by GET /api/v1/config/{name}.
+ */
+export interface ConfigResponse {
+    /** Config namespace name */
+    name: string;
+    /** Config data as key-value pairs */
+    data: Record<string, unknown>;
+    /** KV revision number for optimistic concurrency */
+    revision: number;
+    /** When the config was last updated */
+    updatedAt: string;
+}
+/**
+ * Summary of a config entry (without full data).
+ * Returned in list responses.
+ */
+export interface ConfigEntry {
+    /** Config namespace name */
+    name: string;
+    /** KV revision number */
+    revision: number;
+    /** When the config was last updated */
+    updatedAt: string;
+}
+/**
+ * Result of a set or patch operation.
+ */
+export interface ConfigSetResult {
+    /** Config namespace name */
+    name: string;
+    /** New KV revision number */
+    revision: number;
+}
+/**
+ * Callbacks for config watch events.
+ */
+export interface ConfigWatchCallbacks {
+    /** Called when a config is updated */
+    onEvent: (config: ConfigResponse) => void;
+    /** Called when an error occurs */
+    onError?: (error: Error) => void;
+}
+//# sourceMappingURL=config-types.d.ts.map

package/dist/config-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.d.ts","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC9B,oDAAoD;IACpD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,yBAAyB;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,4BAA4B;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAMD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,sCAAsC;IACtC,OAAO,EAAE,CAAC,MAAM,EAAE,cAAc,KAAK,IAAI,CAAC;IAC1C,kCAAkC;IAClC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC"}

package/dist/config-types.js

@@ -0,0 +1,9 @@
+/**
+ * Config Management API Type Definitions
+ *
+ * Types for the Ironflow Config Management service.
+ * Config Management provides environment-scoped configuration
+ * built on top of the KV store.
+ */
+export {};
+//# sourceMappingURL=config-types.js.map

package/dist/config-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config-types.js","sourceRoot":"","sources":["../src/config-types.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/constants.d.ts

@@ -140,6 +140,13 @@ export declare const HTTP_HEADERS: {
     /** Content-Type for JSON */
     readonly CONTENT_TYPE_JSON: "application/json";
 };
+/** Ironflow-specific headers */
+export declare const HEADERS: {
+    /** Header for environment isolation */
+    readonly ENVIRONMENT: "X-Ironflow-Environment";
+};
+/** Default environment name */
+export declare const DEFAULT_ENVIRONMENT = "development";
 /** JSON headers for fetch requests */
 export declare const JSON_HEADERS: {
     readonly "Content-Type": "application/json";

package/dist/constants.d.ts.map

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

package/dist/constants.js

@@ -154,6 +154,13 @@ export const HTTP_HEADERS = {
     /** Content-Type for JSON */
     CONTENT_TYPE_JSON: "application/json",
 };
+/** Ironflow-specific headers */
+export const HEADERS = {
+    /** Header for environment isolation */
+    ENVIRONMENT: "X-Ironflow-Environment",
+};
+/** Default environment name */
+export const DEFAULT_ENVIRONMENT = "development";
 /** JSON headers for fetch requests */
 export const JSON_HEADERS = {
     "Content-Type": HTTP_HEADERS.CONTENT_TYPE_JSON,

package/dist/constants.js.map

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

package/dist/errors.d.ts

@@ -137,4 +137,11 @@ export declare function isRetryable(error: unknown): boolean;
  * Type guard to check if an error is an IronflowError
  */
 export declare function isIronflowError(error: unknown): error is IronflowError;
+/**
+ * Normalize any thrown value to an Error instance.
+ *
+ * Useful for catch blocks where the caught value might not be an Error
+ * (e.g., thrown strings, numbers, or objects).
+ */
+export declare function toError(error: unknown): Error;
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

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

package/dist/errors.js

@@ -202,4 +202,22 @@ export function isRetryable(error) {
 export function isIronflowError(error) {
     return error instanceof IronflowError;
 }
+/**
+ * Normalize any thrown value to an Error instance.
+ *
+ * Useful for catch blocks where the caught value might not be an Error
+ * (e.g., thrown strings, numbers, or objects).
+ */
+export function toError(error) {
+    if (error instanceof Error) {
+        return error;
+    }
+    if (typeof error === "string") {
+        return new Error(error);
+    }
+    if (typeof error === "object" && error !== null && "message" in error) {
+        return new Error(String(error.message));
+    }
+    return new Error(String(error));
+}
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

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

package/dist/event-definition.d.ts

@@ -0,0 +1,21 @@
+import { type UpcasterFn } from "./upcaster.js";
+export interface EventDefinitionOptions {
+    name: string;
+    version: number;
+    upcast?: UpcasterFn;
+}
+export interface EventDefinition {
+    name: string;
+    version: number;
+    upcast?: UpcasterFn;
+}
+export declare function defineEvent(options: EventDefinitionOptions): EventDefinition;
+export declare class EventDefinitionRegistry {
+    private upcasterRegistry;
+    private versions;
+    register(definition: EventDefinition): void;
+    upcastEvent(eventName: string, data: unknown, fromVersion: number): unknown;
+    getLatestVersion(eventName: string): number | undefined;
+}
+export declare function createEventDefinitionRegistry(): EventDefinitionRegistry;
+//# sourceMappingURL=event-definition.d.ts.map

package/dist/event-definition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-definition.d.ts","sourceRoot":"","sources":["../src/event-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,KAAK,UAAU,EAAE,MAAM,eAAe,CAAC;AAElE,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,CAAC;CACrB;AAED,wBAAgB,WAAW,CAAC,OAAO,EAAE,sBAAsB,GAAG,eAAe,CAM5E;AAED,qBAAa,uBAAuB;IAClC,OAAO,CAAC,gBAAgB,CAA0B;IAClD,OAAO,CAAC,QAAQ,CAA+B;IAE/C,QAAQ,CAAC,UAAU,EAAE,eAAe,GAAG,IAAI;IAgB3C,WAAW,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO;IAQ3E,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAOxD;AAED,wBAAgB,6BAA6B,IAAI,uBAAuB,CAEvE"}

package/dist/event-definition.js

@@ -0,0 +1,39 @@
+import { UpcasterRegistry } from "./upcaster.js";
+export function defineEvent(options) {
+    return {
+        name: options.name,
+        version: options.version,
+        upcast: options.upcast,
+    };
+}
+export class EventDefinitionRegistry {
+    upcasterRegistry = new UpcasterRegistry();
+    versions = new Map();
+    register(definition) {
+        if (!this.versions.has(definition.name)) {
+            this.versions.set(definition.name, []);
+        }
+        this.versions.get(definition.name).push(definition.version);
+        if (definition.upcast && definition.version > 1) {
+            this.upcasterRegistry.register(definition.name, definition.version - 1, definition.version, definition.upcast);
+        }
+    }
+    upcastEvent(eventName, data, fromVersion) {
+        const latestVersion = this.getLatestVersion(eventName);
+        if (latestVersion === undefined || fromVersion >= latestVersion) {
+            return data;
+        }
+        return this.upcasterRegistry.upcast(eventName, data, fromVersion, latestVersion);
+    }
+    getLatestVersion(eventName) {
+        const versions = this.versions.get(eventName);
+        if (!versions || versions.length === 0) {
+            return undefined;
+        }
+        return Math.max(...versions);
+    }
+}
+export function createEventDefinitionRegistry() {
+    return new EventDefinitionRegistry();
+}
+//# sourceMappingURL=event-definition.js.map

package/dist/event-definition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event-definition.js","sourceRoot":"","sources":["../src/event-definition.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAmB,MAAM,eAAe,CAAC;AAclE,MAAM,UAAU,WAAW,CAAC,OAA+B;IACzD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,OAAO,EAAE,OAAO,CAAC,OAAO;QACxB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,uBAAuB;IAC1B,gBAAgB,GAAG,IAAI,gBAAgB,EAAE,CAAC;IAC1C,QAAQ,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE/C,QAAQ,CAAC,UAA2B;QAClC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,CAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAE7D,IAAI,UAAU,CAAC,MAAM,IAAI,UAAU,CAAC,OAAO,GAAG,CAAC,EAAE,CAAC;YAChD,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAC5B,UAAU,CAAC,IAAI,EACf,UAAU,CAAC,OAAO,GAAG,CAAC,EACtB,UAAU,CAAC,OAAO,EAClB,UAAU,CAAC,MAAM,CAClB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,WAAW,CAAC,SAAiB,EAAE,IAAa,EAAE,WAAmB;QAC/D,MAAM,aAAa,GAAG,IAAI,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC;QACvD,IAAI,aAAa,KAAK,SAAS,IAAI,WAAW,IAAI,aAAa,EAAE,CAAC;YAChE,OAAO,IAAI,CAAC;QACd,CAAC;QACD,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,CAAC,CAAC;IACnF,CAAC;IAED,gBAAgB,CAAC,SAAiB;QAChC,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC9C,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvC,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,uBAAuB,EAAE,CAAC;AACvC,CAAC"}

package/dist/gen/ironflow/v1/entity_stream_pb.d.ts

@@ -0,0 +1,283 @@
+import type { GenFile, GenMessage, GenService } from "@bufbuild/protobuf/codegenv1";
+import type { Timestamp } from "@bufbuild/protobuf/wkt";
+import type { JsonObject, Message } from "@bufbuild/protobuf";
+/**
+ * Describes the file ironflow/v1/entity_stream.proto.
+ */
+export declare const file_ironflow_v1_entity_stream: GenFile;
+/**
+ * @generated from message ironflow.v1.AppendEventRequest
+ */
+export type AppendEventRequest = Message<"ironflow.v1.AppendEventRequest"> & {
+    /**
+     * @generated from field: string entity_id = 1;
+     */
+    entityId: string;
+    /**
+     * @generated from field: string entity_type = 2;
+     */
+    entityType: string;
+    /**
+     * @generated from field: string event_name = 3;
+     */
+    eventName: string;
+    /**
+     * @generated from field: google.protobuf.Struct data = 4;
+     */
+    data?: JsonObject;
+    /**
+     * -1 = skip check, 0 = new stream
+     *
+     * @generated from field: int64 expected_version = 5;
+     */
+    expectedVersion: bigint;
+    /**
+     * @generated from field: string idempotency_key = 6;
+     */
+    idempotencyKey: string;
+    /**
+     * Event schema version
+     *
+     * @generated from field: int32 version = 7;
+     */
+    version: number;
+};
+/**
+ * Describes the message ironflow.v1.AppendEventRequest.
+ * Use `create(AppendEventRequestSchema)` to create a new message.
+ */
+export declare const AppendEventRequestSchema: GenMessage<AppendEventRequest>;
+/**
+ * @generated from message ironflow.v1.AppendEventResponse
+ */
+export type AppendEventResponse = Message<"ironflow.v1.AppendEventResponse"> & {
+    /**
+     * @generated from field: int64 entity_version = 1;
+     */
+    entityVersion: bigint;
+    /**
+     * @generated from field: string event_id = 2;
+     */
+    eventId: string;
+};
+/**
+ * Describes the message ironflow.v1.AppendEventResponse.
+ * Use `create(AppendEventResponseSchema)` to create a new message.
+ */
+export declare const AppendEventResponseSchema: GenMessage<AppendEventResponse>;
+/**
+ * @generated from message ironflow.v1.ReadStreamRequest
+ */
+export type ReadStreamRequest = Message<"ironflow.v1.ReadStreamRequest"> & {
+    /**
+     * @generated from field: string entity_id = 1;
+     */
+    entityId: string;
+    /**
+     * @generated from field: int64 from_version = 2;
+     */
+    fromVersion: bigint;
+    /**
+     * @generated from field: int32 limit = 3;
+     */
+    limit: number;
+    /**
+     * "forward" (default) or "backward"
+     *
+     * @generated from field: string direction = 4;
+     */
+    direction: string;
+};
+/**
+ * Describes the message ironflow.v1.ReadStreamRequest.
+ * Use `create(ReadStreamRequestSchema)` to create a new message.
+ */
+export declare const ReadStreamRequestSchema: GenMessage<ReadStreamRequest>;
+/**
+ * @generated from message ironflow.v1.ReadStreamResponse
+ */
+export type ReadStreamResponse = Message<"ironflow.v1.ReadStreamResponse"> & {
+    /**
+     * @generated from field: repeated ironflow.v1.StreamEvent events = 1;
+     */
+    events: StreamEvent[];
+    /**
+     * @generated from field: int32 total_count = 2;
+     */
+    totalCount: number;
+};
+/**
+ * Describes the message ironflow.v1.ReadStreamResponse.
+ * Use `create(ReadStreamResponseSchema)` to create a new message.
+ */
+export declare const ReadStreamResponseSchema: GenMessage<ReadStreamResponse>;
+/**
+ * @generated from message ironflow.v1.StreamEvent
+ */
+export type StreamEvent = Message<"ironflow.v1.StreamEvent"> & {
+    /**
+     * @generated from field: string id = 1;
+     */
+    id: string;
+    /**
+     * @generated from field: string name = 2;
+     */
+    name: string;
+    /**
+     * @generated from field: google.protobuf.Struct data = 3;
+     */
+    data?: JsonObject;
+    /**
+     * @generated from field: int64 entity_version = 4;
+     */
+    entityVersion: bigint;
+    /**
+     * @generated from field: int32 version = 5;
+     */
+    version: number;
+    /**
+     * @generated from field: google.protobuf.Timestamp timestamp = 6;
+     */
+    timestamp?: Timestamp;
+    /**
+     * @generated from field: string source = 7;
+     */
+    source: string;
+    /**
+     * @generated from field: google.protobuf.Struct metadata = 8;
+     */
+    metadata?: JsonObject;
+};
+/**
+ * Describes the message ironflow.v1.StreamEvent.
+ * Use `create(StreamEventSchema)` to create a new message.
+ */
+export declare const StreamEventSchema: GenMessage<StreamEvent>;
+/**
+ * @generated from message ironflow.v1.GetStreamInfoRequest
+ */
+export type GetStreamInfoRequest = Message<"ironflow.v1.GetStreamInfoRequest"> & {
+    /**
+     * @generated from field: string entity_id = 1;
+     */
+    entityId: string;
+};
+/**
+ * Describes the message ironflow.v1.GetStreamInfoRequest.
+ * Use `create(GetStreamInfoRequestSchema)` to create a new message.
+ */
+export declare const GetStreamInfoRequestSchema: GenMessage<GetStreamInfoRequest>;
+/**
+ * @generated from message ironflow.v1.GetStreamInfoResponse
+ */
+export type GetStreamInfoResponse = Message<"ironflow.v1.GetStreamInfoResponse"> & {
+    /**
+     * @generated from field: string entity_id = 1;
+     */
+    entityId: string;
+    /**
+     * @generated from field: string entity_type = 2;
+     */
+    entityType: string;
+    /**
+     * @generated from field: int64 version = 3;
+     */
+    version: bigint;
+    /**
+     * @generated from field: int64 event_count = 4;
+     */
+    eventCount: bigint;
+    /**
+     * @generated from field: google.protobuf.Timestamp created_at = 5;
+     */
+    createdAt?: Timestamp;
+    /**
+     * @generated from field: google.protobuf.Timestamp updated_at = 6;
+     */
+    updatedAt?: Timestamp;
+};
+/**
+ * Describes the message ironflow.v1.GetStreamInfoResponse.
+ * Use `create(GetStreamInfoResponseSchema)` to create a new message.
+ */
+export declare const GetStreamInfoResponseSchema: GenMessage<GetStreamInfoResponse>;
+/**
+ * @generated from message ironflow.v1.ListStreamsRequest
+ */
+export type ListStreamsRequest = Message<"ironflow.v1.ListStreamsRequest"> & {
+    /**
+     * optional filter
+     *
+     * @generated from field: string entity_type = 1;
+     */
+    entityType: string;
+    /**
+     * @generated from field: int32 limit = 2;
+     */
+    limit: number;
+    /**
+     * @generated from field: int32 offset = 3;
+     */
+    offset: number;
+};
+/**
+ * Describes the message ironflow.v1.ListStreamsRequest.
+ * Use `create(ListStreamsRequestSchema)` to create a new message.
+ */
+export declare const ListStreamsRequestSchema: GenMessage<ListStreamsRequest>;
+/**
+ * @generated from message ironflow.v1.ListStreamsResponse
+ */
+export type ListStreamsResponse = Message<"ironflow.v1.ListStreamsResponse"> & {
+    /**
+     * @generated from field: repeated ironflow.v1.GetStreamInfoResponse streams = 1;
+     */
+    streams: GetStreamInfoResponse[];
+    /**
+     * @generated from field: int32 total_count = 2;
+     */
+    totalCount: number;
+};
+/**
+ * Describes the message ironflow.v1.ListStreamsResponse.
+ * Use `create(ListStreamsResponseSchema)` to create a new message.
+ */
+export declare const ListStreamsResponseSchema: GenMessage<ListStreamsResponse>;
+/**
+ * @generated from service ironflow.v1.EntityStreamService
+ */
+export declare const EntityStreamService: GenService<{
+    /**
+     * @generated from rpc ironflow.v1.EntityStreamService.AppendEvent
+     */
+    appendEvent: {
+        methodKind: "unary";
+        input: typeof AppendEventRequestSchema;
+        output: typeof AppendEventResponseSchema;
+    };
+    /**
+     * @generated from rpc ironflow.v1.EntityStreamService.ReadStream
+     */
+    readStream: {
+        methodKind: "unary";
+        input: typeof ReadStreamRequestSchema;
+        output: typeof ReadStreamResponseSchema;
+    };
+    /**
+     * @generated from rpc ironflow.v1.EntityStreamService.GetStreamInfo
+     */
+    getStreamInfo: {
+        methodKind: "unary";
+        input: typeof GetStreamInfoRequestSchema;
+        output: typeof GetStreamInfoResponseSchema;
+    };
+    /**
+     * @generated from rpc ironflow.v1.EntityStreamService.ListStreams
+     */
+    listStreams: {
+        methodKind: "unary";
+        input: typeof ListStreamsRequestSchema;
+        output: typeof ListStreamsResponseSchema;
+    };
+}>;
+//# sourceMappingURL=entity_stream_pb.d.ts.map

package/dist/gen/ironflow/v1/entity_stream_pb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity_stream_pb.d.ts","sourceRoot":"","sources":["../../../../src/gen/ironflow/v1/entity_stream_pb.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAC;AAEpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,8BAA8B,EAAE,OAC+iE,CAAC;AAE7lE;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,gCAAgC,CAAC,GAAG;IAC3E;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;;;OAIG;IACH,eAAe,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IAEvB;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAAC,kBAAkB,CACpB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,iCAAiC,CAAC,GAAG;IAC7E;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAAC,mBAAmB,CACtB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,+BAA+B,CAAC,GAAG;IACzE;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;OAIG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,uBAAuB,EAAE,UAAU,CAAC,iBAAiB,CAClB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,gCAAgC,CAAC,GAAG;IAC3E;;OAEG;IACH,MAAM,EAAE,WAAW,EAAE,CAAC;IAEtB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAAC,kBAAkB,CACpB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,CAAC,yBAAyB,CAAC,GAAG;IAC7D;;OAEG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,CAAC,EAAE,UAAU,CAAC;IAElB;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,QAAQ,CAAC,EAAE,UAAU,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,UAAU,CAAC,WAAW,CACN,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,kCAAkC,CAAC,GAAG;IAC/E;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,0BAA0B,EAAE,UAAU,CAAC,oBAAoB,CACxB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CAAC,mCAAmC,CAAC,GAAG;IACjF;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;IAEtB;;OAEG;IACH,SAAS,CAAC,EAAE,SAAS,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,2BAA2B,EAAE,UAAU,CAAC,qBAAqB,CAC1B,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,OAAO,CAAC,gCAAgC,CAAC,GAAG;IAC3E;;;;OAIG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,UAAU,CAAC,kBAAkB,CACpB,CAAC;AAEjD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,OAAO,CAAC,iCAAiC,CAAC,GAAG;IAC7E;;OAEG;IACH,OAAO,EAAE,qBAAqB,EAAE,CAAC;IAEjC;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,UAAU,CAAC,mBAAmB,CACtB,CAAC;AAEjD;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,UAAU,CAAC;IAC3C;;OAEG;IACH,WAAW,EAAE;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,wBAAwB,CAAC;QACvC,MAAM,EAAE,OAAO,yBAAyB,CAAC;KAC1C,CAAC;IACF;;OAEG;IACH,UAAU,EAAE;QACV,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,uBAAuB,CAAC;QACtC,MAAM,EAAE,OAAO,wBAAwB,CAAC;KACzC,CAAC;IACF;;OAEG;IACH,aAAa,EAAE;QACb,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,0BAA0B,CAAC;QACzC,MAAM,EAAE,OAAO,2BAA2B,CAAC;KAC5C,CAAC;IACF;;OAEG;IACH,WAAW,EAAE;QACX,UAAU,EAAE,OAAO,CAAC;QACpB,KAAK,EAAE,OAAO,wBAAwB,CAAC;QACvC,MAAM,EAAE,OAAO,yBAAyB,CAAC;KAC1C,CAAC;CACH,CAC+C,CAAC"}