@aigne/afs-ocap 1.12.0-beta.5

package/dist/remote-source.mjs

@@ -0,0 +1,339 @@
+import { makeNsLog } from "@aigne/afs";
+
+//#region src/remote-source.ts
+const log = makeNsLog("provider:ocap");
+let _clientCtorPromise = null;
+function loadGraphQLClientCtor() {
+	if (!_clientCtorPromise) _clientCtorPromise = import("@ocap/client").then((mod) => {
+		return mod.default ?? mod;
+	});
+	return _clientCtorPromise;
+}
+function toGraphQLPaging(paging) {
+	return {
+		size: paging.size,
+		cursor: String(paging.offset)
+	};
+}
+function fromPageInfo(page, items) {
+	return {
+		total: page?.total ?? items.length,
+		hasNext: page?.next ?? false
+	};
+}
+var OcapRemoteSource = class {
+	/**
+	* Lazily-instantiated GraphQL client. Initialized on the first method call,
+	* not at construction time, because `@ocap/client` is loaded via dynamic
+	* `import()` so bundlers can keep it out of the cold-start path.
+	*/
+	clientPromise = null;
+	url;
+	constructor(endpoint) {
+		this.url = /^https?:\/\//i.test(endpoint) ? endpoint : `https://${endpoint}`;
+	}
+	getClient() {
+		if (!this.clientPromise) this.clientPromise = loadGraphQLClientCtor().then((Ctor) => new Ctor(this.url));
+		return this.clientPromise;
+	}
+	async getChainInfo() {
+		return (await (await this.getClient()).getChainInfo()).info;
+	}
+	async getConfig() {
+		const res = await (await this.getClient()).getConfig({ parsed: true });
+		try {
+			return JSON.parse(res.config);
+		} catch {
+			return { raw: res.config };
+		}
+	}
+	async getValidatorsInfo() {
+		return (await (await this.getClient()).getValidatorsInfo()).validatorsInfo?.validators || [];
+	}
+	async getForgeStats() {
+		const f = (await (await this.getClient()).getForgeStats()).forgeStats || {};
+		return { forgeStats: {
+			numTxs: f.numTxs ?? [],
+			numStakes: f.numStakes ?? [],
+			numValidators: f.numValidators ?? [],
+			numDeclareTxs: f.numDeclareTxs ?? []
+		} };
+	}
+	async getTx(hash) {
+		return (await (await this.getClient()).getTx({ hash })).info ?? null;
+	}
+	async listTransactions(paging, filters) {
+		const params = { paging: toGraphQLPaging(paging) };
+		if (filters?.addressFilter) params.addressFilter = filters.addressFilter;
+		if (filters?.typeFilter) params.typeFilter = filters.typeFilter;
+		if (filters?.tokenFilter) params.tokenFilter = filters.tokenFilter;
+		if (filters?.assetFilter) params.assetFilter = filters.assetFilter;
+		if (filters?.factoryFilter) params.factoryFilter = filters.factoryFilter;
+		if (filters?.accountFilter) params.accountFilter = filters.accountFilter;
+		if (filters?.rollupFilter) params.rollupFilter = filters.rollupFilter;
+		if (filters?.stakeFilter) params.stakeFilter = filters.stakeFilter;
+		if (filters?.delegationFilter) params.delegationFilter = filters.delegationFilter;
+		if (filters?.validityFilter) params.validityFilter = filters.validityFilter;
+		if (filters?.timeFilter) params.timeFilter = filters.timeFilter;
+		const res = await (await this.getClient()).listTransactions(params);
+		const items = res.transactions || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getAccountState(address) {
+		const res = await (await this.getClient()).getAccountState({ address });
+		if (!res.state) return null;
+		const { context, ...rest } = res.state;
+		return {
+			...rest,
+			genesisTime: context?.genesisTime ?? void 0,
+			renaissanceTime: context?.renaissanceTime ?? void 0
+		};
+	}
+	async getAccountTokens(address) {
+		return (await (await this.getClient()).getAccountTokens({ address })).tokens || [];
+	}
+	async listTopAccounts(paging, filters) {
+		const res = await (await this.getClient()).listTopAccounts({
+			paging: toGraphQLPaging(paging),
+			...filters?.tokenAddress && { tokenAddress: filters.tokenAddress },
+			...filters?.timeFilter && { timeFilter: filters.timeFilter }
+		});
+		const items = res.accounts || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getTokenState(address) {
+		return (await (await this.getClient()).getTokenState({ address })).state ?? null;
+	}
+	async listTokens(paging, filters) {
+		const res = await (await this.getClient()).listTokens({
+			paging: toGraphQLPaging(paging),
+			...filters?.issuerAddress && { issuerAddress: filters.issuerAddress },
+			...filters?.timeFilter && { timeFilter: filters.timeFilter }
+		});
+		const items = res.tokens || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getAssetState(address) {
+		const res = await (await this.getClient()).getAssetState({ address });
+		if (!res.state) return null;
+		const { context, ...rest } = res.state;
+		return {
+			...rest,
+			genesisTime: context?.genesisTime ?? void 0,
+			renaissanceTime: context?.renaissanceTime ?? void 0
+		};
+	}
+	async listAssets(paging, filters) {
+		const res = await (await this.getClient()).listAssets({
+			paging: toGraphQLPaging(paging),
+			...filters?.ownerAddress && { ownerAddress: filters.ownerAddress },
+			...filters?.factoryAddress && { factoryAddress: filters.factoryAddress },
+			...filters?.timeFilter && { timeFilter: filters.timeFilter }
+		});
+		const items = res.assets || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getFactoryState(address) {
+		const res = await (await this.getClient()).getFactoryState({ address });
+		if (!res.state) return null;
+		const { context, ...rest } = res.state;
+		return {
+			...rest,
+			genesisTime: context?.genesisTime ?? void 0,
+			renaissanceTime: context?.renaissanceTime ?? void 0
+		};
+	}
+	async listFactories(paging, filters) {
+		const res = await (await this.getClient()).listFactories({
+			paging: toGraphQLPaging(paging),
+			...filters?.ownerAddress && { ownerAddress: filters.ownerAddress },
+			...filters?.addressList && { addressList: filters.addressList },
+			...filters?.timeFilter && { timeFilter: filters.timeFilter }
+		});
+		const items = res.factories || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getStakeState(address) {
+		return (await (await this.getClient()).getStakeState({ address })).state ?? null;
+	}
+	async listStakes(paging, filters) {
+		const params = { paging: toGraphQLPaging(paging) };
+		if (filters?.addressFilter) params.addressFilter = filters.addressFilter;
+		if (filters?.timeFilter) params.timeFilter = filters.timeFilter;
+		const res = await (await this.getClient()).listStakes(params);
+		const items = res.stakes || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getRollupState(address) {
+		return (await (await this.getClient()).getRollupState({ address })).state ?? null;
+	}
+	async listRollups(paging, filters) {
+		const res = await (await this.getClient()).listRollups({
+			paging: toGraphQLPaging(paging),
+			...filters?.tokenAddress && { tokenAddress: filters.tokenAddress },
+			...filters?.timeFilter && { timeFilter: filters.timeFilter }
+		});
+		const items = res.rollups || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getRollupBlock(hash, rollupAddress) {
+		return (await (await this.getClient()).getRollupBlock({
+			hash,
+			rollupAddress
+		})).block ?? null;
+	}
+	async listRollupBlocks(rollupAddress, paging, filters) {
+		const res = await (await this.getClient()).listRollupBlocks({
+			rollupAddress,
+			paging: toGraphQLPaging(paging),
+			...filters?.validatorFilter && { validatorFilter: filters.validatorFilter }
+		});
+		const items = res.blocks || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async listRollupValidators(rollupAddress, paging) {
+		const res = await (await this.getClient()).listRollupValidators({
+			rollupAddress,
+			paging: toGraphQLPaging(paging)
+		});
+		const items = res.validators || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async getDelegateState(address) {
+		const res = await (await this.getClient()).getDelegateState({ address });
+		if (!res.state) return null;
+		const { ops, ...rest } = res.state;
+		const opsArray = ops ? Object.entries(ops).map(([key, value]) => ({
+			key,
+			value
+		})) : void 0;
+		return {
+			...rest,
+			ops: opsArray
+		};
+	}
+	async listDelegations(paging, filters) {
+		const res = await (await this.getClient()).listDelegations({
+			paging: toGraphQLPaging(paging),
+			...filters?.from && { from: filters.from },
+			...filters?.to && { to: filters.to },
+			...filters?.timeFilter && { timeFilter: filters.timeFilter }
+		});
+		const items = res.delegations || [];
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async search(keyword, paging) {
+		const res = await (await this.getClient()).search({
+			keyword,
+			paging: toGraphQLPaging(paging)
+		});
+		const items = (res.results || []).map((r) => ({
+			type: r.type,
+			id: r.id,
+			title: r.title || "",
+			subtitle: r.subtitle || "",
+			description: r.description || "",
+			tags: r.tags || [],
+			timestamp: r.timestamp || ""
+		}));
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	async listTokenFlows(accountAddress, paging, options) {
+		const res = await (await this.getClient()).listTokenFlows({
+			accountAddress,
+			paging: toGraphQLPaging(paging),
+			...options?.tokenAddress && { tokenAddress: options.tokenAddress },
+			...options?.depth != null && { depth: options.depth },
+			...options?.direction && { direction: options.direction }
+		});
+		const items = (res.data ?? []).map((d) => ({
+			hash: d.hash,
+			from: d.from,
+			to: d.to,
+			value: d.value
+		}));
+		return {
+			items,
+			...fromPageInfo(res.page, items)
+		};
+	}
+	/**
+	* Install `@ocap/client/subscribe` on the GraphQL client and forward
+	* topic events to the supplied callback. The install is lazy — it
+	* waits for the client to be constructed via `getClient()` so we
+	* don't pay the import cost on instances that never subscribe.
+	*
+	* Returns an unsub fn. Failures during install (e.g. the bundled
+	* runtime can't resolve `@arcblock/ws`) bubble up so
+	* `AFSOCAP.onMount` can fall back to `live: false` without
+	* misreporting capability.
+	*/
+	subscribe(topic, callback) {
+		let cancelled = false;
+		let installedUnsub = null;
+		const installAsync = async () => {
+			const client = await this.getClient();
+			if (!Object.hasOwn(client, "_ensureSocketClient")) {
+				const mod = await import("@ocap/client/subscribe");
+				const install = mod.install ?? mod.default?.install;
+				if (typeof install !== "function") throw new Error("@ocap/client/subscribe: install() not found on imported module");
+				install(client);
+			}
+			if (cancelled) return;
+			const handler = (payload) => {
+				try {
+					callback(payload);
+				} catch {}
+			};
+			client.subscribe?.(topic, handler);
+			installedUnsub = () => client.unsubscribe?.(topic, handler);
+		};
+		installAsync().catch((err) => {
+			if (typeof console !== "undefined") log.warn("[OcapRemoteSource] subscribe install failed", err);
+		});
+		return () => {
+			if (cancelled) return;
+			cancelled = true;
+			try {
+				installedUnsub?.();
+			} catch {}
+		};
+	}
+};
+
+//#endregion
+export { OcapRemoteSource };
+//# sourceMappingURL=remote-source.mjs.map

package/dist/remote-source.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-source.mjs","names":[],"sources":["../src/remote-source.ts"],"sourcesContent":["import { makeNsLog } from \"@aigne/afs\";\nimport type { OcapDataSource } from \"./source.js\";\nimport type {\n  AccountFilters,\n  AccountState,\n  AccountToken,\n  AssetFactoryState,\n  AssetFilters,\n  AssetState,\n  BridgeFilters,\n  ChainConfig,\n  ChainInfo,\n  DelegateState,\n  DelegationFilters,\n  FactoryFilters,\n  IndexedAccountState,\n  IndexedAssetState,\n  IndexedDelegationState,\n  IndexedFactoryState,\n  IndexedRollupBlock,\n  IndexedRollupState,\n  IndexedRollupValidator,\n  IndexedStakeState,\n  IndexedTokenState,\n  IndexedTransaction,\n  PagedResult,\n  Paging,\n  RollupBlock,\n  RollupBlockFilters,\n  RollupState,\n  SearchResult,\n  StakeFilters,\n  StakeState,\n  TokenFilters,\n  TokenState,\n  TransactionInfo,\n  TxFilters,\n  ValidatorInfo,\n} from \"./types.js\";\n\nconst log = makeNsLog(\"provider:ocap\");\n\n// @ocap/client is CJS, uses `export = GraphQLClient`. Loading via dynamic\n// `import()` lets bundlers (esbuild on Cloudflare Workers, Vite, …) chase the\n// dep through its `exports` map and emit a lazy chunk, instead of leaving a\n// runtime `require(\"@ocap/client\")` call that workerd can't resolve.\ntype GraphQLClientType = import(\"@ocap/client\");\n\nlet _clientCtorPromise: Promise<new (url: string) => GraphQLClientType> | null = null;\nfunction loadGraphQLClientCtor(): Promise<new (url: string) => GraphQLClientType> {\n  if (!_clientCtorPromise) {\n    _clientCtorPromise = import(\"@ocap/client\").then((mod) => {\n      // CJS interop: `module.exports = GraphQLClient`. Different bundlers shape\n      // the namespace differently — esbuild puts the class on `.default`,\n      // Node ESM-from-CJS exposes it the same way, but accept the bare ns too\n      // for runtimes that don't synthesize a default export.\n      const ns = mod as unknown as { default?: unknown };\n      const ctor = (ns.default ?? mod) as unknown as new (url: string) => GraphQLClientType;\n      return ctor;\n    });\n  }\n  return _clientCtorPromise;\n}\n\n/**\n * @internal Test-only seam. Clears the module-level client-ctor cache so a\n * `mock.module(\"@ocap/client\", …)` set up by a test takes effect even when an\n * earlier test in the same bun process already resolved the real ctor (the\n * cached promise otherwise wins over the freshly-registered mock). Mirrors the\n * `__reset*` convention in providers/basic/http/src/retry.ts.\n */\nexport function __resetClientCtorCacheForTest(): void {\n  _clientCtorPromise = null;\n}\n\ninterface PageInfo {\n  cursor: string;\n  next: boolean;\n  total: number;\n}\n\nfunction toGraphQLPaging(paging: Paging): { cursor: string; size: number } {\n  return {\n    size: paging.size,\n    cursor: String(paging.offset),\n  };\n}\n\nfunction fromPageInfo(page: PageInfo, items: unknown[]): { total: number; hasNext: boolean } {\n  return {\n    total: page?.total ?? items.length,\n    hasNext: page?.next ?? false,\n  };\n}\n\nexport class OcapRemoteSource implements OcapDataSource {\n  /**\n   * Lazily-instantiated GraphQL client. Initialized on the first method call,\n   * not at construction time, because `@ocap/client` is loaded via dynamic\n   * `import()` so bundlers can keep it out of the cold-start path.\n   */\n  private clientPromise: Promise<GraphQLClientType> | null = null;\n  private readonly url: string;\n\n  constructor(endpoint: string) {\n    // Ensure endpoint has a protocol (URI template parsing strips it)\n    this.url = /^https?:\\/\\//i.test(endpoint) ? endpoint : `https://${endpoint}`;\n  }\n\n  private getClient(): Promise<GraphQLClientType> {\n    if (!this.clientPromise) {\n      this.clientPromise = loadGraphQLClientCtor().then((Ctor) => new Ctor(this.url));\n    }\n    return this.clientPromise;\n  }\n\n  async getChainInfo(): Promise<ChainInfo> {\n    const res = await (await this.getClient()).getChainInfo();\n    return res.info;\n  }\n\n  async getConfig(): Promise<ChainConfig> {\n    const res = await (await this.getClient()).getConfig({ parsed: true });\n    try {\n      return JSON.parse(res.config);\n    } catch {\n      return { raw: res.config };\n    }\n  }\n\n  async getValidatorsInfo(): Promise<ValidatorInfo[]> {\n    const res = await (await this.getClient()).getValidatorsInfo();\n    return res.validatorsInfo?.validators || [];\n  }\n\n  async getForgeStats(): Promise<{ forgeStats: import(\"./source.js\").ForgeStatsSlice }> {\n    const res = await (await this.getClient()).getForgeStats();\n    const f = res.forgeStats || ({} as Record<string, unknown>);\n    return {\n      forgeStats: {\n        numTxs: (f as { numTxs?: string[] }).numTxs ?? [],\n        numStakes: (f as { numStakes?: string[] }).numStakes ?? [],\n        numValidators: (f as { numValidators?: number[] }).numValidators ?? [],\n        numDeclareTxs: (f as { numDeclareTxs?: string[] }).numDeclareTxs ?? [],\n      },\n    };\n  }\n\n  async getTx(hash: string): Promise<TransactionInfo | null> {\n    const res = await (await this.getClient()).getTx({ hash });\n    return res.info ?? null;\n  }\n\n  async listTransactions(\n    paging: Paging,\n    filters?: TxFilters,\n  ): Promise<PagedResult<IndexedTransaction>> {\n    const params: any = {\n      paging: toGraphQLPaging(paging),\n    };\n    if (filters?.addressFilter) params.addressFilter = filters.addressFilter;\n    if (filters?.typeFilter) params.typeFilter = filters.typeFilter;\n    if (filters?.tokenFilter) params.tokenFilter = filters.tokenFilter;\n    if (filters?.assetFilter) params.assetFilter = filters.assetFilter;\n    if (filters?.factoryFilter) params.factoryFilter = filters.factoryFilter;\n    if (filters?.accountFilter) params.accountFilter = filters.accountFilter;\n    if (filters?.rollupFilter) params.rollupFilter = filters.rollupFilter;\n    if (filters?.stakeFilter) params.stakeFilter = filters.stakeFilter;\n    if (filters?.delegationFilter) params.delegationFilter = filters.delegationFilter;\n    if (filters?.validityFilter) params.validityFilter = filters.validityFilter;\n    if (filters?.timeFilter) params.timeFilter = filters.timeFilter;\n    const res = await (await this.getClient()).listTransactions(params);\n    const items: IndexedTransaction[] = res.transactions || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getAccountState(address: string): Promise<AccountState | null> {\n    const res = await (await this.getClient()).getAccountState({ address });\n    if (!res.state) return null;\n    const { context, ...rest } = res.state;\n    return {\n      ...rest,\n      genesisTime: context?.genesisTime ?? undefined,\n      renaissanceTime: context?.renaissanceTime ?? undefined,\n    };\n  }\n\n  async getAccountTokens(address: string): Promise<AccountToken[]> {\n    const res = await (await this.getClient()).getAccountTokens({ address });\n    return res.tokens || [];\n  }\n\n  async listTopAccounts(\n    paging: Paging,\n    filters?: AccountFilters,\n  ): Promise<PagedResult<IndexedAccountState>> {\n    const res = await (await this.getClient()).listTopAccounts({\n      paging: toGraphQLPaging(paging),\n      ...(filters?.tokenAddress && { tokenAddress: filters.tokenAddress }),\n      ...(filters?.timeFilter && { timeFilter: filters.timeFilter }),\n    });\n    const items: IndexedAccountState[] = res.accounts || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getTokenState(address: string): Promise<TokenState | null> {\n    const res = await (await this.getClient()).getTokenState({ address });\n    return res.state ?? null;\n  }\n\n  async listTokens(\n    paging: Paging,\n    filters?: TokenFilters,\n  ): Promise<PagedResult<IndexedTokenState>> {\n    const res = await (await this.getClient()).listTokens({\n      paging: toGraphQLPaging(paging),\n      ...(filters?.issuerAddress && { issuerAddress: filters.issuerAddress }),\n      ...(filters?.timeFilter && { timeFilter: filters.timeFilter }),\n    });\n    const items: IndexedTokenState[] = res.tokens || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getAssetState(address: string): Promise<AssetState | null> {\n    const res = await (await this.getClient()).getAssetState({ address });\n    if (!res.state) return null;\n    const { context, ...rest } = res.state;\n    return {\n      ...rest,\n      genesisTime: context?.genesisTime ?? undefined,\n      renaissanceTime: context?.renaissanceTime ?? undefined,\n    };\n  }\n\n  async listAssets(\n    paging: Paging,\n    filters?: AssetFilters,\n  ): Promise<PagedResult<IndexedAssetState>> {\n    const res = await (await this.getClient()).listAssets({\n      paging: toGraphQLPaging(paging),\n      ...(filters?.ownerAddress && { ownerAddress: filters.ownerAddress }),\n      ...(filters?.factoryAddress && { factoryAddress: filters.factoryAddress }),\n      ...(filters?.timeFilter && { timeFilter: filters.timeFilter }),\n    });\n    const items: IndexedAssetState[] = res.assets || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getFactoryState(address: string): Promise<AssetFactoryState | null> {\n    const res = await (await this.getClient()).getFactoryState({ address });\n    if (!res.state) return null;\n    const { context, ...rest } = res.state;\n    return {\n      ...rest,\n      genesisTime: context?.genesisTime ?? undefined,\n      renaissanceTime: context?.renaissanceTime ?? undefined,\n    };\n  }\n\n  async listFactories(\n    paging: Paging,\n    filters?: FactoryFilters,\n  ): Promise<PagedResult<IndexedFactoryState>> {\n    const res = await (await this.getClient()).listFactories({\n      paging: toGraphQLPaging(paging),\n      ...(filters?.ownerAddress && { ownerAddress: filters.ownerAddress }),\n      ...(filters?.addressList && { addressList: filters.addressList }),\n      ...(filters?.timeFilter && { timeFilter: filters.timeFilter }),\n    });\n    const items: IndexedFactoryState[] = res.factories || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getStakeState(address: string): Promise<StakeState | null> {\n    const res = await (await this.getClient()).getStakeState({ address });\n    return res.state ?? null;\n  }\n\n  async listStakes(\n    paging: Paging,\n    filters?: StakeFilters,\n  ): Promise<PagedResult<IndexedStakeState>> {\n    const params: any = {\n      paging: toGraphQLPaging(paging),\n    };\n    if (filters?.addressFilter) params.addressFilter = filters.addressFilter;\n    if (filters?.timeFilter) params.timeFilter = filters.timeFilter;\n    const res = await (await this.getClient()).listStakes(params);\n    const items: IndexedStakeState[] = res.stakes || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getRollupState(address: string): Promise<RollupState | null> {\n    const res = await (await this.getClient()).getRollupState({ address });\n    return res.state ?? null;\n  }\n\n  async listRollups(\n    paging: Paging,\n    filters?: BridgeFilters,\n  ): Promise<PagedResult<IndexedRollupState>> {\n    const res = await (await this.getClient()).listRollups({\n      paging: toGraphQLPaging(paging),\n      ...(filters?.tokenAddress && { tokenAddress: filters.tokenAddress }),\n      ...(filters?.timeFilter && { timeFilter: filters.timeFilter }),\n    });\n    const items: IndexedRollupState[] = res.rollups || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getRollupBlock(hash: string, rollupAddress: string): Promise<RollupBlock | null> {\n    const res = await (await this.getClient()).getRollupBlock({ hash, rollupAddress });\n    return res.block ?? null;\n  }\n\n  async listRollupBlocks(\n    rollupAddress: string,\n    paging: Paging,\n    filters?: RollupBlockFilters,\n  ): Promise<PagedResult<IndexedRollupBlock>> {\n    const res = await (await this.getClient()).listRollupBlocks({\n      rollupAddress,\n      paging: toGraphQLPaging(paging),\n      ...(filters?.validatorFilter && { validatorFilter: filters.validatorFilter }),\n    });\n    const items: IndexedRollupBlock[] = res.blocks || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async listRollupValidators(\n    rollupAddress: string,\n    paging: Paging,\n  ): Promise<PagedResult<IndexedRollupValidator>> {\n    const res = await (await this.getClient()).listRollupValidators({\n      rollupAddress,\n      paging: toGraphQLPaging(paging),\n    });\n    const items: IndexedRollupValidator[] = (res.validators as IndexedRollupValidator[]) || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async getDelegateState(address: string): Promise<DelegateState | null> {\n    const res = await (await this.getClient()).getDelegateState({ address });\n    if (!res.state) return null;\n    const { ops, ...rest } = res.state;\n    // Upstream returns ops as Record<typeUrl, op>; flatten to array for local consumers.\n    const opsArray = ops ? Object.entries(ops).map(([key, value]) => ({ key, value })) : undefined;\n    return { ...rest, ops: opsArray } as DelegateState;\n  }\n\n  async listDelegations(\n    paging: Paging,\n    filters?: DelegationFilters,\n  ): Promise<PagedResult<IndexedDelegationState>> {\n    const res = await (await this.getClient()).listDelegations({\n      paging: toGraphQLPaging(paging),\n      ...(filters?.from && { from: filters.from }),\n      ...(filters?.to && { to: filters.to }),\n      ...(filters?.timeFilter && { timeFilter: filters.timeFilter }),\n    });\n    const items: IndexedDelegationState[] = res.delegations || [];\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async search(keyword: string, paging: Paging): Promise<PagedResult<SearchResult>> {\n    const res = await (await this.getClient()).search({\n      keyword,\n      paging: toGraphQLPaging(paging),\n    });\n    const items: SearchResult[] = (res.results || []).map((r) => ({\n      type: r.type,\n      id: r.id,\n      title: r.title || \"\",\n      subtitle: r.subtitle || \"\",\n      description: r.description || \"\",\n      tags: r.tags || [],\n      timestamp: r.timestamp || \"\",\n    }));\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  async listTokenFlows(\n    accountAddress: string,\n    paging: Paging,\n    options?: {\n      tokenAddress?: string;\n      depth?: number;\n      direction?: import(\"./types.js\").TokenFlowDirection;\n    },\n  ): Promise<PagedResult<import(\"./types.js\").IndexedTokenFlow>> {\n    const res = await (await this.getClient()).listTokenFlows({\n      accountAddress,\n      paging: toGraphQLPaging(paging),\n      ...(options?.tokenAddress && { tokenAddress: options.tokenAddress }),\n      ...(options?.depth != null && { depth: options.depth }),\n      ...(options?.direction && { direction: options.direction as never }),\n    });\n    const items: import(\"./types.js\").IndexedTokenFlow[] = (res.data ?? []).map((d) => ({\n      hash: d.hash,\n      from: d.from,\n      to: d.to,\n      value: d.value,\n    }));\n    return { items, ...fromPageInfo(res.page, items) };\n  }\n\n  // ── Live subscribe (afs-live-updates Phase 3b T3b.2) ─────────────────\n  /**\n   * Install `@ocap/client/subscribe` on the GraphQL client and forward\n   * topic events to the supplied callback. The install is lazy — it\n   * waits for the client to be constructed via `getClient()` so we\n   * don't pay the import cost on instances that never subscribe.\n   *\n   * Returns an unsub fn. Failures during install (e.g. the bundled\n   * runtime can't resolve `@arcblock/ws`) bubble up so\n   * `AFSOCAP.onMount` can fall back to `live: false` without\n   * misreporting capability.\n   */\n  subscribe(topic: string, callback: (payload: unknown) => void): () => void {\n    let cancelled = false;\n    let installedUnsub: (() => void) | null = null;\n\n    const installAsync = async () => {\n      const client = (await this.getClient()) as unknown as {\n        subscribe?: (t: string, cb: (p: unknown) => void) => void;\n        unsubscribe?: (t: string, cb: (p: unknown) => void) => void;\n        _ensureSocketClient?: unknown;\n      };\n      // The browser-entry GraphQLClient ships stubs as prototype methods\n      // that throw SUBSCRIBE_NOT_INSTALLED until install() patches them.\n      // `typeof` succeeds against the throwing stub, so we'd skip the\n      // install and call the throwing subscribe(). install() adds\n      // `_ensureSocketClient` as an OWN property on the instance; check\n      // for own-property existence rather than typeof so we don't\n      // confuse prototype stubs with the installed patch.\n      if (!Object.hasOwn(client, \"_ensureSocketClient\")) {\n        // Static specifier so esbuild lifts this into a precompiled\n        // chunk in the worker bundle; Cloudflare Workers reject\n        // truly-dynamic `import(variable)` calls but accept pre-resolved\n        // chunk loads. CJS interop: `@ocap/client/subscribe` is CommonJS\n        // — esbuild's worker bundle exposes the installer at\n        // `default.install`, while Node ESM-from-CJS puts it on the\n        // bare namespace. Try both shapes so the same code path works\n        // in both runtimes.\n        const mod = (await import(\"@ocap/client/subscribe\")) as unknown as {\n          install?: (c: unknown) => void;\n          default?: { install?: (c: unknown) => void };\n        };\n        const install = mod.install ?? mod.default?.install;\n        if (typeof install !== \"function\") {\n          throw new Error(\"@ocap/client/subscribe: install() not found on imported module\");\n        }\n        install(client);\n      }\n      if (cancelled) return;\n      const handler = (payload: unknown) => {\n        try {\n          callback(payload);\n        } catch {\n          // INV: subscriber failure must not propagate\n        }\n      };\n      client.subscribe?.(topic, handler);\n      installedUnsub = () => client.unsubscribe?.(topic, handler);\n    };\n\n    // Fire-and-forget install — the caller can disregard the promise.\n    // Any thrown error is observable via the AFS event sink falling silent.\n    installAsync().catch((err) => {\n      if (typeof console !== \"undefined\") {\n        log.warn(\"[OcapRemoteSource] subscribe install failed\", err);\n      }\n    });\n\n    return () => {\n      if (cancelled) return;\n      cancelled = true;\n      try {\n        installedUnsub?.();\n      } catch {\n        // tolerate teardown errors\n      }\n    };\n  }\n}\n"],"mappings":"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"}

package/dist/source.d.cts

@@ -0,0 +1,77 @@
+import { AccountFilters, AccountState, AccountToken, AssetFactoryState, AssetFilters, AssetState, BridgeFilters, ChainConfig, ChainInfo, DelegateState, DelegationFilters, FactoryFilters, IndexedAccountState, IndexedAssetState, IndexedDelegationState, IndexedFactoryState, IndexedRollupBlock, IndexedRollupState, IndexedRollupValidator, IndexedStakeState, IndexedTokenFlow, IndexedTokenState, IndexedTransaction, PagedResult, Paging, RollupBlock, RollupBlockFilters, RollupState, SearchResult, StakeFilters, StakeState, TokenFilters, TokenFlowDirection, TokenState, TransactionInfo, TxFilters, ValidatorInfo } from "./types.cjs";
+
+//#region src/source.d.ts
+/**
+ * Subset of @ocap/client's ForgeStats covering the fields chain-explorer
+ * actually consumes. We re-declare locally to avoid leaking the full GQL
+ * type surface into the OCAP provider's public interface.
+ */
+interface ForgeStatsSlice {
+  numTxs: string[];
+  numStakes: string[];
+  numValidators: number[];
+  numDeclareTxs: string[];
+}
+interface OcapDataSource {
+  getChainInfo(): Promise<ChainInfo>;
+  getConfig(): Promise<ChainConfig>;
+  getValidatorsInfo(): Promise<ValidatorInfo[]>;
+  /**
+   * Returns the chain-level forge stats (cumulative tx counters per type +
+   * historical TPS / block time). Used by readRoot to surface the
+   * "accountCount" metric — old block-explorer's account total comes from
+   * `numDeclareTxs[-1]`, not the indexer's listTopAccounts total. See
+   * planning/experience-upgrade § A.4.
+   */
+  getForgeStats(): Promise<{
+    forgeStats: ForgeStatsSlice;
+  }>;
+  getTx(hash: string): Promise<TransactionInfo | null>;
+  listTransactions(paging: Paging, filters?: TxFilters): Promise<PagedResult<IndexedTransaction>>;
+  getAccountState(address: string): Promise<AccountState | null>;
+  getAccountTokens(address: string): Promise<AccountToken[]>;
+  listTopAccounts(paging: Paging, filters?: AccountFilters): Promise<PagedResult<IndexedAccountState>>;
+  getTokenState(address: string): Promise<TokenState | null>;
+  listTokens(paging: Paging, filters?: TokenFilters): Promise<PagedResult<IndexedTokenState>>;
+  getAssetState(address: string): Promise<AssetState | null>;
+  listAssets(paging: Paging, filters?: AssetFilters): Promise<PagedResult<IndexedAssetState>>;
+  getFactoryState(address: string): Promise<AssetFactoryState | null>;
+  listFactories(paging: Paging, filters?: FactoryFilters): Promise<PagedResult<IndexedFactoryState>>;
+  getStakeState(address: string): Promise<StakeState | null>;
+  listStakes(paging: Paging, filters?: StakeFilters): Promise<PagedResult<IndexedStakeState>>;
+  getRollupState(address: string): Promise<RollupState | null>;
+  listRollups(paging: Paging, filters?: BridgeFilters): Promise<PagedResult<IndexedRollupState>>;
+  getRollupBlock(hash: string, rollupAddress: string): Promise<RollupBlock | null>;
+  listRollupBlocks(rollupAddress: string, paging: Paging, filters?: RollupBlockFilters): Promise<PagedResult<IndexedRollupBlock>>;
+  listRollupValidators(rollupAddress: string, paging: Paging): Promise<PagedResult<IndexedRollupValidator>>;
+  getDelegateState(address: string): Promise<DelegateState | null>;
+  listDelegations(paging: Paging, filters?: DelegationFilters): Promise<PagedResult<IndexedDelegationState>>;
+  search(keyword: string, paging: Paging): Promise<PagedResult<SearchResult>>;
+  /**
+   * Optional event subscription primitive. Sources that wrap a live phoenix
+   * upstream (e.g. `@ocap/client.subscribe`) implement this; static / mock
+   * sources omit it.
+   *
+   * @param topic phoenix topic string — typically `"tx.create"` or
+   *   `"tx.<type>"` (e.g. `"tx.transfer_v2"`).
+   * @param callback invoked with the raw upstream payload (subset of
+   *   `IndexedTransaction`). Must be tolerant of partial payloads — the
+   *   wire schema is provider-defined.
+   * @returns unsubscribe function. Calling it must idempotently release
+   *   the underlying upstream subscription.
+   */
+  subscribe?(topic: string, callback: (payload: unknown) => void): () => void;
+  /**
+   * Phase 0.2 — Token flow trail for an account, optionally restricted to a
+   * single token. Wraps @ocap/client.listTokenFlows; the upstream call
+   * resolves IN/OUT counterparties and amount values for a given depth.
+   */
+  listTokenFlows(accountAddress: string, paging: Paging, options?: {
+    tokenAddress?: string;
+    depth?: number;
+    direction?: TokenFlowDirection;
+  }): Promise<PagedResult<IndexedTokenFlow>>;
+}
+//#endregion
+export { ForgeStatsSlice, OcapDataSource };
+//# sourceMappingURL=source.d.cts.map

package/dist/source.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.cts","names":[],"sources":["../src/source.ts"],"mappings":";;;;;AA6CA;;;UAAiB,eAAA;EACf,MAAA;EACA,SAAA;EACA,aAAA;EACA,aAAA;AAAA;AAAA,UAKe,cAAA;EAEf,YAAA,IAAgB,OAAA,CAAQ,SAAA;EACxB,SAAA,IAAa,OAAA,CAAQ,WAAA;EACrB,iBAAA,IAAqB,OAAA,CAAQ,aAAA;EAFL;;;;;;;EAUxB,aAAA,IAAiB,OAAA;IAAU,UAAA,EAAY,eAAA;EAAA;EAGvC,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,eAAA;EAC7B,gBAAA,CAAiB,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,SAAA,GAAY,OAAA,CAAQ,WAAA,CAAY,kBAAA;EAG3E,eAAA,CAAgB,OAAA,WAAkB,OAAA,CAAQ,YAAA;EAC1C,gBAAA,CAAiB,OAAA,WAAkB,OAAA,CAAQ,YAAA;EAC3C,eAAA,CACE,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,WAAA,CAAY,mBAAA;EAGvB,aAAA,CAAc,OAAA,WAAkB,OAAA,CAAQ,UAAA;EACxC,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,WAAA,CAAY,iBAAA;EAGxE,aAAA,CAAc,OAAA,WAAkB,OAAA,CAAQ,UAAA;EACxC,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,WAAA,CAAY,iBAAA;EAGxE,eAAA,CAAgB,OAAA,WAAkB,OAAA,CAAQ,iBAAA;EAC1C,aAAA,CACE,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,WAAA,CAAY,mBAAA;EAGvB,aAAA,CAAc,OAAA,WAAkB,OAAA,CAAQ,UAAA;EACxC,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,WAAA,CAAY,iBAAA;EAGxE,cAAA,CAAe,OAAA,WAAkB,OAAA,CAAQ,WAAA;EACzC,WAAA,CAAY,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,aAAA,GAAgB,OAAA,CAAQ,WAAA,CAAY,kBAAA;EAG1E,cAAA,CAAe,IAAA,UAAc,aAAA,WAAwB,OAAA,CAAQ,WAAA;EAC7D,gBAAA,CACE,aAAA,UACA,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,kBAAA,GACT,OAAA,CAAQ,WAAA,CAAY,kBAAA;EAGvB,oBAAA,CACE,aAAA,UACA,MAAA,EAAQ,MAAA,GACP,OAAA,CAAQ,WAAA,CAAY,sBAAA;EAGvB,gBAAA,CAAiB,OAAA,WAAkB,OAAA,CAAQ,aAAA;EAC3C,eAAA,CACE,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,iBAAA,GACT,OAAA,CAAQ,WAAA,CAAY,sBAAA;EAGvB,MAAA,CAAO,OAAA,UAAiB,MAAA,EAAQ,MAAA,GAAS,OAAA,CAAQ,WAAA,CAAY,YAAA;EAxCrB;;;;;;;;;;;;;EAuDxC,SAAA,EAAW,KAAA,UAAe,QAAA,GAAW,OAAA;EA5CG;;;;;EAmDxC,cAAA,CACE,cAAA,UACA,MAAA,EAAQ,MAAA,EACR,OAAA;IACE,YAAA;IACA,KAAA;IACA,SAAA,GAAY,kBAAA;EAAA,IAEb,OAAA,CAAQ,WAAA,CAAY,gBAAA;AAAA"}

package/dist/source.d.mts

@@ -0,0 +1,77 @@
+import { AccountFilters, AccountState, AccountToken, AssetFactoryState, AssetFilters, AssetState, BridgeFilters, ChainConfig, ChainInfo, DelegateState, DelegationFilters, FactoryFilters, IndexedAccountState, IndexedAssetState, IndexedDelegationState, IndexedFactoryState, IndexedRollupBlock, IndexedRollupState, IndexedRollupValidator, IndexedStakeState, IndexedTokenFlow, IndexedTokenState, IndexedTransaction, PagedResult, Paging, RollupBlock, RollupBlockFilters, RollupState, SearchResult, StakeFilters, StakeState, TokenFilters, TokenFlowDirection, TokenState, TransactionInfo, TxFilters, ValidatorInfo } from "./types.mjs";
+
+//#region src/source.d.ts
+/**
+ * Subset of @ocap/client's ForgeStats covering the fields chain-explorer
+ * actually consumes. We re-declare locally to avoid leaking the full GQL
+ * type surface into the OCAP provider's public interface.
+ */
+interface ForgeStatsSlice {
+  numTxs: string[];
+  numStakes: string[];
+  numValidators: number[];
+  numDeclareTxs: string[];
+}
+interface OcapDataSource {
+  getChainInfo(): Promise<ChainInfo>;
+  getConfig(): Promise<ChainConfig>;
+  getValidatorsInfo(): Promise<ValidatorInfo[]>;
+  /**
+   * Returns the chain-level forge stats (cumulative tx counters per type +
+   * historical TPS / block time). Used by readRoot to surface the
+   * "accountCount" metric — old block-explorer's account total comes from
+   * `numDeclareTxs[-1]`, not the indexer's listTopAccounts total. See
+   * planning/experience-upgrade § A.4.
+   */
+  getForgeStats(): Promise<{
+    forgeStats: ForgeStatsSlice;
+  }>;
+  getTx(hash: string): Promise<TransactionInfo | null>;
+  listTransactions(paging: Paging, filters?: TxFilters): Promise<PagedResult<IndexedTransaction>>;
+  getAccountState(address: string): Promise<AccountState | null>;
+  getAccountTokens(address: string): Promise<AccountToken[]>;
+  listTopAccounts(paging: Paging, filters?: AccountFilters): Promise<PagedResult<IndexedAccountState>>;
+  getTokenState(address: string): Promise<TokenState | null>;
+  listTokens(paging: Paging, filters?: TokenFilters): Promise<PagedResult<IndexedTokenState>>;
+  getAssetState(address: string): Promise<AssetState | null>;
+  listAssets(paging: Paging, filters?: AssetFilters): Promise<PagedResult<IndexedAssetState>>;
+  getFactoryState(address: string): Promise<AssetFactoryState | null>;
+  listFactories(paging: Paging, filters?: FactoryFilters): Promise<PagedResult<IndexedFactoryState>>;
+  getStakeState(address: string): Promise<StakeState | null>;
+  listStakes(paging: Paging, filters?: StakeFilters): Promise<PagedResult<IndexedStakeState>>;
+  getRollupState(address: string): Promise<RollupState | null>;
+  listRollups(paging: Paging, filters?: BridgeFilters): Promise<PagedResult<IndexedRollupState>>;
+  getRollupBlock(hash: string, rollupAddress: string): Promise<RollupBlock | null>;
+  listRollupBlocks(rollupAddress: string, paging: Paging, filters?: RollupBlockFilters): Promise<PagedResult<IndexedRollupBlock>>;
+  listRollupValidators(rollupAddress: string, paging: Paging): Promise<PagedResult<IndexedRollupValidator>>;
+  getDelegateState(address: string): Promise<DelegateState | null>;
+  listDelegations(paging: Paging, filters?: DelegationFilters): Promise<PagedResult<IndexedDelegationState>>;
+  search(keyword: string, paging: Paging): Promise<PagedResult<SearchResult>>;
+  /**
+   * Optional event subscription primitive. Sources that wrap a live phoenix
+   * upstream (e.g. `@ocap/client.subscribe`) implement this; static / mock
+   * sources omit it.
+   *
+   * @param topic phoenix topic string — typically `"tx.create"` or
+   *   `"tx.<type>"` (e.g. `"tx.transfer_v2"`).
+   * @param callback invoked with the raw upstream payload (subset of
+   *   `IndexedTransaction`). Must be tolerant of partial payloads — the
+   *   wire schema is provider-defined.
+   * @returns unsubscribe function. Calling it must idempotently release
+   *   the underlying upstream subscription.
+   */
+  subscribe?(topic: string, callback: (payload: unknown) => void): () => void;
+  /**
+   * Phase 0.2 — Token flow trail for an account, optionally restricted to a
+   * single token. Wraps @ocap/client.listTokenFlows; the upstream call
+   * resolves IN/OUT counterparties and amount values for a given depth.
+   */
+  listTokenFlows(accountAddress: string, paging: Paging, options?: {
+    tokenAddress?: string;
+    depth?: number;
+    direction?: TokenFlowDirection;
+  }): Promise<PagedResult<IndexedTokenFlow>>;
+}
+//#endregion
+export { ForgeStatsSlice, OcapDataSource };
+//# sourceMappingURL=source.d.mts.map

package/dist/source.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"source.d.mts","names":[],"sources":["../src/source.ts"],"mappings":";;;;;AA6CA;;;UAAiB,eAAA;EACf,MAAA;EACA,SAAA;EACA,aAAA;EACA,aAAA;AAAA;AAAA,UAKe,cAAA;EAEf,YAAA,IAAgB,OAAA,CAAQ,SAAA;EACxB,SAAA,IAAa,OAAA,CAAQ,WAAA;EACrB,iBAAA,IAAqB,OAAA,CAAQ,aAAA;EAFL;;;;;;;EAUxB,aAAA,IAAiB,OAAA;IAAU,UAAA,EAAY,eAAA;EAAA;EAGvC,KAAA,CAAM,IAAA,WAAe,OAAA,CAAQ,eAAA;EAC7B,gBAAA,CAAiB,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,SAAA,GAAY,OAAA,CAAQ,WAAA,CAAY,kBAAA;EAG3E,eAAA,CAAgB,OAAA,WAAkB,OAAA,CAAQ,YAAA;EAC1C,gBAAA,CAAiB,OAAA,WAAkB,OAAA,CAAQ,YAAA;EAC3C,eAAA,CACE,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,WAAA,CAAY,mBAAA;EAGvB,aAAA,CAAc,OAAA,WAAkB,OAAA,CAAQ,UAAA;EACxC,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,WAAA,CAAY,iBAAA;EAGxE,aAAA,CAAc,OAAA,WAAkB,OAAA,CAAQ,UAAA;EACxC,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,WAAA,CAAY,iBAAA;EAGxE,eAAA,CAAgB,OAAA,WAAkB,OAAA,CAAQ,iBAAA;EAC1C,aAAA,CACE,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,cAAA,GACT,OAAA,CAAQ,WAAA,CAAY,mBAAA;EAGvB,aAAA,CAAc,OAAA,WAAkB,OAAA,CAAQ,UAAA;EACxC,UAAA,CAAW,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,YAAA,GAAe,OAAA,CAAQ,WAAA,CAAY,iBAAA;EAGxE,cAAA,CAAe,OAAA,WAAkB,OAAA,CAAQ,WAAA;EACzC,WAAA,CAAY,MAAA,EAAQ,MAAA,EAAQ,OAAA,GAAU,aAAA,GAAgB,OAAA,CAAQ,WAAA,CAAY,kBAAA;EAG1E,cAAA,CAAe,IAAA,UAAc,aAAA,WAAwB,OAAA,CAAQ,WAAA;EAC7D,gBAAA,CACE,aAAA,UACA,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,kBAAA,GACT,OAAA,CAAQ,WAAA,CAAY,kBAAA;EAGvB,oBAAA,CACE,aAAA,UACA,MAAA,EAAQ,MAAA,GACP,OAAA,CAAQ,WAAA,CAAY,sBAAA;EAGvB,gBAAA,CAAiB,OAAA,WAAkB,OAAA,CAAQ,aAAA;EAC3C,eAAA,CACE,MAAA,EAAQ,MAAA,EACR,OAAA,GAAU,iBAAA,GACT,OAAA,CAAQ,WAAA,CAAY,sBAAA;EAGvB,MAAA,CAAO,OAAA,UAAiB,MAAA,EAAQ,MAAA,GAAS,OAAA,CAAQ,WAAA,CAAY,YAAA;EAxCrB;;;;;;;;;;;;;EAuDxC,SAAA,EAAW,KAAA,UAAe,QAAA,GAAW,OAAA;EA5CG;;;;;EAmDxC,cAAA,CACE,cAAA,UACA,MAAA,EAAQ,MAAA,EACR,OAAA;IACE,YAAA;IACA,KAAA;IACA,SAAA,GAAY,kBAAA;EAAA,IAEb,OAAA,CAAQ,WAAA,CAAY,gBAAA;AAAA"}