@polyester/sdk 0.0.0

package/dist/services/lifecycle/lifecycle.d.ts

@@ -0,0 +1,42 @@
+import { PolyesterRequestOptions } from "../../shared/request-options.js";
+import { PolyesterRealtime } from "../../realtime/types.js";
+import { BaseSubscribeInput } from "../../shared/types.js";
+import { GetLifecycleFlowInput, GetLifecycleFlowOutput, LifecycleFlowDetail, LifecycleFlowSummary, ListLifecycleFlowsByTxInput, ListLifecycleFlowsByTxOutput, ListLifecycleFlowsInput, ListLifecycleFlowsOutput } from "./lifecycle.schemas.js";
+import { Transport } from "@connectrpc/connect";
+//#region src/services/lifecycle/lifecycle.d.ts
+interface SubscribeOpenLifecycleFlowsInput extends BaseSubscribeInput<LifecycleFlowSummary> {
+  accountId?: string;
+}
+interface SubscribeLifecycleFlowDetailInput extends BaseSubscribeInput<LifecycleFlowDetail> {
+  flowId: string;
+}
+/**
+ * Reads and streams chain lifecycle flow state, history, progress, and transaction matches.
+ */
+declare class LifecycleService {
+  #private;
+  constructor(transport: Transport, realtime: PolyesterRealtime);
+  /**
+   * Returns paginated lifecycle flow summaries filtered by kind, state, scope, account selector, transaction reference, chain ids, and asset ids. The response is ordered by the selected timestamp and includes an opaque next page token.
+   */
+  listFlows(input: ListLifecycleFlowsInput, options?: PolyesterRequestOptions): Promise<ListLifecycleFlowsOutput>;
+  /**
+   * Fetches one lifecycle flow by its public flow id and returns summary, factual steps, timeline, and live-state detail when available.
+   */
+  getFlow(input: GetLifecycleFlowInput, options?: PolyesterRequestOptions): Promise<GetLifecycleFlowOutput>;
+  /**
+   * Searches lifecycle flows that reference a 0x-prefixed transaction hash, using source-only or any-reference lookup mode. A single transaction may match zero, one, or many flows.
+   */
+  listFlowsByTx(input: ListLifecycleFlowsByTxInput, options?: PolyesterRequestOptions): Promise<ListLifecycleFlowsByTxOutput>;
+  /**
+   * Subscribes to open lifecycle flow summary updates, using private:chain:lifecycle:flows:{accountId}:proto when an account id is provided and the public flow channel otherwise.
+   */
+  subscribeOpenFlows(input: SubscribeOpenLifecycleFlowsInput): () => void;
+  /**
+   * Subscribes to detail updates for one lifecycle flow on public:chain:lifecycle:flow:{flowId}:proto. Invalid flow ids are rejected locally with a no-op unsubscribe function.
+   */
+  subscribeFlowDetail(input: SubscribeLifecycleFlowDetailInput): () => void;
+}
+//#endregion
+export { LifecycleService };
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/services/lifecycle/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","names":[],"sources":["../../../src/services/lifecycle/lifecycle.ts"],"mappings":";;;;;;UAmCU,yCAAyC,mBAAmB;EAClE;;UAGM,0CAA0C,mBAAmB;EACnE;;;;;cAMS;;EAIG,YAAA,WAAW,WAAW,UAAU;;;;EAQtC,UACF,OAAO,yBACP,UAAU,0BACX,QAAQ;;;;EAUL,QACF,OAAO,uBACP,UAAU,0BACX,QAAQ;;;;EAYL,cACF,OAAO,6BACP,UAAU,0BACX,QAAQ;;;;EAYX,mBAAmB,OAAO;;;;EAqB1B,oBAAoB,OAAO"}

package/dist/services/lifecycle/lifecycle.js

@@ -0,0 +1,87 @@
+import { FlowDetailViewSchema, FlowSummaryViewSchema, GetFlowByIdRequestSchema, LifecycleReadService } from "../../gen/chain/lifecycle/v1/lifecycle_read_pb.js";
+import { toConnectCallOptions } from "../../shared/request-options.js";
+import { isDev } from "../../utils/is-dev.js";
+import { GetLifecycleFlowInputSchema, GetLifecycleFlowOutputSchema, LifecycleFlowDetailSchema, LifecycleFlowSummarySchema, ListLifecycleFlowsByTxInputSchema, ListLifecycleFlowsByTxOutputSchema, ListLifecycleFlowsInputSchema, ListLifecycleFlowsOutputSchema } from "./lifecycle.schemas.js";
+import { create } from "@bufbuild/protobuf";
+import { createClient } from "@connectrpc/connect";
+import * as v from "valibot";
+//#region src/services/lifecycle/lifecycle.ts
+/**
+* Reads and streams chain lifecycle flow state, history, progress, and transaction matches.
+*/
+var LifecycleService = class {
+	#client;
+	#realtime;
+	constructor(transport, realtime) {
+		this.#client = createClient(LifecycleReadService, transport);
+		this.#realtime = realtime;
+	}
+	/**
+	* Returns paginated lifecycle flow summaries filtered by kind, state, scope, account selector, transaction reference, chain ids, and asset ids. The response is ordered by the selected timestamp and includes an opaque next page token.
+	*/
+	async listFlows(input, options) {
+		const parsedInput = v.parse(ListLifecycleFlowsInputSchema, input);
+		const response = await this.#client.listFlows(parsedInput, toConnectCallOptions(options));
+		return v.parse(ListLifecycleFlowsOutputSchema, response);
+	}
+	/**
+	* Fetches one lifecycle flow by its public flow id and returns summary, factual steps, timeline, and live-state detail when available.
+	*/
+	async getFlow(input, options) {
+		const parsedInput = v.parse(GetLifecycleFlowInputSchema, input);
+		const response = await this.#client.getFlowById(create(GetFlowByIdRequestSchema, parsedInput), toConnectCallOptions(options));
+		return v.parse(GetLifecycleFlowOutputSchema, response);
+	}
+	/**
+	* Searches lifecycle flows that reference a 0x-prefixed transaction hash, using source-only or any-reference lookup mode. A single transaction may match zero, one, or many flows.
+	*/
+	async listFlowsByTx(input, options) {
+		const parsedInput = v.parse(ListLifecycleFlowsByTxInputSchema, input);
+		const response = await this.#client.listFlowsByTx(parsedInput, toConnectCallOptions(options));
+		return v.parse(ListLifecycleFlowsByTxOutputSchema, response);
+	}
+	/**
+	* Subscribes to open lifecycle flow summary updates, using private:chain:lifecycle:flows:{accountId}:proto when an account id is provided and the public flow channel otherwise.
+	*/
+	subscribeOpenFlows(input) {
+		const accountId = input.accountId?.trim();
+		const channel = accountId ? `private:chain:lifecycle:flows:${accountId}:proto` : "public:chain:lifecycle:flows:proto";
+		return this.#realtime.connectProtoChannel({
+			channel,
+			schema: FlowSummaryViewSchema,
+			onPublication: (data) => {
+				const flow = v.parse(LifecycleFlowSummarySchema, data);
+				input.onEvent(flow);
+			},
+			onConnected: input.onOpen,
+			onDisconnected: input.onClose,
+			onError: input.onError
+		});
+	}
+	/**
+	* Subscribes to detail updates for one lifecycle flow on public:chain:lifecycle:flow:{flowId}:proto. Invalid flow ids are rejected locally with a no-op unsubscribe function.
+	*/
+	subscribeFlowDetail(input) {
+		const parsedFlowId = v.safeParse(GetLifecycleFlowInputSchema, { flowId: input.flowId });
+		if (!parsedFlowId.success) {
+			if (isDev()) console.error("[LifecycleService] flowId is required for flow detail subscription.");
+			return () => {};
+		}
+		const channel = `public:chain:lifecycle:flow:${parsedFlowId.output.flowId}:proto`;
+		return this.#realtime.connectProtoChannel({
+			channel,
+			schema: FlowDetailViewSchema,
+			onPublication: (data) => {
+				const flow = v.parse(LifecycleFlowDetailSchema, data);
+				input.onEvent(flow);
+			},
+			onConnected: input.onOpen,
+			onDisconnected: input.onClose,
+			onError: input.onError
+		});
+	}
+};
+//#endregion
+export { LifecycleService };
+
+//# sourceMappingURL=lifecycle.js.map

package/dist/services/lifecycle/lifecycle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.js","names":["#client","#realtime"],"sources":["../../../src/services/lifecycle/lifecycle.ts"],"sourcesContent":["import { createClient, type Client, type Transport } from \"@connectrpc/connect\";\nimport { create } from \"@bufbuild/protobuf\";\nimport {\n    FlowDetailViewSchema,\n    FlowSummaryViewSchema,\n    GetFlowByIdRequestSchema,\n    LifecycleReadService,\n} from \"../../gen/chain/lifecycle/v1/lifecycle_read_pb.js\";\nimport type { PolyesterRealtime } from \"../../realtime/types.js\";\nimport type { BaseSubscribeInput } from \"../../shared/types.js\";\nimport {\n    toConnectCallOptions,\n    type PolyesterRequestOptions,\n} from \"../../shared/request-options.js\";\nimport { isDev } from \"../../utils/is-dev.js\";\nimport * as v from \"valibot\";\nimport {\n    GetLifecycleFlowInputSchema,\n    GetLifecycleFlowOutputSchema,\n    LifecycleFlowDetailSchema,\n    LifecycleFlowSummarySchema,\n    ListLifecycleFlowsByTxOutputSchema,\n    ListLifecycleFlowsByTxInputSchema,\n    ListLifecycleFlowsOutputSchema,\n    ListLifecycleFlowsInputSchema,\n    type GetLifecycleFlowInput,\n    type GetLifecycleFlowOutput,\n    type LifecycleFlowDetail,\n    type LifecycleFlowSummary,\n    type ListLifecycleFlowsByTxInput,\n    type ListLifecycleFlowsByTxOutput,\n    type ListLifecycleFlowsInput,\n    type ListLifecycleFlowsOutput,\n} from \"./lifecycle.schemas.js\";\n\ninterface SubscribeOpenLifecycleFlowsInput extends BaseSubscribeInput<LifecycleFlowSummary> {\n    accountId?: string;\n}\n\ninterface SubscribeLifecycleFlowDetailInput extends BaseSubscribeInput<LifecycleFlowDetail> {\n    flowId: string;\n}\n\n/**\n * Reads and streams chain lifecycle flow state, history, progress, and transaction matches.\n */\nexport class LifecycleService {\n    #client: Client<typeof LifecycleReadService>;\n    #realtime: PolyesterRealtime;\n\n    constructor(transport: Transport, realtime: PolyesterRealtime) {\n        this.#client = createClient(LifecycleReadService, transport);\n        this.#realtime = realtime;\n    }\n\n    /**\n     * Returns paginated lifecycle flow summaries filtered by kind, state, scope, account selector, transaction reference, chain ids, and asset ids. The response is ordered by the selected timestamp and includes an opaque next page token.\n     */\n    async listFlows(\n        input: ListLifecycleFlowsInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<ListLifecycleFlowsOutput> {\n        const parsedInput = v.parse(ListLifecycleFlowsInputSchema, input);\n        const response = await this.#client.listFlows(parsedInput, toConnectCallOptions(options));\n        const res = v.parse(ListLifecycleFlowsOutputSchema, response);\n        return res;\n    }\n\n    /**\n     * Fetches one lifecycle flow by its public flow id and returns summary, factual steps, timeline, and live-state detail when available.\n     */\n    async getFlow(\n        input: GetLifecycleFlowInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<GetLifecycleFlowOutput> {\n        const parsedInput = v.parse(GetLifecycleFlowInputSchema, input);\n        const response = await this.#client.getFlowById(\n            create(GetFlowByIdRequestSchema, parsedInput),\n            toConnectCallOptions(options),\n        );\n        return v.parse(GetLifecycleFlowOutputSchema, response);\n    }\n\n    /**\n     * Searches lifecycle flows that reference a 0x-prefixed transaction hash, using source-only or any-reference lookup mode. A single transaction may match zero, one, or many flows.\n     */\n    async listFlowsByTx(\n        input: ListLifecycleFlowsByTxInput,\n        options?: PolyesterRequestOptions,\n    ): Promise<ListLifecycleFlowsByTxOutput> {\n        const parsedInput = v.parse(ListLifecycleFlowsByTxInputSchema, input);\n        const response = await this.#client.listFlowsByTx(\n            parsedInput,\n            toConnectCallOptions(options),\n        );\n        return v.parse(ListLifecycleFlowsByTxOutputSchema, response);\n    }\n\n    /**\n     * Subscribes to open lifecycle flow summary updates, using private:chain:lifecycle:flows:{accountId}:proto when an account id is provided and the public flow channel otherwise.\n     */\n    subscribeOpenFlows(input: SubscribeOpenLifecycleFlowsInput): () => void {\n        const accountId = input.accountId?.trim();\n        const channel = accountId\n            ? `private:chain:lifecycle:flows:${accountId}:proto`\n            : \"public:chain:lifecycle:flows:proto\";\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: FlowSummaryViewSchema,\n            onPublication: (data) => {\n                const flow = v.parse(LifecycleFlowSummarySchema, data);\n                input.onEvent(flow);\n            },\n            onConnected: input.onOpen,\n            onDisconnected: input.onClose,\n            onError: input.onError,\n        });\n    }\n\n    /**\n     * Subscribes to detail updates for one lifecycle flow on public:chain:lifecycle:flow:{flowId}:proto. Invalid flow ids are rejected locally with a no-op unsubscribe function.\n     */\n    subscribeFlowDetail(input: SubscribeLifecycleFlowDetailInput): () => void {\n        const parsedFlowId = v.safeParse(GetLifecycleFlowInputSchema, { flowId: input.flowId });\n        if (!parsedFlowId.success) {\n            if (isDev()) {\n                console.error(\n                    \"[LifecycleService] flowId is required for flow detail subscription.\",\n                );\n            }\n            return () => {};\n        }\n\n        const channel = `public:chain:lifecycle:flow:${parsedFlowId.output.flowId}:proto`;\n        return this.#realtime.connectProtoChannel({\n            channel,\n            schema: FlowDetailViewSchema,\n            onPublication: (data) => {\n                const flow = v.parse(LifecycleFlowDetailSchema, data);\n                input.onEvent(flow);\n            },\n            onConnected: input.onOpen,\n            onDisconnected: input.onClose,\n            onError: input.onError,\n        });\n    }\n}\n"],"mappings":";;;;;;;;;;;AA8CA,IAAa,mBAAb,MAA8B;CAC1B;CACA;CAEA,YAAY,WAAsB,UAA6B;EAC3D,KAAKA,UAAU,aAAa,sBAAsB,SAAS;EAC3D,KAAKC,YAAY;CACrB;;;;CAKA,MAAM,UACF,OACA,SACiC;EACjC,MAAM,cAAc,EAAE,MAAM,+BAA+B,KAAK;EAChE,MAAM,WAAW,MAAM,KAAKD,QAAQ,UAAU,aAAa,qBAAqB,OAAO,CAAC;EAExF,OADY,EAAE,MAAM,gCAAgC,QAC3C;CACb;;;;CAKA,MAAM,QACF,OACA,SAC+B;EAC/B,MAAM,cAAc,EAAE,MAAM,6BAA6B,KAAK;EAC9D,MAAM,WAAW,MAAM,KAAKA,QAAQ,YAChC,OAAO,0BAA0B,WAAW,GAC5C,qBAAqB,OAAO,CAChC;EACA,OAAO,EAAE,MAAM,8BAA8B,QAAQ;CACzD;;;;CAKA,MAAM,cACF,OACA,SACqC;EACrC,MAAM,cAAc,EAAE,MAAM,mCAAmC,KAAK;EACpE,MAAM,WAAW,MAAM,KAAKA,QAAQ,cAChC,aACA,qBAAqB,OAAO,CAChC;EACA,OAAO,EAAE,MAAM,oCAAoC,QAAQ;CAC/D;;;;CAKA,mBAAmB,OAAqD;EACpE,MAAM,YAAY,MAAM,WAAW,KAAK;EACxC,MAAM,UAAU,YACV,iCAAiC,UAAU,UAC3C;EACN,OAAO,KAAKC,UAAU,oBAAoB;GACtC;GACA,QAAQ;GACR,gBAAgB,SAAS;IACrB,MAAM,OAAO,EAAE,MAAM,4BAA4B,IAAI;IACrD,MAAM,QAAQ,IAAI;GACtB;GACA,aAAa,MAAM;GACnB,gBAAgB,MAAM;GACtB,SAAS,MAAM;EACnB,CAAC;CACL;;;;CAKA,oBAAoB,OAAsD;EACtE,MAAM,eAAe,EAAE,UAAU,6BAA6B,EAAE,QAAQ,MAAM,OAAO,CAAC;EACtF,IAAI,CAAC,aAAa,SAAS;GACvB,IAAI,MAAM,GACN,QAAQ,MACJ,qEACJ;GAEJ,aAAa,CAAC;EAClB;EAEA,MAAM,UAAU,+BAA+B,aAAa,OAAO,OAAO;EAC1E,OAAO,KAAKA,UAAU,oBAAoB;GACtC;GACA,QAAQ;GACR,gBAAgB,SAAS;IACrB,MAAM,OAAO,EAAE,MAAM,2BAA2B,IAAI;IACpD,MAAM,QAAQ,IAAI;GACtB;GACA,aAAa,MAAM;GACnB,gBAAgB,MAAM;GACtB,SAAS,MAAM;EACnB,CAAC;CACL;AACJ"}