@orpc/experimental-durable-iterator 0.0.0 → 1.9.0

package/README.md

@@ -8,8 +8,8 @@
   <a href="https://codecov.io/gh/unnoq/orpc">
     <img alt="codecov" src="https://codecov.io/gh/unnoq/orpc/branch/main/graph/badge.svg">
   </a>
-  <a href="https://www.npmjs.com/package/@orpc/durable-event-iterator">
-    <img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fdurable-event-iterator?logo=npm" />
+  <a href="https://www.npmjs.com/package/@orpc/experimental-durable-iterator">
+    <img alt="weekly downloads" src="https://img.shields.io/npm/dw/%40orpc%2Fexperimental-durable-iterator?logo=npm" />
   </a>
   <a href="https://github.com/unnoq/orpc/blob/main/LICENSE">
     <img alt="MIT License" src="https://img.shields.io/github/license/unnoq/orpc?logo=open-source-initiative" />
@@ -61,7 +61,7 @@ You can find the full documentation [here](https://orpc.unnoq.com).
 - [@orpc/valibot](https://www.npmjs.com/package/@orpc/valibot): OpenAPI spec generation from [Valibot](https://valibot.dev/).
 - [@orpc/arktype](https://www.npmjs.com/package/@orpc/arktype): OpenAPI spec generation from [ArkType](https://arktype.io/).
 
-## `@orpc/durable-event-iterator`
+## `@orpc/experimental-durable-iterator`
 
 [Durable Objects](https://developers.cloudflare.com/durable-objects/) integration for oRPC.
 

package/dist/client/index.d.mts

@@ -1,9 +1,9 @@
-export { C as ClientDurableIterator, b as ClientDurableIteratorRpc, a as ClientDurableIteratorRpcContext, c as CreateClientDurableIteratorOptions, d as createClientDurableIterator, g as getClientDurableIteratorToken } from '../shared/experimental-durable-iterator.DDJKw0d4.mjs';
+export { C as ClientDurableIterator, b as ClientDurableIteratorRpc, a as ClientDurableIteratorRpcContext, c as CreateClientDurableIteratorOptions, d as createClientDurableIterator, g as getClientDurableIteratorToken } from '../shared/experimental-durable-iterator.DrenXxND.mjs';
 import { ClientContext } from '@orpc/client';
 import { StandardLinkInterceptorOptions, StandardLinkPlugin, StandardLinkOptions } from '@orpc/client/standard';
 import { RPCLinkOptions } from '@orpc/client/websocket';
 import { Value, Promisable } from '@orpc/shared';
-import { b as DurableIteratorTokenPayload } from '../shared/experimental-durable-iterator.Bh_-Jj0k.mjs';
+import { b as DurableIteratorTokenPayload } from '../shared/experimental-durable-iterator.DQjHfIr1.mjs';
 import '@orpc/client/plugins';
 import 'valibot';
 
@@ -12,7 +12,7 @@ interface DurableIteratorLinkPluginContext {
 }
 interface DurableIteratorLinkPluginOptions<T extends ClientContext> extends Omit<RPCLinkOptions<object>, 'websocket'> {
     /**
-     * The WebSocket URL to connect to the Durable Event Iterator Object.
+     * The WebSocket URL to connect to the Durable Iterator Object.
      */
     url: Value<Promisable<string | URL>, [tokenPayload: DurableIteratorTokenPayload, options: StandardLinkInterceptorOptions<T>]>;
     /**
@@ -24,7 +24,7 @@ interface DurableIteratorLinkPluginOptions<T extends ClientContext> extends Omit
      * @remarks
      * - Use a strong random generator to avoid collisions or predictable IDs.
      *
-     * @default (() => `${crypto.randomUUID()}-${crypto.randomUUID()}`)
+     * @default (() => crypto.randomUUID())
      */
     createId?: (tokenPayload: DurableIteratorTokenPayload, options: StandardLinkInterceptorOptions<T>) => Promisable<string>;
     /**
@@ -41,10 +41,13 @@ interface DurableIteratorLinkPluginOptions<T extends ClientContext> extends Omit
     refreshTokenBeforeExpireInSeconds?: Value<Promisable<number>, [tokenPayload: DurableIteratorTokenPayload, options: StandardLinkInterceptorOptions<T>]>;
 }
 /**
- * @see {@link https://orpc.unnoq.com/docs/integrations/durable-event-iterator Durable Event Iterator Integration}
+ * @see {@link https://orpc.unnoq.com/docs/integrations/durable-iterator Durable Iterator Integration}
  */
 declare class DurableIteratorLinkPlugin<T extends ClientContext> implements StandardLinkPlugin<T> {
     readonly CONTEXT_SYMBOL: symbol;
+    /**
+     * run before (modify result after) retry plugin because it can break the special iterator
+     */
     order: number;
     private readonly url;
     private readonly createId;

package/dist/client/index.d.ts

@@ -1,9 +1,9 @@
-export { C as ClientDurableIterator, b as ClientDurableIteratorRpc, a as ClientDurableIteratorRpcContext, c as CreateClientDurableIteratorOptions, d as createClientDurableIterator, g as getClientDurableIteratorToken } from '../shared/experimental-durable-iterator.B0U3VKpv.js';
+export { C as ClientDurableIterator, b as ClientDurableIteratorRpc, a as ClientDurableIteratorRpcContext, c as CreateClientDurableIteratorOptions, d as createClientDurableIterator, g as getClientDurableIteratorToken } from '../shared/experimental-durable-iterator.C6YPLbUA.js';
 import { ClientContext } from '@orpc/client';
 import { StandardLinkInterceptorOptions, StandardLinkPlugin, StandardLinkOptions } from '@orpc/client/standard';
 import { RPCLinkOptions } from '@orpc/client/websocket';
 import { Value, Promisable } from '@orpc/shared';
-import { b as DurableIteratorTokenPayload } from '../shared/experimental-durable-iterator.Bh_-Jj0k.js';
+import { b as DurableIteratorTokenPayload } from '../shared/experimental-durable-iterator.DQjHfIr1.js';
 import '@orpc/client/plugins';
 import 'valibot';
 
@@ -12,7 +12,7 @@ interface DurableIteratorLinkPluginContext {
 }
 interface DurableIteratorLinkPluginOptions<T extends ClientContext> extends Omit<RPCLinkOptions<object>, 'websocket'> {
     /**
-     * The WebSocket URL to connect to the Durable Event Iterator Object.
+     * The WebSocket URL to connect to the Durable Iterator Object.
      */
     url: Value<Promisable<string | URL>, [tokenPayload: DurableIteratorTokenPayload, options: StandardLinkInterceptorOptions<T>]>;
     /**
@@ -24,7 +24,7 @@ interface DurableIteratorLinkPluginOptions<T extends ClientContext> extends Omit
      * @remarks
      * - Use a strong random generator to avoid collisions or predictable IDs.
      *
-     * @default (() => `${crypto.randomUUID()}-${crypto.randomUUID()}`)
+     * @default (() => crypto.randomUUID())
      */
     createId?: (tokenPayload: DurableIteratorTokenPayload, options: StandardLinkInterceptorOptions<T>) => Promisable<string>;
     /**
@@ -41,10 +41,13 @@ interface DurableIteratorLinkPluginOptions<T extends ClientContext> extends Omit
     refreshTokenBeforeExpireInSeconds?: Value<Promisable<number>, [tokenPayload: DurableIteratorTokenPayload, options: StandardLinkInterceptorOptions<T>]>;
 }
 /**
- * @see {@link https://orpc.unnoq.com/docs/integrations/durable-event-iterator Durable Event Iterator Integration}
+ * @see {@link https://orpc.unnoq.com/docs/integrations/durable-iterator Durable Iterator Integration}
  */
 declare class DurableIteratorLinkPlugin<T extends ClientContext> implements StandardLinkPlugin<T> {
     readonly CONTEXT_SYMBOL: symbol;
+    /**
+     * run before (modify result after) retry plugin because it can break the special iterator
+     */
     order: number;
     private readonly url;
     private readonly createId;

package/dist/client/index.mjs

@@ -1,25 +1,27 @@
-import { c as createClientDurableIterator } from '../shared/experimental-durable-iterator.CP6Ouvmj.mjs';
-export { g as getClientDurableIteratorToken } from '../shared/experimental-durable-iterator.CP6Ouvmj.mjs';
+import { c as createClientDurableIterator } from '../shared/experimental-durable-iterator.B3M42lLK.mjs';
+export { g as getClientDurableIteratorToken } from '../shared/experimental-durable-iterator.B3M42lLK.mjs';
 import { createORPCClient } from '@orpc/client';
 import { ClientRetryPlugin } from '@orpc/client/plugins';
 import { RPCLink } from '@orpc/client/websocket';
-import { fallback, value, toArray, AsyncIteratorClass, retry } from '@orpc/shared';
+import { fallback, value, toArray, AsyncIteratorClass, retry, stringifyJSON } from '@orpc/shared';
 import { WebSocket } from 'partysocket';
-import { d as DURABLE_ITERATOR_ID_PARAM, c as DURABLE_ITERATOR_TOKEN_PARAM, D as DurableIteratorError, b as DURABLE_ITERATOR_PLUGIN_HEADER_KEY, a as DURABLE_ITERATOR_PLUGIN_HEADER_VALUE, p as parseDurableIteratorToken } from '../shared/experimental-durable-iterator.BBUZixu_.mjs';
+import { d as DURABLE_ITERATOR_ID_PARAM, c as DURABLE_ITERATOR_TOKEN_PARAM, D as DurableIteratorError, b as DURABLE_ITERATOR_PLUGIN_HEADER_KEY, a as DURABLE_ITERATOR_PLUGIN_HEADER_VALUE, p as parseDurableIteratorToken } from '../shared/experimental-durable-iterator.DZOLL3sf.mjs';
 import '@orpc/server/helpers';
 import 'valibot';
 
 class DurableIteratorLinkPlugin {
   CONTEXT_SYMBOL = Symbol("ORPC_DURABLE_ITERATOR_LINK_PLUGIN_CONTEXT");
-  order = 21e5;
-  // make sure execute before the batch plugin and after client retry plugin
+  /**
+   * run before (modify result after) retry plugin because it can break the special iterator
+   */
+  order = 15e5;
   url;
   createId;
   refreshTokenBeforeExpireInSeconds;
   linkOptions;
   constructor({ url, refreshTokenBeforeExpireInSeconds, ...options }) {
     this.url = url;
-    this.createId = fallback(options.createId, () => `${crypto.randomUUID()}-${crypto.randomUUID()}`);
+    this.createId = fallback(options.createId, () => crypto.randomUUID());
     this.refreshTokenBeforeExpireInSeconds = fallback(refreshTokenBeforeExpireInSeconds, Number.NaN);
     this.linkOptions = options;
   }
@@ -65,15 +67,10 @@ class DurableIteratorLinkPlugin {
         }
         const nowInSeconds = Math.floor(Date.now() / 1e3);
         refreshTokenBeforeExpireTimeoutId = setTimeout(async () => {
-          await retry({ times: Number.POSITIVE_INFINITY, delay: 2e3 }, async (exit) => {
+          const newTokenAndPayload = await retry({ times: Number.POSITIVE_INFINITY, delay: 2e3 }, async (exit) => {
             try {
               const output2 = await next();
-              const newTokenAndPayload = this.validateToken(output2, options2.path);
-              if (newTokenAndPayload.payload.chn !== tokenAndPayload.payload.chn) {
-                exit(new DurableIteratorError("Refreshed token must have the same channel with the original token"));
-              } else {
-                tokenAndPayload = newTokenAndPayload;
-              }
+              return this.validateToken(output2, options2.path);
             } catch (err) {
               if (isFinished) {
                 exit(err);
@@ -81,8 +78,14 @@ class DurableIteratorLinkPlugin {
               throw err;
             }
           });
+          const canProactivelyUpdateToken = newTokenAndPayload.payload.chn === tokenAndPayload.payload.chn && stringifyJSON(newTokenAndPayload.payload.tags) === stringifyJSON(tokenAndPayload.payload.tags);
+          tokenAndPayload = newTokenAndPayload;
           await refreshTokenBeforeExpire();
-          await durableClient.updateToken({ token: tokenAndPayload.token });
+          if (canProactivelyUpdateToken) {
+            await durableClient.updateToken({ token: tokenAndPayload.token });
+          } else {
+            websocket.reconnect();
+          }
         }, (tokenAndPayload.payload.exp - nowInSeconds - beforeSeconds) * 1e3);
       };
       refreshTokenBeforeExpire();

package/dist/durable-object/index.d.mts

@@ -1,8 +1,9 @@
 import { RPCHandlerOptions } from '@orpc/server/websocket';
 import { DurableObject } from 'cloudflare:workers';
-import { b as DurableIteratorTokenPayload, a as DurableIteratorObjectDef, D as DurableIteratorObject$1 } from '../shared/experimental-durable-iterator.Bh_-Jj0k.mjs';
+import { b as DurableIteratorTokenPayload, a as DurableIteratorObjectDef, D as DurableIteratorObject$1 } from '../shared/experimental-durable-iterator.DQjHfIr1.mjs';
 import { StandardRPCJsonSerializerOptions } from '@orpc/client/standard';
 import { Interceptor } from '@orpc/shared';
+export { withEventMeta } from '@orpc/server';
 import '@orpc/client';
 import 'valibot';
 
@@ -54,12 +55,12 @@ interface DurableIteratorWebsocketInternal {
 }
 interface DurableIteratorWebsocket extends WebSocket {
     /**
-     * Durable Event Iterator internal apis
+     * Durable Event internal apis
      */
     ['~orpc']: DurableIteratorWebsocketInternal;
 }
 /**
- * Create a Durable Event Iterator WebSocket from a regular WebSocket
+ * Create a Durable Iterator WebSocket from a regular WebSocket
  *
  * @info The websocket automatically closes if expired before sending data
  */
@@ -73,7 +74,7 @@ interface DurableIteratorObjectStateInternal {
      */
     original: DurableObjectState;
 }
-interface DurableIteratorObjectState extends DurableObjectState {
+interface DurableIteratorObjectState<TProps> extends DurableObjectState<TProps> {
     /**
      * DurableIteratorObjectState internal apis
      */
@@ -84,7 +85,7 @@ interface DurableIteratorObjectState extends DurableObjectState {
      */
     'getWebSockets'(...args: Parameters<DurableObjectState['getWebSockets']>): DurableIteratorWebsocket[];
 }
-declare function toDurableIteratorObjectState(original: DurableObjectState): DurableIteratorObjectState;
+declare function toDurableIteratorObjectState<TProps>(original: DurableObjectState<TProps>): DurableIteratorObjectState<TProps>;
 
 interface EventResumeStorageOptions extends StandardRPCJsonSerializerOptions {
     /**
@@ -105,13 +106,15 @@ interface EventResumeStorageOptions extends StandardRPCJsonSerializerOptions {
      *
      * @default 'orpc:durable-iterator:resume:'
      */
-    resumeTablePrefix?: string;
+    resumeSchemaPrefix?: string;
 }
 interface ResumeEventFilter {
+    /** Only websockets with these tags will receive the event */
+    tags?: readonly string[];
     /** Only websockets that are in this list will receive the event */
-    targets?: DurableIteratorWebsocket[];
+    targets?: readonly DurableIteratorWebsocket[];
     /** Websockets that are in this list will not receive the event */
-    exclude?: DurableIteratorWebsocket[];
+    exclude?: readonly DurableIteratorWebsocket[];
 }
 declare class EventResumeStorage<T extends object> {
     private readonly durableState;
@@ -139,28 +142,36 @@ declare class EventResumeStorage<T extends object> {
 }
 
 type DurableIteratorObjectRouterContext = {
-    object: DurableObject<any>;
+    object: DurableObject<any, any>;
     resumeStorage: EventResumeStorage<any>;
     websocket: DurableIteratorWebsocket;
     options: DurableIteratorObjectHandlerOptions;
 };
 interface PublishEventOptions {
+    /**
+     * Deliver the event only to websockets that have the specified tags.
+     */
+    tags?: readonly string[];
     /**
      * Restrict the event to a specific set of websockets.
      *
+     * Accept a list of websockets or a filter function.
+     *
      * Use this when security is important — only the listed websockets
      * will ever receive the event. Newly connected websockets are not
      * included unless explicitly added here.
      */
-    targets?: WebSocket[];
+    targets?: readonly WebSocket[] | ((ws: DurableIteratorWebsocket) => boolean);
     /**
      * Exclude certain websockets from receiving the event.
      *
+     * Accept a list of websockets or a filter function.
+     *
      * Use this when broadcasting widely but skipping a few clients
      * (e.g., the sender). Newly connected websockets may still receive
      * the event if not listed here, so this is less strict than `targets`.
      */
-    exclude?: WebSocket[];
+    exclude?: readonly WebSocket[] | ((ws: DurableIteratorWebsocket) => boolean);
 }
 interface DurableIteratorObjectHandlerOptions extends RPCHandlerOptions<DurableIteratorObjectRouterContext>, EventResumeStorageOptions {
     /**
@@ -176,7 +187,7 @@ interface DurableIteratorObjectHandlerOptions extends RPCHandlerOptions<DurableI
      */
     onSubscribed?: (websocket: DurableIteratorWebsocket, lastEventId: string | undefined) => void;
 }
-declare class DurableIteratorObjectHandler<T extends object> implements DurableIteratorObjectDef<T> {
+declare class DurableIteratorObjectHandler<T extends object, TProps> implements DurableIteratorObjectDef<T> {
     private readonly object;
     private readonly options;
     '~eventPayloadType'?: {
@@ -187,8 +198,8 @@ declare class DurableIteratorObjectHandler<T extends object> implements DurableI
     /**
      * Proxied, ensure you don't accidentally change internal state, and auto close if expired websockets before .send is called
      */
-    ctx: DurableIteratorObjectState;
-    constructor(ctx: DurableObjectState, object: DurableObject<any>, options: DurableIteratorObjectHandlerOptions);
+    ctx: DurableIteratorObjectState<TProps>;
+    constructor(ctx: DurableObjectState<TProps>, object: DurableObject<any, TProps>, options: DurableIteratorObjectHandlerOptions);
     /**
      * Publish an event to a set of clients.
      */
@@ -210,13 +221,13 @@ declare class DurableIteratorObjectHandler<T extends object> implements DurableI
     webSocketClose(ws_: WebSocket, _code: number, _reason: string, _wasClean: boolean): void | Promise<void>;
 }
 
-declare class DurableIteratorObject<T extends object, TEnv = unknown> extends DurableObject<TEnv> implements DurableIteratorObject$1<T> {
-    '~orpc': DurableIteratorObjectHandler<T>;
+declare class DurableIteratorObject<T extends object, TEnv = Cloudflare.Env, TProps = {}> extends DurableObject<TEnv, TProps> implements DurableIteratorObject$1<T> {
+    '~orpc': DurableIteratorObjectHandler<T, TProps>;
     /**
      * Proxied, ensure you don't accidentally change internal state, and auto close if expired websockets before .send is called
      */
-    protected ctx: DurableIteratorObjectState;
-    constructor(ctx: DurableObjectState, env: TEnv, options: DurableIteratorObjectHandlerOptions);
+    protected ctx: DurableIteratorObjectState<TProps>;
+    constructor(ctx: DurableObjectState<TProps>, env: TEnv, options: DurableIteratorObjectHandlerOptions);
     /**
      * Publish an event to clients
      */
@@ -253,6 +264,10 @@ interface UpgradeDurableIteratorRequestOptions {
      * The durable object namespace
      */
     namespace: DurableObjectNamespace<any>;
+    /**
+     * The options to use when getting the durable object stub
+     */
+    namespaceGetOptions?: DurableObjectNamespaceGetDurableObjectOptions;
     /**
      * intercept upgrade process
      */

package/dist/durable-object/index.d.ts

@@ -1,8 +1,9 @@
 import { RPCHandlerOptions } from '@orpc/server/websocket';
 import { DurableObject } from 'cloudflare:workers';
-import { b as DurableIteratorTokenPayload, a as DurableIteratorObjectDef, D as DurableIteratorObject$1 } from '../shared/experimental-durable-iterator.Bh_-Jj0k.js';
+import { b as DurableIteratorTokenPayload, a as DurableIteratorObjectDef, D as DurableIteratorObject$1 } from '../shared/experimental-durable-iterator.DQjHfIr1.js';
 import { StandardRPCJsonSerializerOptions } from '@orpc/client/standard';
 import { Interceptor } from '@orpc/shared';
+export { withEventMeta } from '@orpc/server';
 import '@orpc/client';
 import 'valibot';
 
@@ -54,12 +55,12 @@ interface DurableIteratorWebsocketInternal {
 }
 interface DurableIteratorWebsocket extends WebSocket {
     /**
-     * Durable Event Iterator internal apis
+     * Durable Event internal apis
      */
     ['~orpc']: DurableIteratorWebsocketInternal;
 }
 /**
- * Create a Durable Event Iterator WebSocket from a regular WebSocket
+ * Create a Durable Iterator WebSocket from a regular WebSocket
  *
  * @info The websocket automatically closes if expired before sending data
  */
@@ -73,7 +74,7 @@ interface DurableIteratorObjectStateInternal {
      */
     original: DurableObjectState;
 }
-interface DurableIteratorObjectState extends DurableObjectState {
+interface DurableIteratorObjectState<TProps> extends DurableObjectState<TProps> {
     /**
      * DurableIteratorObjectState internal apis
      */
@@ -84,7 +85,7 @@ interface DurableIteratorObjectState extends DurableObjectState {
      */
     'getWebSockets'(...args: Parameters<DurableObjectState['getWebSockets']>): DurableIteratorWebsocket[];
 }
-declare function toDurableIteratorObjectState(original: DurableObjectState): DurableIteratorObjectState;
+declare function toDurableIteratorObjectState<TProps>(original: DurableObjectState<TProps>): DurableIteratorObjectState<TProps>;
 
 interface EventResumeStorageOptions extends StandardRPCJsonSerializerOptions {
     /**
@@ -105,13 +106,15 @@ interface EventResumeStorageOptions extends StandardRPCJsonSerializerOptions {
      *
      * @default 'orpc:durable-iterator:resume:'
      */
-    resumeTablePrefix?: string;
+    resumeSchemaPrefix?: string;
 }
 interface ResumeEventFilter {
+    /** Only websockets with these tags will receive the event */
+    tags?: readonly string[];
     /** Only websockets that are in this list will receive the event */
-    targets?: DurableIteratorWebsocket[];
+    targets?: readonly DurableIteratorWebsocket[];
     /** Websockets that are in this list will not receive the event */
-    exclude?: DurableIteratorWebsocket[];
+    exclude?: readonly DurableIteratorWebsocket[];
 }
 declare class EventResumeStorage<T extends object> {
     private readonly durableState;
@@ -139,28 +142,36 @@ declare class EventResumeStorage<T extends object> {
 }
 
 type DurableIteratorObjectRouterContext = {
-    object: DurableObject<any>;
+    object: DurableObject<any, any>;
     resumeStorage: EventResumeStorage<any>;
     websocket: DurableIteratorWebsocket;
     options: DurableIteratorObjectHandlerOptions;
 };
 interface PublishEventOptions {
+    /**
+     * Deliver the event only to websockets that have the specified tags.
+     */
+    tags?: readonly string[];
     /**
      * Restrict the event to a specific set of websockets.
      *
+     * Accept a list of websockets or a filter function.
+     *
      * Use this when security is important — only the listed websockets
      * will ever receive the event. Newly connected websockets are not
      * included unless explicitly added here.
      */
-    targets?: WebSocket[];
+    targets?: readonly WebSocket[] | ((ws: DurableIteratorWebsocket) => boolean);
     /**
      * Exclude certain websockets from receiving the event.
      *
+     * Accept a list of websockets or a filter function.
+     *
      * Use this when broadcasting widely but skipping a few clients
      * (e.g., the sender). Newly connected websockets may still receive
      * the event if not listed here, so this is less strict than `targets`.
      */
-    exclude?: WebSocket[];
+    exclude?: readonly WebSocket[] | ((ws: DurableIteratorWebsocket) => boolean);
 }
 interface DurableIteratorObjectHandlerOptions extends RPCHandlerOptions<DurableIteratorObjectRouterContext>, EventResumeStorageOptions {
     /**
@@ -176,7 +187,7 @@ interface DurableIteratorObjectHandlerOptions extends RPCHandlerOptions<DurableI
      */
     onSubscribed?: (websocket: DurableIteratorWebsocket, lastEventId: string | undefined) => void;
 }
-declare class DurableIteratorObjectHandler<T extends object> implements DurableIteratorObjectDef<T> {
+declare class DurableIteratorObjectHandler<T extends object, TProps> implements DurableIteratorObjectDef<T> {
     private readonly object;
     private readonly options;
     '~eventPayloadType'?: {
@@ -187,8 +198,8 @@ declare class DurableIteratorObjectHandler<T extends object> implements DurableI
     /**
      * Proxied, ensure you don't accidentally change internal state, and auto close if expired websockets before .send is called
      */
-    ctx: DurableIteratorObjectState;
-    constructor(ctx: DurableObjectState, object: DurableObject<any>, options: DurableIteratorObjectHandlerOptions);
+    ctx: DurableIteratorObjectState<TProps>;
+    constructor(ctx: DurableObjectState<TProps>, object: DurableObject<any, TProps>, options: DurableIteratorObjectHandlerOptions);
     /**
      * Publish an event to a set of clients.
      */
@@ -210,13 +221,13 @@ declare class DurableIteratorObjectHandler<T extends object> implements DurableI
     webSocketClose(ws_: WebSocket, _code: number, _reason: string, _wasClean: boolean): void | Promise<void>;
 }
 
-declare class DurableIteratorObject<T extends object, TEnv = unknown> extends DurableObject<TEnv> implements DurableIteratorObject$1<T> {
-    '~orpc': DurableIteratorObjectHandler<T>;
+declare class DurableIteratorObject<T extends object, TEnv = Cloudflare.Env, TProps = {}> extends DurableObject<TEnv, TProps> implements DurableIteratorObject$1<T> {
+    '~orpc': DurableIteratorObjectHandler<T, TProps>;
     /**
      * Proxied, ensure you don't accidentally change internal state, and auto close if expired websockets before .send is called
      */
-    protected ctx: DurableIteratorObjectState;
-    constructor(ctx: DurableObjectState, env: TEnv, options: DurableIteratorObjectHandlerOptions);
+    protected ctx: DurableIteratorObjectState<TProps>;
+    constructor(ctx: DurableObjectState<TProps>, env: TEnv, options: DurableIteratorObjectHandlerOptions);
     /**
      * Publish an event to clients
      */
@@ -253,6 +264,10 @@ interface UpgradeDurableIteratorRequestOptions {
      * The durable object namespace
      */
     namespace: DurableObjectNamespace<any>;
+    /**
+     * The options to use when getting the durable object stub
+     */
+    namespaceGetOptions?: DurableObjectNamespaceGetDurableObjectOptions;
     /**
      * intercept upgrade process
      */

package/dist/durable-object/index.mjs

@@ -1,8 +1,9 @@
 import { getEventMeta, withEventMeta, implement, ORPCError } from '@orpc/server';
+export { withEventMeta } from '@orpc/server';
 import { HibernationEventIterator, encodeHibernationRPCEvent, HibernationPlugin } from '@orpc/server/hibernation';
 import { RPCHandler } from '@orpc/server/websocket';
 import { fallback, parseEmptyableJSON, stringifyJSON, get, toArray, intercept } from '@orpc/shared';
-import { D as DurableIteratorError, v as verifyDurableIteratorToken, c as DURABLE_ITERATOR_TOKEN_PARAM, d as DURABLE_ITERATOR_ID_PARAM } from '../shared/experimental-durable-iterator.BBUZixu_.mjs';
+import { D as DurableIteratorError, v as verifyDurableIteratorToken, c as DURABLE_ITERATOR_TOKEN_PARAM, d as DURABLE_ITERATOR_ID_PARAM } from '../shared/experimental-durable-iterator.DZOLL3sf.mjs';
 import { d as durableIteratorContract } from '../shared/experimental-durable-iterator.BRB0hiXN.mjs';
 import { StandardRPCJsonSerializer } from '@orpc/client/standard';
 import { DurableObject } from 'cloudflare:workers';
@@ -133,7 +134,7 @@ class EventResumeStorage {
   constructor(durableState, options = {}) {
     this.durableState = durableState;
     this.retentionSeconds = fallback(options.resumeRetentionSeconds, Number.NaN);
-    this.schemaPrefix = fallback(options.resumeTablePrefix, "orpc:durable-iterator:resume:");
+    this.schemaPrefix = fallback(options.resumeSchemaPrefix, "orpc:durable-iterator:resume:");
     this.serializer = new StandardRPCJsonSerializer(options);
     if (this.isEnabled) {
       this.initSchema();
@@ -165,8 +166,9 @@ class EventResumeStorage {
     );
     const insertEvent = () => {
       const insertResult = this.durableState.storage.sql.exec(
-        `INSERT INTO "${this.schemaPrefix}events" (payload, target_ids, exclusion_ids) VALUES (?, ?, ?) RETURNING CAST(id AS TEXT) as id`,
+        `INSERT INTO "${this.schemaPrefix}events" (payload, tags, target_ids, exclusion_ids) VALUES (?, ?, ?, ?) RETURNING CAST(id AS TEXT) as id`,
         serializedEvent,
+        stringifyJSON(resumeFilter.tags),
         stringifyJSON(targetIds),
         stringifyJSON(excludeIds)
       );
@@ -188,14 +190,19 @@ class EventResumeStorage {
       return [];
     }
     this.cleanupExpiredEvents();
+    const websocketTags = websocket["~orpc"].deserializeTokenPayload().tags;
     const websocketId = websocket["~orpc"].deserializeId();
     const resumeQuery = this.durableState.storage.sql.exec(`
-      SELECT CAST(id AS TEXT) as id, payload, target_ids, exclusion_ids
+      SELECT CAST(id AS TEXT) as id, payload, tags, target_ids, exclusion_ids
       FROM "${this.schemaPrefix}events"
       WHERE id > ?
       ORDER BY id ASC
     `, lastEventId);
     return resumeQuery.toArray().filter((resumeRecord) => {
+      const tags = parseEmptyableJSON(resumeRecord.tags);
+      if (tags && !tags.some((tag) => websocketTags?.includes(tag))) {
+        return false;
+      }
       const resumeTargetIds = parseEmptyableJSON(resumeRecord.target_ids);
       const resumeExclusionIds = parseEmptyableJSON(resumeRecord.exclusion_ids);
       if (resumeTargetIds && !resumeTargetIds.includes(websocketId)) {
@@ -215,6 +222,7 @@ class EventResumeStorage {
       CREATE TABLE IF NOT EXISTS "${this.schemaPrefix}events" (
         id INTEGER PRIMARY KEY AUTOINCREMENT,
         payload TEXT NOT NULL,
+        tags TEXT,
         target_ids TEXT,
         exclusion_ids TEXT,
         stored_at INTEGER NOT NULL DEFAULT (unixepoch())
@@ -268,6 +276,9 @@ const router = base.router({
     if (payload.chn !== old.chn) {
       throw new ORPCError("UNAUTHORIZED", { message: "Updated token must have the same channel with the original token" });
     }
+    if (stringifyJSON(payload.tags) !== stringifyJSON(old.tags)) {
+      throw new ORPCError("UNAUTHORIZED", { message: "Updated token must have the exact same tags with the original token" });
+    }
     context.websocket["~orpc"].serializeTokenPayload(payload);
   }),
   subscribe: base.subscribe.handler(({ context, lastEventId }) => {
@@ -327,13 +338,44 @@ class DurableIteratorObjectHandler {
    * Publish an event to a set of clients.
    */
   publishEvent(payload, options = {}) {
-    const targets = options.targets?.map((ws) => toDurableIteratorWebsocket(ws));
-    const exclude = options.exclude?.map((ws) => toDurableIteratorWebsocket(ws));
-    payload = this.resumeStorage.store(payload, { targets, exclude });
+    let targets = Array.isArray(options.targets) ? options.targets.map(toDurableIteratorWebsocket) : void 0;
+    const websocketsFilteredByTags = (() => {
+      if (targets) {
+        const uniqueTargets = targets.filter((ws, index) => {
+          const id = ws["~orpc"].deserializeId();
+          return targets?.findIndex((ws2) => ws2["~orpc"].deserializeId() === id) === index;
+        });
+        if (!options.tags) {
+          return uniqueTargets;
+        }
+        return uniqueTargets.filter(
+          (ws) => ws["~orpc"].deserializeTokenPayload().tags?.some((tag) => options.tags?.includes(tag))
+        );
+      }
+      if (options.tags) {
+        const websockets = options.tags.map((tag) => this.ctx.getWebSockets(tag)).flat();
+        const uniqueWebsockets = websockets.filter((ws, index) => {
+          const id = ws["~orpc"].deserializeId();
+          return websockets.findIndex((ws2) => ws2["~orpc"].deserializeId() === id) === index;
+        });
+        return uniqueWebsockets;
+      } else {
+        return this.ctx.getWebSockets();
+      }
+    })();
+    if (typeof options.targets === "function") {
+      targets = websocketsFilteredByTags.filter(options.targets);
+    }
+    const exclude = Array.isArray(options.exclude) ? options.exclude.map(toDurableIteratorWebsocket) : typeof options.exclude === "function" ? websocketsFilteredByTags.filter(options.exclude) : void 0;
+    payload = this.resumeStorage.store(payload, { tags: options.tags, targets, exclude });
+    const targetIds = targets?.map((ws) => ws["~orpc"].deserializeId());
     const excludeIds = exclude?.map((ws) => ws["~orpc"].deserializeId());
-    const fallbackTargets = targets ?? this.ctx.getWebSockets().map((ws) => toDurableIteratorWebsocket(ws));
-    for (const ws of fallbackTargets) {
-      if (excludeIds?.includes(ws["~orpc"].deserializeId())) {
+    for (const ws of websocketsFilteredByTags) {
+      const wsId = ws["~orpc"].deserializeId();
+      if (targetIds && !targetIds.includes(wsId)) {
+        continue;
+      }
+      if (excludeIds?.includes(wsId)) {
         continue;
       }
       const hibernationId = ws["~orpc"].deserializeHibernationId();
@@ -366,7 +408,11 @@ class DurableIteratorObjectHandler {
       return new Response("Invalid Token", { status: 401 });
     }
     const { "0": client, "1": server } = new WebSocketPair();
-    this.ctx.acceptWebSocket(server);
+    if (payload.tags) {
+      this.ctx.acceptWebSocket(server, [...payload.tags]);
+    } else {
+      this.ctx.acceptWebSocket(server);
+    }
     toDurableIteratorWebsocket(server)["~orpc"].serializeId(id);
     toDurableIteratorWebsocket(server)["~orpc"].serializeTokenPayload(payload);
     return new Response(null, {
@@ -481,7 +527,7 @@ async function upgradeDurableIteratorRequest(request, options) {
     async ({ payload: payload2 }) => {
       const namespace = options.namespace;
       const id2 = namespace.idFromName(payload2.chn);
-      const stub = namespace.get(id2);
+      const stub = namespace.get(id2, options.namespaceGetOptions);
       return stub.fetch(request);
     }
   );

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 import * as _orpc_contract from '@orpc/contract';
 import { AsyncIteratorClass } from '@orpc/shared';
 import * as v from 'valibot';
-import { C as ClientDurableIterator } from './shared/experimental-durable-iterator.DDJKw0d4.mjs';
-import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './shared/experimental-durable-iterator.Bh_-Jj0k.mjs';
-export { a as DurableIteratorObjectDef, b as DurableIteratorTokenPayload, p as parseDurableIteratorToken, s as signDurableIteratorToken, v as verifyDurableIteratorToken } from './shared/experimental-durable-iterator.Bh_-Jj0k.mjs';
+import { C as ClientDurableIterator } from './shared/experimental-durable-iterator.DrenXxND.mjs';
+import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './shared/experimental-durable-iterator.DQjHfIr1.mjs';
+export { a as DurableIteratorObjectDef, b as DurableIteratorTokenPayload, p as parseDurableIteratorToken, s as signDurableIteratorToken, v as verifyDurableIteratorToken } from './shared/experimental-durable-iterator.DQjHfIr1.mjs';
 import { Context, Router } from '@orpc/server';
 import { StandardHandlerPlugin, StandardHandlerOptions } from '@orpc/server/standard';
 import '@orpc/client';
@@ -40,6 +40,10 @@ interface DurableIteratorOptions<T extends DurableIteratorObject<any>, RPC exten
      * @default 24 hours (60 * 60 * 24)
      */
     tokenTTLSeconds?: number;
+    /**
+     * Tags to attach to the token.
+     */
+    tags?: readonly string[];
     /**
      * Token's attachment
      */
@@ -68,10 +72,13 @@ interface DurableIteratorHandlerPluginContext {
     isClientDurableIteratorOutput?: boolean;
 }
 /**
- * @see {@link https://orpc.unnoq.com/docs/integrations/durable-event-iterator Durable Event Iterator Integration}
+ * @see {@link https://orpc.unnoq.com/docs/integrations/durable-iterator Durable Iterator Integration}
  */
 declare class DurableIteratorHandlerPlugin<T extends Context> implements StandardHandlerPlugin<T> {
     readonly CONTEXT_SYMBOL: symbol;
+    /**
+     * make sure run after batch plugin
+     */
     order: number;
     init(options: StandardHandlerOptions<T>, _router: Router<any, T>): void;
 }

package/dist/index.d.ts

@@ -1,9 +1,9 @@
 import * as _orpc_contract from '@orpc/contract';
 import { AsyncIteratorClass } from '@orpc/shared';
 import * as v from 'valibot';
-import { C as ClientDurableIterator } from './shared/experimental-durable-iterator.B0U3VKpv.js';
-import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './shared/experimental-durable-iterator.Bh_-Jj0k.js';
-export { a as DurableIteratorObjectDef, b as DurableIteratorTokenPayload, p as parseDurableIteratorToken, s as signDurableIteratorToken, v as verifyDurableIteratorToken } from './shared/experimental-durable-iterator.Bh_-Jj0k.js';
+import { C as ClientDurableIterator } from './shared/experimental-durable-iterator.C6YPLbUA.js';
+import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './shared/experimental-durable-iterator.DQjHfIr1.js';
+export { a as DurableIteratorObjectDef, b as DurableIteratorTokenPayload, p as parseDurableIteratorToken, s as signDurableIteratorToken, v as verifyDurableIteratorToken } from './shared/experimental-durable-iterator.DQjHfIr1.js';
 import { Context, Router } from '@orpc/server';
 import { StandardHandlerPlugin, StandardHandlerOptions } from '@orpc/server/standard';
 import '@orpc/client';
@@ -40,6 +40,10 @@ interface DurableIteratorOptions<T extends DurableIteratorObject<any>, RPC exten
      * @default 24 hours (60 * 60 * 24)
      */
     tokenTTLSeconds?: number;
+    /**
+     * Tags to attach to the token.
+     */
+    tags?: readonly string[];
     /**
      * Token's attachment
      */
@@ -68,10 +72,13 @@ interface DurableIteratorHandlerPluginContext {
     isClientDurableIteratorOutput?: boolean;
 }
 /**
- * @see {@link https://orpc.unnoq.com/docs/integrations/durable-event-iterator Durable Event Iterator Integration}
+ * @see {@link https://orpc.unnoq.com/docs/integrations/durable-iterator Durable Iterator Integration}
  */
 declare class DurableIteratorHandlerPlugin<T extends Context> implements StandardHandlerPlugin<T> {
     readonly CONTEXT_SYMBOL: symbol;
+    /**
+     * make sure run after batch plugin
+     */
     order: number;
     init(options: StandardHandlerOptions<T>, _router: Router<any, T>): void;
 }

package/dist/index.mjs

@@ -1,8 +1,8 @@
-import { s as signDurableIteratorToken, D as DurableIteratorError, a as DURABLE_ITERATOR_PLUGIN_HEADER_VALUE, b as DURABLE_ITERATOR_PLUGIN_HEADER_KEY } from './shared/experimental-durable-iterator.BBUZixu_.mjs';
-export { d as DURABLE_ITERATOR_ID_PARAM, c as DURABLE_ITERATOR_TOKEN_PARAM, p as parseDurableIteratorToken, v as verifyDurableIteratorToken } from './shared/experimental-durable-iterator.BBUZixu_.mjs';
+import { s as signDurableIteratorToken, D as DurableIteratorError, a as DURABLE_ITERATOR_PLUGIN_HEADER_VALUE, b as DURABLE_ITERATOR_PLUGIN_HEADER_KEY } from './shared/experimental-durable-iterator.DZOLL3sf.mjs';
+export { d as DURABLE_ITERATOR_ID_PARAM, c as DURABLE_ITERATOR_TOKEN_PARAM, p as parseDurableIteratorToken, v as verifyDurableIteratorToken } from './shared/experimental-durable-iterator.DZOLL3sf.mjs';
 export { d as durableIteratorContract } from './shared/experimental-durable-iterator.BRB0hiXN.mjs';
 import { AsyncIteratorClass } from '@orpc/shared';
-import { c as createClientDurableIterator, g as getClientDurableIteratorToken } from './shared/experimental-durable-iterator.CP6Ouvmj.mjs';
+import { c as createClientDurableIterator, g as getClientDurableIteratorToken } from './shared/experimental-durable-iterator.B3M42lLK.mjs';
 import '@orpc/client';
 import '@orpc/client/plugins';
 import '@orpc/client/websocket';
@@ -31,6 +31,7 @@ class DurableIterator {
       const nowInSeconds = Math.floor(Date.now() / 1e3);
       const token = await signDurableIteratorToken(this.options.signingKey, {
         chn: this.chn,
+        tags: this.options.tags,
         att: this.options.att,
         rpc: this.options.rpc,
         iat: nowInSeconds,
@@ -55,8 +56,10 @@ class DurableIterator {
 
 class DurableIteratorHandlerPlugin {
   CONTEXT_SYMBOL = Symbol("ORPC_DURABLE_ITERATOR_HANDLER_PLUGIN_CONTEXT");
-  order = 21e5;
-  // make sure execute after the batch plugin
+  /**
+   * make sure run after batch plugin
+   */
+  order = 15e5;
   init(options, _router) {
     options.interceptors ??= [];
     options.clientInterceptors ??= [];

package/dist/shared/{experimental-durable-iterator.CP6Ouvmj.mjs → experimental-durable-iterator.B3M42lLK.mjs}

@@ -1,6 +1,6 @@
 import { createORPCClient } from '@orpc/client';
 import { isAsyncIteratorObject } from '@orpc/shared';
-import { p as parseDurableIteratorToken } from './experimental-durable-iterator.BBUZixu_.mjs';
+import { p as parseDurableIteratorToken } from './experimental-durable-iterator.DZOLL3sf.mjs';
 
 const CLIENT_DURABLE_ITERATOR_TOKEN_SYMBOL = Symbol("ORPC_CLIENT_DURABLE_ITERATOR_TOKEN");
 function createClientDurableIterator(iterator, link, options) {

package/dist/shared/{experimental-durable-iterator.B0U3VKpv.d.ts → experimental-durable-iterator.C6YPLbUA.d.ts}

@@ -1,7 +1,7 @@
 import { NestedClient, Client, ThrowableError, ClientLink } from '@orpc/client';
 import { ClientRetryPluginContext } from '@orpc/client/plugins';
 import { AsyncIteratorClass } from '@orpc/shared';
-import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './experimental-durable-iterator.Bh_-Jj0k.js';
+import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './experimental-durable-iterator.DQjHfIr1.js';
 
 interface ClientDurableIteratorRpcContext extends ClientRetryPluginContext {
 }
@@ -20,7 +20,7 @@ interface CreateClientDurableIteratorOptions {
 }
 declare function createClientDurableIterator<T extends DurableIteratorObject<any>, RPC extends InferDurableIteratorObjectRPC<T>>(iterator: AsyncIteratorClass<T>, link: ClientLink<object>, options: CreateClientDurableIteratorOptions): ClientDurableIterator<T, RPC>;
 /**
- * If return a token if the client is a Client Durable Event Iterator.
+ * If return a token if the client is a Client Durable Iterator.
  */
 declare function getClientDurableIteratorToken(client: unknown): string | undefined;
 

package/dist/shared/{experimental-durable-iterator.Bh_-Jj0k.d.mts → experimental-durable-iterator.DQjHfIr1.d.mts}

@@ -17,6 +17,7 @@ type InferDurableIteratorObjectRPC<T extends DurableIteratorObject<any>> = Exclu
 type DurableIteratorTokenPayload = v.InferOutput<typeof DurableIteratorTokenPayloadSchema>;
 declare const DurableIteratorTokenPayloadSchema: v.ObjectSchema<{
     readonly chn: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Channel name">]>;
+    readonly tags: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>, v.ReadonlyAction<string[] | undefined>, v.DescriptionAction<readonly string[] | undefined, "Tags">]>;
     readonly att: v.SchemaWithPipe<readonly [v.OptionalSchema<v.UnknownSchema, undefined>, v.DescriptionAction<unknown, "Attachment">]>;
     readonly rpc: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>, v.ReadonlyAction<string[] | undefined>, v.DescriptionAction<readonly string[] | undefined, "Allowed remote methods">]>;
     readonly iat: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.DescriptionAction<number, "Issued at time in seconds">]>;

package/dist/shared/{experimental-durable-iterator.Bh_-Jj0k.d.ts → experimental-durable-iterator.DQjHfIr1.d.ts}

@@ -17,6 +17,7 @@ type InferDurableIteratorObjectRPC<T extends DurableIteratorObject<any>> = Exclu
 type DurableIteratorTokenPayload = v.InferOutput<typeof DurableIteratorTokenPayloadSchema>;
 declare const DurableIteratorTokenPayloadSchema: v.ObjectSchema<{
     readonly chn: v.SchemaWithPipe<readonly [v.StringSchema<undefined>, v.DescriptionAction<string, "Channel name">]>;
+    readonly tags: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>, v.ReadonlyAction<string[] | undefined>, v.DescriptionAction<readonly string[] | undefined, "Tags">]>;
     readonly att: v.SchemaWithPipe<readonly [v.OptionalSchema<v.UnknownSchema, undefined>, v.DescriptionAction<unknown, "Attachment">]>;
     readonly rpc: v.SchemaWithPipe<readonly [v.OptionalSchema<v.ArraySchema<v.StringSchema<undefined>, undefined>, undefined>, v.ReadonlyAction<string[] | undefined>, v.DescriptionAction<readonly string[] | undefined, "Allowed remote methods">]>;
     readonly iat: v.SchemaWithPipe<readonly [v.NumberSchema<undefined>, v.DescriptionAction<number, "Issued at time in seconds">]>;

package/dist/shared/{experimental-durable-iterator.BBUZixu_.mjs → experimental-durable-iterator.DZOLL3sf.mjs}

@@ -12,6 +12,7 @@ class DurableIteratorError extends Error {
 
 const DurableIteratorTokenPayloadSchema = v.object({
   chn: v.pipe(v.string(), v.description("Channel name")),
+  tags: v.pipe(v.optional(v.array(v.string())), v.readonly(), v.description("Tags")),
   att: v.pipe(v.optional(v.unknown()), v.description("Attachment")),
   rpc: v.pipe(v.optional(v.array(v.string())), v.readonly(), v.description("Allowed remote methods")),
   iat: v.pipe(v.number(), v.description("Issued at time in seconds")),

package/dist/shared/{experimental-durable-iterator.DDJKw0d4.d.mts → experimental-durable-iterator.DrenXxND.d.mts}

@@ -1,7 +1,7 @@
 import { NestedClient, Client, ThrowableError, ClientLink } from '@orpc/client';
 import { ClientRetryPluginContext } from '@orpc/client/plugins';
 import { AsyncIteratorClass } from '@orpc/shared';
-import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './experimental-durable-iterator.Bh_-Jj0k.mjs';
+import { D as DurableIteratorObject, I as InferDurableIteratorObjectRPC } from './experimental-durable-iterator.DQjHfIr1.mjs';
 
 interface ClientDurableIteratorRpcContext extends ClientRetryPluginContext {
 }
@@ -20,7 +20,7 @@ interface CreateClientDurableIteratorOptions {
 }
 declare function createClientDurableIterator<T extends DurableIteratorObject<any>, RPC extends InferDurableIteratorObjectRPC<T>>(iterator: AsyncIteratorClass<T>, link: ClientLink<object>, options: CreateClientDurableIteratorOptions): ClientDurableIterator<T, RPC>;
 /**
- * If return a token if the client is a Client Durable Event Iterator.
+ * If return a token if the client is a Client Durable Iterator.
  */
 declare function getClientDurableIteratorToken(client: unknown): string | undefined;
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@orpc/experimental-durable-iterator",
   "type": "module",
-  "version": "0.0.0",
+  "version": "1.9.0",
   "license": "MIT",
   "homepage": "https://orpc.unnoq.com",
   "repository": {
@@ -36,15 +36,15 @@
   "dependencies": {
     "partysocket": "^1.1.5",
     "valibot": "^1.1.0",
-    "@orpc/client": "1.8.7",
-    "@orpc/contract": "1.8.7",
-    "@orpc/server": "1.8.7",
-    "@orpc/shared": "1.8.7"
+    "@orpc/client": "1.9.0",
+    "@orpc/server": "1.9.0",
+    "@orpc/shared": "1.9.0",
+    "@orpc/contract": "1.9.0"
   },
   "devDependencies": {
-    "@cloudflare/workers-types": "^4.20250903.0",
+    "@cloudflare/workers-types": "^4.20250922.0",
     "@types/node": "^22.15.30",
-    "@orpc/standard-server-peer": "1.8.7"
+    "@orpc/standard-server-peer": "1.9.0"
   },
   "scripts": {
     "build": "unbuild",