@irpclib/irpc 1.0.0 → 1.1.0

package/dist/module.d.ts

@@ -57,21 +57,12 @@ declare class IRPCPackage<K extends string = 'id'> {
    * Declares a new IRPC specification and returns a callable stub.
    *
    * @param name - The unique name for the IRPC specification.
-   * @param seed - Factory function returning the initial data value.
-   * @param config - Optional configuration (description, schema, caching, etc).
+   * @param seedOrConfig - The initial data seed function, or configuration object.
+   * @param config - Optional configuration (if seed was provided).
    * @returns A stub function that can be used to call the IRPC.
    * @throws Error if an IRPC with the same name already exists.
    */
-  declare<F, I extends IRPCInputs = IRPCInputs, O extends IRPCOutput = IRPCOutput>(name: string, seed: () => IRPCReturnOf<F>, config?: IRPCDeclareConfig<I, O>): IRPCFunction<F>;
-  /**
-   * Declares a new IRPC specification and returns a callable stub.
-   *
-   * @param name - The unique name for the IRPC specification.
-   * @param config - Configuration object including seed and optional fields.
-   * @returns A stub function that can be used to call the IRPC.
-   * @throws Error if an IRPC with the same name already exists.
-   */
-  declare<F, I extends IRPCInputs = IRPCInputs, O extends IRPCOutput = IRPCOutput>(name: string, config: IRPCDeclareConfig<I, O> & IRPCInferInit<IRPCReturnOf<F>>): IRPCFunction<F>;
+  declare<F, I extends IRPCInputs = IRPCInputs, O extends IRPCOutput = IRPCOutput>(name: string, seedOrConfig: (() => IRPCReturnOf<F>) | (IRPCDeclareConfig<I, O> & IRPCInferInit<IRPCReturnOf<F>>), config?: IRPCDeclareConfig<I, O>): IRPCFunction<F>;
   /**
    * Declares a new IRPC specification and returns a callable stub.
    *

package/dist/module.js

@@ -162,7 +162,7 @@ var IRPCPackage = class {
 			const cached = caches.get(callKey);
 			if (cached) return cached.value;
 			if (spec.coalesce !== false && calls.has(callKey)) return calls.get(callKey);
-			const { timeout, maxRetries, retryDelay, retryMode } = {
+			const { timeout, maxRetries, retryDelay, retryMode, standalone } = {
 				...this.config,
 				...spec
 			};
@@ -170,7 +170,8 @@ var IRPCPackage = class {
 				timeout,
 				maxRetries,
 				retryDelay,
-				retryMode
+				retryMode,
+				standalone
 			};
 			const hooks = this.hooks.get(spec);
 			if (hooks) hooks.forEach((hook) => hook({

package/dist/transport.d.ts

@@ -50,13 +50,23 @@ declare class IRPCTransport {
    */
   close(call: IRPCCall): void;
   /**
-   * Dispatches a batch of RPC calls. This base implementation rejects all calls
-   * with a "not implemented" error. Subclasses should override this method to
-   * provide actual transport mechanism.
+   * Dispatches RPC calls over the transport. Subclasses must override this
+   * to provide the actual transport mechanism (HTTP, WebSocket, etc.).
+   *
+   * When `standalone` is true, the call requires its own dedicated HTTP
+   * round-trip with full response lifecycle (cookies, headers). This is
+   * used for operations like authentication where `Set-Cookie` headers
+   * must flow back to the client. Only one call is dispatched at a time
+   * in standalone mode.
+   *
+   * When `standalone` is false or undefined, calls may be batched and
+   * streamed together in a single request.
+   *
    * @param calls - An array of RPC calls to dispatch.
+   * @param standalone - When true, dispatch as a dedicated request with full HTTP lifecycle.
    * @returns A promise that resolves when all calls have been processed.
    */
-  protected dispatch(calls: IRPCCall[]): Promise<void>;
+  protected dispatch(calls: IRPCCall[], standalone?: boolean): Promise<void>;
 }
 //#endregion
 export { IRPCTransport };

package/dist/transport.js

@@ -55,8 +55,8 @@ var IRPCTransport = class {
 			retryMode,
 			retryDelay
 		}, reader);
-		if (spec.stream) {
-			this.dispatch([call]).finally(() => {}).catch((err) => IRPC_STORE.error(err, [{
+		if (spec.stream || config?.standalone) {
+			this.dispatch([call], config?.standalone).finally(() => {}).catch((err) => IRPC_STORE.error(err, [{
 				id: call.id,
 				name: call.payload.name
 			}]));
@@ -106,13 +106,23 @@ var IRPCTransport = class {
 		console.log("[irpc] Closing call", call);
 	}
 	/**
-	* Dispatches a batch of RPC calls. This base implementation rejects all calls
-	* with a "not implemented" error. Subclasses should override this method to
-	* provide actual transport mechanism.
+	* Dispatches RPC calls over the transport. Subclasses must override this
+	* to provide the actual transport mechanism (HTTP, WebSocket, etc.).
+	*
+	* When `standalone` is true, the call requires its own dedicated HTTP
+	* round-trip with full response lifecycle (cookies, headers). This is
+	* used for operations like authentication where `Set-Cookie` headers
+	* must flow back to the client. Only one call is dispatched at a time
+	* in standalone mode.
+	*
+	* When `standalone` is false or undefined, calls may be batched and
+	* streamed together in a single request.
+	*
 	* @param calls - An array of RPC calls to dispatch.
+	* @param standalone - When true, dispatch as a dedicated request with full HTTP lifecycle.
 	* @returns A promise that resolves when all calls have been processed.
 	*/
-	async dispatch(calls) {
+	async dispatch(calls, standalone) {
 		calls.forEach((call) => {
 			call.enqueue({
 				id: call.id,

package/dist/types.d.ts

@@ -396,6 +396,8 @@ type IRPCCallConfig = {
   retryMode?: 'linear' | 'exponential';
   /** Base delay between retries in milliseconds */
   retryDelay?: number;
+  /** Optional flag to dispatch the call as a standalone HTTP request with full cookie/header lifecycle */
+  standalone?: boolean;
 };
 /**
  * Configuration for transport layer, extending call configuration with debounce settings.

package/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "@irpclib/irpc",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "types": "./dist/index.d.ts",
   "module": "./dist/index.js",
   "exports": {
@@ -36,6 +36,7 @@
     "zod": "^4.1.5"
   },
   "peerDependencies": {
+    "@anchorlib/core": "^1.1.0",
     "typescript": "^5.9.3"
   },
   "optionalDependencies": {
@@ -44,14 +45,11 @@
   "scripts": {
     "dev": "rimraf dist && tsdown --watch ./src",
     "clean": "rimraf dist",
-    "build": "rimraf dist && tsdown && publint",
+    "build": "bun run clean && tsdown && publint",
     "format": "biome format --write",
     "test": "rimraf coverage && vitest --run",
     "test:preview": "rimraf coverage && vitest --run && vite preview --outDir coverage",
-    "prepublish": "bun run format && bun run clean && tsdown && publint"
+    "prepublish": "bun run format && bun run build"
   },
-  "license": "MIT",
-  "dependencies": {
-    "@anchorlib/core": "^1.0.0"
-  }
+  "license": "MIT"
 }