iii-sdk 0.19.3 → 0.19.4-alpha.2

package/dist/{utils-BnRzIUCy.d.cts → types-DduY0ha2.d.mts}

@@ -1,4 +1,5 @@
 import { Readable, Writable } from "node:stream";
+import { HttpInvocationConfig } from "@iii-dev/helpers/http";
 
 //#region src/iii-types.d.ts
 declare enum MessageType {
@@ -18,6 +19,11 @@ type RegisterTriggerTypeMessage = {
   id: string;
   description: string;
 };
+type ErrorBody = {
+  code: string;
+  message: string;
+  stacktrace?: string;
+};
 type RegisterTriggerMessage = {
   message_type: MessageType.RegisterTrigger;
   id: string;
@@ -26,35 +32,6 @@ type RegisterTriggerMessage = {
   config: unknown;
   metadata?: Record<string, unknown>;
 };
-/**
- * Authentication configuration for HTTP-invoked functions.
- *
- * - `hmac` -- HMAC signature verification using a shared secret.
- * - `bearer` -- Bearer token authentication.
- * - `api_key` -- API key sent via a custom header.
- */
-type HttpAuthConfig = {
-  type: 'hmac';
-  secret_key: string;
-} | {
-  type: 'bearer';
-  token_key: string;
-} | {
-  type: 'api_key';
-  header: string;
-  value_key: string;
-};
-/**
- * Configuration for registering an HTTP-invoked function (Lambda, Cloudflare
- * Workers, etc.) instead of a local handler.
- */
-type HttpInvocationConfig = {
-  /** URL to invoke. */url: string; /** HTTP method. Defaults to `POST`. */
-  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'; /** Timeout in milliseconds. */
-  timeout_ms?: number; /** Custom headers to send with the request. */
-  headers?: Record<string, string>; /** Authentication configuration. */
-  auth?: HttpAuthConfig;
-};
 type RegisterFunctionFormat = {
   /**
    * The name of the parameter
@@ -119,30 +96,6 @@ type TriggerAction = {
 } | {
   type: 'void';
 };
-/**
- * Input passed to the RBAC auth function during WebSocket upgrade.
- * Contains the HTTP headers, query parameters, and client IP from the
- * connecting worker's upgrade request.
- */
-type AuthInput = {
-  /** HTTP headers from the WebSocket upgrade request. */headers: Record<string, string>; /** Query parameters from the upgrade URL. Each key maps to an array of values to support repeated keys. */
-  query_params: Record<string, string[]>; /** IP address of the connecting client. */
-  ip_address: string;
-};
-/**
- * Return value from the RBAC auth function. Controls which functions the
- * authenticated worker can invoke and what context is forwarded to the
- * middleware.
- */
-type AuthResult = {
-  /** Additional function IDs to allow beyond the `expose_functions` config. */allowed_functions: string[]; /** Function IDs to deny even if they match `expose_functions`. Takes precedence over allowed. */
-  forbidden_functions: string[]; /** Trigger type IDs the worker may register triggers for. When omitted, all types are allowed. */
-  allowed_trigger_types?: string[]; /** Whether the worker may register new trigger types. */
-  allow_trigger_type_registration: boolean; /** Whether the worker may register new functions. Defaults to `true` if omitted. */
-  allow_function_registration?: boolean; /** Arbitrary context forwarded to the middleware function on every invocation. */
-  context: Record<string, unknown>; /** Optional prefix applied to all function IDs registered by this worker. */
-  function_registration_prefix?: string;
-};
 /**
  * Input passed to the RBAC middleware function on every function invocation
  * through the RBAC port. The middleware can inspect, modify, or reject the
@@ -154,79 +107,6 @@ type MiddlewareFunctionInput = {
   action?: TriggerAction; /** Auth context returned by the auth function for this session. */
   context: Record<string, unknown>;
 };
-/**
- * Input passed to the `on_trigger_type_registration_function_id` hook
- * when a worker attempts to register a new trigger type through the RBAC port.
- * Return an {@link OnTriggerTypeRegistrationResult} with the (possibly mapped)
- * fields, or throw to deny the registration.
- */
-type OnTriggerTypeRegistrationInput = {
-  /** ID of the trigger type being registered. */trigger_type_id: string; /** Human-readable description of the trigger type. */
-  description: string; /** Auth context from `AuthResult.context` for this session. */
-  context: Record<string, unknown>;
-};
-/**
- * Result returned from the `on_trigger_type_registration_function_id` hook.
- * All fields are optional -- omitted fields keep the original value from the
- * registration request.
- */
-type OnTriggerTypeRegistrationResult = {
-  /** Mapped trigger type ID. */trigger_type_id?: string; /** Mapped description. */
-  description?: string;
-};
-/**
- * Input passed to the `on_trigger_registration_function_id` hook
- * when a worker attempts to register a trigger through the RBAC port.
- * Return an {@link OnTriggerRegistrationResult} with the (possibly mapped)
- * fields, or throw to deny the registration.
- */
-type OnTriggerRegistrationInput = {
-  /** ID of the trigger being registered. */trigger_id: string; /** Trigger type identifier. */
-  trigger_type: string; /** ID of the function this trigger is bound to. */
-  function_id: string; /** Trigger-specific configuration. */
-  config: unknown; /** Arbitrary metadata attached to the trigger. */
-  metadata?: Record<string, unknown>; /** Auth context from `AuthResult.context` for this session. */
-  context: Record<string, unknown>;
-};
-/**
- * Result returned from the `on_trigger_registration_function_id` hook.
- * All fields are optional -- omitted fields keep the original value from the
- * registration request.
- */
-type OnTriggerRegistrationResult = {
-  /** Mapped trigger ID. */trigger_id?: string; /** Mapped trigger type. */
-  trigger_type?: string; /** Mapped function ID. */
-  function_id?: string; /** Mapped trigger configuration. */
-  config?: unknown;
-};
-/**
- * Input passed to the `on_function_registration_function_id` hook
- * when a worker attempts to register a function through the RBAC port.
- * Return an {@link OnFunctionRegistrationResult} with the (possibly mapped)
- * fields, or throw to deny the registration.
- */
-type OnFunctionRegistrationInput = {
-  /** ID of the function being registered. */function_id: string; /** Human-readable description of the function. */
-  description?: string; /** Arbitrary metadata attached to the function. */
-  metadata?: Record<string, unknown>; /** Auth context from `AuthResult.context` for this session. */
-  context: Record<string, unknown>;
-};
-/**
- * Result returned from the `on_function_registration_function_id` hook.
- * All fields are optional -- omitted fields keep the original value from the
- * registration request.
- */
-type OnFunctionRegistrationResult = {
-  /** Mapped function ID. */function_id?: string; /** Mapped description. */
-  description?: string; /** Mapped metadata. */
-  metadata?: Record<string, unknown>;
-};
-/**
- * Result returned when a function is invoked with `TriggerAction.Enqueue`.
- */
-type EnqueueResult = {
-  /** Unique receipt ID for the enqueued message. */messageReceiptId: string;
-};
 /**
  * Request object passed to {@link ISdk.trigger}.
  *
@@ -397,7 +277,7 @@ type RegisterTriggerInput = Omit<RegisterTriggerMessage, 'message_type' | 'id'>;
 type RegisterFunctionInput = Omit<RegisterFunctionMessage, 'message_type'>;
 type RegisterFunctionOptions = Omit<RegisterFunctionMessage, 'message_type' | 'id'>;
 type RegisterTriggerTypeInput = Omit<RegisterTriggerTypeMessage, 'message_type'>;
-interface ISdk {
+interface IIIClient {
   /**
    * Registers a new trigger. A trigger is a way to invoke a function when a certain event occurs.
    * @param trigger - The trigger to register
@@ -530,15 +410,17 @@ interface ISdk {
    */
   shutdown(): Promise<void>;
 }
+/** @deprecated Renamed to `IIIClient`. */
+type ISdk = IIIClient;
 /**
- * Handle returned by {@link ISdk.registerTrigger}. Use `unregister()` to
+ * Handle returned by {@link IIIClient.registerTrigger}. Use `unregister()` to
  * remove the trigger from the engine.
  */
 type Trigger = {
   /** Removes this trigger from the engine. */unregister(): void;
 };
 /**
- * Handle returned by {@link ISdk.registerFunction}. Contains the function's
+ * Handle returned by {@link IIIClient.registerFunction}. Contains the function's
  * `id` and an `unregister()` method.
  */
 type FunctionRef = {
@@ -546,7 +428,7 @@ type FunctionRef = {
   unregister: () => void;
 };
 /**
- * Typed handle returned by {@link ISdk.registerTriggerType}.
+ * Typed handle returned by {@link IIIClient.registerTriggerType}.
  *
  * Provides convenience methods to register triggers and functions scoped
  * to this trigger type, so callers don't need to repeat the `type` field.
@@ -619,89 +501,22 @@ type InternalHttpRequest<TBody = unknown> = {
   request_body: ChannelReader;
 };
 /**
- * Response object passed to HTTP function handlers. Use `status()` and
+ * Response object passed to streaming function handlers. Use `status()` and
  * `headers()` to set response metadata, write to `stream` for streaming
  * responses, and call `close()` when done.
  */
-type HttpResponse = {
+type StreamResponse = {
   /** Set the HTTP status code. */status: (statusCode: number) => void; /** Set response headers. */
   headers: (headers: Record<string, string>) => void; /** Writable stream for the response body. */
   stream: NodeJS.WritableStream; /** Close the response. */
   close: () => void;
 };
 /**
- * Incoming HTTP request received by a function registered with an HTTP trigger.
- *
- * @typeParam TBody - Type of the parsed request body.
- */
-type HttpRequest<TBody = unknown> = Omit<InternalHttpRequest<TBody>, 'response'>;
-/**
- * Alias for {@link HttpRequest}. Represents an incoming API request.
+ * Incoming streaming request received by a function registered with a stream trigger.
  *
  * @typeParam TBody - Type of the parsed request body.
  */
-type ApiRequest<TBody = unknown> = HttpRequest<TBody>;
-/**
- * Structured API response returned from HTTP function handlers.
- *
- * @typeParam TStatus - HTTP status code literal type.
- * @typeParam TBody - Type of the response body.
- *
- * @example
- * ```typescript
- * const response: ApiResponse = {
- *   status_code: 200,
- *   headers: { 'content-type': 'application/json' },
- *   body: { message: 'ok' },
- * }
- * ```
- */
-type ApiResponse<TStatus extends number = number, TBody = string | Buffer | Record<string, unknown>> = {
-  /** HTTP status code. */status_code: TStatus; /** Response headers. */
-  headers?: Record<string, string>; /** Response body. */
-  body?: TBody;
-};
-//#endregion
-//#region src/utils.d.ts
-/**
- * Helper that wraps an HTTP-style handler (with separate `req`/`res` arguments)
- * into the function handler format expected by the SDK.
- *
- * @param callback - Async handler receiving an {@link HttpRequest} and {@link HttpResponse}.
- * @returns A function handler compatible with {@link ISdk.registerFunction}.
- *
- * @example
- * ```typescript
- * import { http } from 'iii-sdk'
- *
- * iii.registerFunction(
- *   'my-api',
- *   http(async (req, res) => {
- *     res.status(200)
- *     res.headers({ 'content-type': 'application/json' })
- *     res.stream.end(JSON.stringify({ hello: 'world' }))
- *     res.close()
- *   }),
- * )
- * ```
- */
-declare const http: (callback: (req: HttpRequest, res: HttpResponse) => Promise<void | ApiResponse>) => (req: InternalHttpRequest) => Promise<void | ApiResponse>;
-/**
- * Type guard that checks if a value is a {@link StreamChannelRef}.
- *
- * @param value - Value to check.
- * @returns `true` if the value is a valid `StreamChannelRef`.
- */
-declare const isChannelRef: (value: unknown) => value is StreamChannelRef;
-/**
- * Recursively extract all {@link StreamChannelRef} values from a JSON-like
- * input, returning each match paired with its dotted/bracketed path. Mirrors
- * the Rust SDK's `extract_channel_refs`.
- *
- * @param data - Arbitrary JSON-like value.
- * @returns Array of `[path, ref]` tuples. Empty when no refs are found.
- */
-declare const extractChannelRefs: (data: unknown) => Array<[string, StreamChannelRef]>;
+type StreamRequest<TBody = unknown> = Omit<InternalHttpRequest<TBody>, 'response'>;
 //#endregion
-export { MessageType as A, RegisterTriggerTypeMessage as B, ChannelReader as C, EnqueueResult as D, AuthResult as E, OnTriggerRegistrationResult as F, TriggerRequest as H, OnTriggerTypeRegistrationInput as I, OnTriggerTypeRegistrationResult as L, OnFunctionRegistrationInput as M, OnFunctionRegistrationResult as N, HttpAuthConfig as O, OnTriggerRegistrationInput as P, RegisterFunctionMessage as R, ChannelItem as S, AuthInput as T, StreamChannelRef as V, Trigger as _, ApiResponse as a, TriggerHandler as b, HttpRequest as c, InternalHttpRequest as d, RegisterFunctionInput as f, RemoteFunctionHandler as g, RegisterTriggerTypeInput as h, ApiRequest as i, MiddlewareFunctionInput as j, HttpInvocationConfig as k, HttpResponse as l, RegisterTriggerInput as m, http as n, Channel as o, RegisterFunctionOptions as p, isChannelRef as r, FunctionRef as s, extractChannelRefs as t, ISdk as u, TriggerTypeRef as v, ChannelWriter as w, ChannelDirection as x, TriggerConfig as y, RegisterTriggerMessage as z };
-//# sourceMappingURL=utils-BnRzIUCy.d.cts.map
+export { MiddlewareFunctionInput as C, RegisterTriggerTypeMessage as D, RegisterTriggerMessage as E, StreamChannelRef as O, MessageType as S, RegisterFunctionMessage as T, ChannelDirection as _, InternalHttpRequest as a, ChannelWriter as b, RegisterTriggerInput as c, StreamRequest as d, StreamResponse as f, TriggerHandler as g, TriggerConfig as h, ISdk as i, TriggerRequest as k, RegisterTriggerTypeInput as l, TriggerTypeRef as m, FunctionRef as n, RegisterFunctionInput as o, Trigger as p, IIIClient as r, RegisterFunctionOptions as s, Channel as t, RemoteFunctionHandler as u, ChannelItem as v, RegisterFunctionFormat as w, ErrorBody as x, ChannelReader as y };
+//# sourceMappingURL=types-DduY0ha2.d.mts.map

package/dist/types-DduY0ha2.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-DduY0ha2.d.mts","names":[],"sources":["../src/iii-types.ts","../src/channels.ts","../src/triggers.ts","../src/types.ts"],"mappings":"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"}

package/dist/{utils-e84Qph-9.d.mts → types-gwm9j9oD.d.cts}

@@ -1,4 +1,5 @@
 import { Readable, Writable } from "node:stream";
+import { HttpInvocationConfig } from "@iii-dev/helpers/http";
 
 //#region src/iii-types.d.ts
 declare enum MessageType {
@@ -18,6 +19,11 @@ type RegisterTriggerTypeMessage = {
   id: string;
   description: string;
 };
+type ErrorBody = {
+  code: string;
+  message: string;
+  stacktrace?: string;
+};
 type RegisterTriggerMessage = {
   message_type: MessageType.RegisterTrigger;
   id: string;
@@ -26,35 +32,6 @@ type RegisterTriggerMessage = {
   config: unknown;
   metadata?: Record<string, unknown>;
 };
-/**
- * Authentication configuration for HTTP-invoked functions.
- *
- * - `hmac` -- HMAC signature verification using a shared secret.
- * - `bearer` -- Bearer token authentication.
- * - `api_key` -- API key sent via a custom header.
- */
-type HttpAuthConfig = {
-  type: 'hmac';
-  secret_key: string;
-} | {
-  type: 'bearer';
-  token_key: string;
-} | {
-  type: 'api_key';
-  header: string;
-  value_key: string;
-};
-/**
- * Configuration for registering an HTTP-invoked function (Lambda, Cloudflare
- * Workers, etc.) instead of a local handler.
- */
-type HttpInvocationConfig = {
-  /** URL to invoke. */url: string; /** HTTP method. Defaults to `POST`. */
-  method?: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE'; /** Timeout in milliseconds. */
-  timeout_ms?: number; /** Custom headers to send with the request. */
-  headers?: Record<string, string>; /** Authentication configuration. */
-  auth?: HttpAuthConfig;
-};
 type RegisterFunctionFormat = {
   /**
    * The name of the parameter
@@ -119,30 +96,6 @@ type TriggerAction = {
 } | {
   type: 'void';
 };
-/**
- * Input passed to the RBAC auth function during WebSocket upgrade.
- * Contains the HTTP headers, query parameters, and client IP from the
- * connecting worker's upgrade request.
- */
-type AuthInput = {
-  /** HTTP headers from the WebSocket upgrade request. */headers: Record<string, string>; /** Query parameters from the upgrade URL. Each key maps to an array of values to support repeated keys. */
-  query_params: Record<string, string[]>; /** IP address of the connecting client. */
-  ip_address: string;
-};
-/**
- * Return value from the RBAC auth function. Controls which functions the
- * authenticated worker can invoke and what context is forwarded to the
- * middleware.
- */
-type AuthResult = {
-  /** Additional function IDs to allow beyond the `expose_functions` config. */allowed_functions: string[]; /** Function IDs to deny even if they match `expose_functions`. Takes precedence over allowed. */
-  forbidden_functions: string[]; /** Trigger type IDs the worker may register triggers for. When omitted, all types are allowed. */
-  allowed_trigger_types?: string[]; /** Whether the worker may register new trigger types. */
-  allow_trigger_type_registration: boolean; /** Whether the worker may register new functions. Defaults to `true` if omitted. */
-  allow_function_registration?: boolean; /** Arbitrary context forwarded to the middleware function on every invocation. */
-  context: Record<string, unknown>; /** Optional prefix applied to all function IDs registered by this worker. */
-  function_registration_prefix?: string;
-};
 /**
  * Input passed to the RBAC middleware function on every function invocation
  * through the RBAC port. The middleware can inspect, modify, or reject the
@@ -154,79 +107,6 @@ type MiddlewareFunctionInput = {
   action?: TriggerAction; /** Auth context returned by the auth function for this session. */
   context: Record<string, unknown>;
 };
-/**
- * Input passed to the `on_trigger_type_registration_function_id` hook
- * when a worker attempts to register a new trigger type through the RBAC port.
- * Return an {@link OnTriggerTypeRegistrationResult} with the (possibly mapped)
- * fields, or throw to deny the registration.
- */
-type OnTriggerTypeRegistrationInput = {
-  /** ID of the trigger type being registered. */trigger_type_id: string; /** Human-readable description of the trigger type. */
-  description: string; /** Auth context from `AuthResult.context` for this session. */
-  context: Record<string, unknown>;
-};
-/**
- * Result returned from the `on_trigger_type_registration_function_id` hook.
- * All fields are optional -- omitted fields keep the original value from the
- * registration request.
- */
-type OnTriggerTypeRegistrationResult = {
-  /** Mapped trigger type ID. */trigger_type_id?: string; /** Mapped description. */
-  description?: string;
-};
-/**
- * Input passed to the `on_trigger_registration_function_id` hook
- * when a worker attempts to register a trigger through the RBAC port.
- * Return an {@link OnTriggerRegistrationResult} with the (possibly mapped)
- * fields, or throw to deny the registration.
- */
-type OnTriggerRegistrationInput = {
-  /** ID of the trigger being registered. */trigger_id: string; /** Trigger type identifier. */
-  trigger_type: string; /** ID of the function this trigger is bound to. */
-  function_id: string; /** Trigger-specific configuration. */
-  config: unknown; /** Arbitrary metadata attached to the trigger. */
-  metadata?: Record<string, unknown>; /** Auth context from `AuthResult.context` for this session. */
-  context: Record<string, unknown>;
-};
-/**
- * Result returned from the `on_trigger_registration_function_id` hook.
- * All fields are optional -- omitted fields keep the original value from the
- * registration request.
- */
-type OnTriggerRegistrationResult = {
-  /** Mapped trigger ID. */trigger_id?: string; /** Mapped trigger type. */
-  trigger_type?: string; /** Mapped function ID. */
-  function_id?: string; /** Mapped trigger configuration. */
-  config?: unknown;
-};
-/**
- * Input passed to the `on_function_registration_function_id` hook
- * when a worker attempts to register a function through the RBAC port.
- * Return an {@link OnFunctionRegistrationResult} with the (possibly mapped)
- * fields, or throw to deny the registration.
- */
-type OnFunctionRegistrationInput = {
-  /** ID of the function being registered. */function_id: string; /** Human-readable description of the function. */
-  description?: string; /** Arbitrary metadata attached to the function. */
-  metadata?: Record<string, unknown>; /** Auth context from `AuthResult.context` for this session. */
-  context: Record<string, unknown>;
-};
-/**
- * Result returned from the `on_function_registration_function_id` hook.
- * All fields are optional -- omitted fields keep the original value from the
- * registration request.
- */
-type OnFunctionRegistrationResult = {
-  /** Mapped function ID. */function_id?: string; /** Mapped description. */
-  description?: string; /** Mapped metadata. */
-  metadata?: Record<string, unknown>;
-};
-/**
- * Result returned when a function is invoked with `TriggerAction.Enqueue`.
- */
-type EnqueueResult = {
-  /** Unique receipt ID for the enqueued message. */messageReceiptId: string;
-};
 /**
  * Request object passed to {@link ISdk.trigger}.
  *
@@ -397,7 +277,7 @@ type RegisterTriggerInput = Omit<RegisterTriggerMessage, 'message_type' | 'id'>;
 type RegisterFunctionInput = Omit<RegisterFunctionMessage, 'message_type'>;
 type RegisterFunctionOptions = Omit<RegisterFunctionMessage, 'message_type' | 'id'>;
 type RegisterTriggerTypeInput = Omit<RegisterTriggerTypeMessage, 'message_type'>;
-interface ISdk {
+interface IIIClient {
   /**
    * Registers a new trigger. A trigger is a way to invoke a function when a certain event occurs.
    * @param trigger - The trigger to register
@@ -530,15 +410,17 @@ interface ISdk {
    */
   shutdown(): Promise<void>;
 }
+/** @deprecated Renamed to `IIIClient`. */
+type ISdk = IIIClient;
 /**
- * Handle returned by {@link ISdk.registerTrigger}. Use `unregister()` to
+ * Handle returned by {@link IIIClient.registerTrigger}. Use `unregister()` to
  * remove the trigger from the engine.
  */
 type Trigger = {
   /** Removes this trigger from the engine. */unregister(): void;
 };
 /**
- * Handle returned by {@link ISdk.registerFunction}. Contains the function's
+ * Handle returned by {@link IIIClient.registerFunction}. Contains the function's
  * `id` and an `unregister()` method.
  */
 type FunctionRef = {
@@ -546,7 +428,7 @@ type FunctionRef = {
   unregister: () => void;
 };
 /**
- * Typed handle returned by {@link ISdk.registerTriggerType}.
+ * Typed handle returned by {@link IIIClient.registerTriggerType}.
  *
  * Provides convenience methods to register triggers and functions scoped
  * to this trigger type, so callers don't need to repeat the `type` field.
@@ -619,89 +501,22 @@ type InternalHttpRequest<TBody = unknown> = {
   request_body: ChannelReader;
 };
 /**
- * Response object passed to HTTP function handlers. Use `status()` and
+ * Response object passed to streaming function handlers. Use `status()` and
  * `headers()` to set response metadata, write to `stream` for streaming
  * responses, and call `close()` when done.
  */
-type HttpResponse = {
+type StreamResponse = {
   /** Set the HTTP status code. */status: (statusCode: number) => void; /** Set response headers. */
   headers: (headers: Record<string, string>) => void; /** Writable stream for the response body. */
   stream: NodeJS.WritableStream; /** Close the response. */
   close: () => void;
 };
 /**
- * Incoming HTTP request received by a function registered with an HTTP trigger.
- *
- * @typeParam TBody - Type of the parsed request body.
- */
-type HttpRequest<TBody = unknown> = Omit<InternalHttpRequest<TBody>, 'response'>;
-/**
- * Alias for {@link HttpRequest}. Represents an incoming API request.
+ * Incoming streaming request received by a function registered with a stream trigger.
  *
  * @typeParam TBody - Type of the parsed request body.
  */
-type ApiRequest<TBody = unknown> = HttpRequest<TBody>;
-/**
- * Structured API response returned from HTTP function handlers.
- *
- * @typeParam TStatus - HTTP status code literal type.
- * @typeParam TBody - Type of the response body.
- *
- * @example
- * ```typescript
- * const response: ApiResponse = {
- *   status_code: 200,
- *   headers: { 'content-type': 'application/json' },
- *   body: { message: 'ok' },
- * }
- * ```
- */
-type ApiResponse<TStatus extends number = number, TBody = string | Buffer | Record<string, unknown>> = {
-  /** HTTP status code. */status_code: TStatus; /** Response headers. */
-  headers?: Record<string, string>; /** Response body. */
-  body?: TBody;
-};
-//#endregion
-//#region src/utils.d.ts
-/**
- * Helper that wraps an HTTP-style handler (with separate `req`/`res` arguments)
- * into the function handler format expected by the SDK.
- *
- * @param callback - Async handler receiving an {@link HttpRequest} and {@link HttpResponse}.
- * @returns A function handler compatible with {@link ISdk.registerFunction}.
- *
- * @example
- * ```typescript
- * import { http } from 'iii-sdk'
- *
- * iii.registerFunction(
- *   'my-api',
- *   http(async (req, res) => {
- *     res.status(200)
- *     res.headers({ 'content-type': 'application/json' })
- *     res.stream.end(JSON.stringify({ hello: 'world' }))
- *     res.close()
- *   }),
- * )
- * ```
- */
-declare const http: (callback: (req: HttpRequest, res: HttpResponse) => Promise<void | ApiResponse>) => (req: InternalHttpRequest) => Promise<void | ApiResponse>;
-/**
- * Type guard that checks if a value is a {@link StreamChannelRef}.
- *
- * @param value - Value to check.
- * @returns `true` if the value is a valid `StreamChannelRef`.
- */
-declare const isChannelRef: (value: unknown) => value is StreamChannelRef;
-/**
- * Recursively extract all {@link StreamChannelRef} values from a JSON-like
- * input, returning each match paired with its dotted/bracketed path. Mirrors
- * the Rust SDK's `extract_channel_refs`.
- *
- * @param data - Arbitrary JSON-like value.
- * @returns Array of `[path, ref]` tuples. Empty when no refs are found.
- */
-declare const extractChannelRefs: (data: unknown) => Array<[string, StreamChannelRef]>;
+type StreamRequest<TBody = unknown> = Omit<InternalHttpRequest<TBody>, 'response'>;
 //#endregion
-export { MessageType as A, RegisterTriggerTypeMessage as B, ChannelReader as C, EnqueueResult as D, AuthResult as E, OnTriggerRegistrationResult as F, TriggerRequest as H, OnTriggerTypeRegistrationInput as I, OnTriggerTypeRegistrationResult as L, OnFunctionRegistrationInput as M, OnFunctionRegistrationResult as N, HttpAuthConfig as O, OnTriggerRegistrationInput as P, RegisterFunctionMessage as R, ChannelItem as S, AuthInput as T, StreamChannelRef as V, Trigger as _, ApiResponse as a, TriggerHandler as b, HttpRequest as c, InternalHttpRequest as d, RegisterFunctionInput as f, RemoteFunctionHandler as g, RegisterTriggerTypeInput as h, ApiRequest as i, MiddlewareFunctionInput as j, HttpInvocationConfig as k, HttpResponse as l, RegisterTriggerInput as m, http as n, Channel as o, RegisterFunctionOptions as p, isChannelRef as r, FunctionRef as s, extractChannelRefs as t, ISdk as u, TriggerTypeRef as v, ChannelWriter as w, ChannelDirection as x, TriggerConfig as y, RegisterTriggerMessage as z };
-//# sourceMappingURL=utils-e84Qph-9.d.mts.map
+export { MiddlewareFunctionInput as C, RegisterTriggerTypeMessage as D, RegisterTriggerMessage as E, StreamChannelRef as O, MessageType as S, RegisterFunctionMessage as T, ChannelDirection as _, InternalHttpRequest as a, ChannelWriter as b, RegisterTriggerInput as c, StreamRequest as d, StreamResponse as f, TriggerHandler as g, TriggerConfig as h, ISdk as i, TriggerRequest as k, RegisterTriggerTypeInput as l, TriggerTypeRef as m, FunctionRef as n, RegisterFunctionInput as o, Trigger as p, IIIClient as r, RegisterFunctionOptions as s, Channel as t, RemoteFunctionHandler as u, ChannelItem as v, RegisterFunctionFormat as w, ErrorBody as x, ChannelReader as y };
+//# sourceMappingURL=types-gwm9j9oD.d.cts.map

package/dist/types-gwm9j9oD.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-gwm9j9oD.d.cts","names":[],"sources":["../src/iii-types.ts","../src/channels.ts","../src/triggers.ts","../src/types.ts"],"mappings":"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"}