@insforge/sdk 1.4.0 → 1.4.1

package/dist/types-NjykhyRq.d.mts

@@ -0,0 +1,118 @@
+import { UserSchema, ErrorCode } from '@insforge/shared-schemas';
+
+/**
+ * InsForge SDK Types - only SDK-specific types here
+ * Use @insforge/shared-schemas directly for API types
+ */
+
+type InsForgeErrorCode = ErrorCode | (string & {});
+interface InsForgeConfig {
+    /**
+     * The base URL of the InsForge backend API
+     * @default "http://localhost:7130"
+     */
+    baseUrl?: string;
+    /**
+     * Anonymous API key (optional)
+     * Used for public/unauthenticated requests when no user token is set
+     */
+    anonKey?: string;
+    /**
+     * Static access token (optional)
+     * Seeds the client with a fixed bearer token used for all authenticated
+     * requests — e.g. a user JWT inside an edge function, or a server-signed
+     * JWT from an external auth provider. Disables automatic token refresh
+     * and implies server mode unless `isServerMode` is set explicitly.
+     */
+    accessToken?: string;
+    /**
+     * @deprecated Use `accessToken` instead. Same behavior; `accessToken`
+     * takes precedence when both are provided.
+     */
+    edgeFunctionToken?: string;
+    /**
+     * Direct URL to Deno Subhosting functions (optional)
+     * When provided, SDK will try this URL first for function invocations.
+     * Falls back to proxy URL if subhosting returns 404.
+     * @example "https://{appKey}.functions.insforge.app"
+     */
+    functionsUrl?: string;
+    /**
+     * Custom fetch implementation (useful for Node.js environments)
+     */
+    fetch?: typeof fetch;
+    /**
+     * Enable server-side auth mode (SSR/Node runtime)
+     * In this mode auth endpoints use `client_type=mobile` and refresh_token body flow.
+     *
+     * @deprecated Use `createServerClient()`, `createBrowserClient()`, and
+     * `updateSession()` from `@insforge/sdk/ssr` for SSR apps.
+     * @default false
+     */
+    isServerMode?: boolean;
+    /**
+     * Custom headers to include with every request
+     */
+    headers?: Record<string, string>;
+    /**
+     * Enable debug logging for HTTP requests and responses.
+     * When true, request/response details are logged to the console.
+     * Can also be a custom log function for advanced use cases.
+     * @default false
+     */
+    debug?: boolean | ((message: string, ...args: any[]) => void);
+    /**
+     * Request timeout in milliseconds.
+     * Requests that exceed this duration will be aborted.
+     * Set to 0 to disable timeout.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retry attempts for failed requests.
+     * Retries are triggered on network errors and server errors (5xx).
+     * Client errors (4xx) are never retried.
+     * Set to 0 to disable retries.
+     * @default 3
+     */
+    retryCount?: number;
+    /**
+     * Initial delay in milliseconds before the first retry.
+     * The delay doubles with each subsequent attempt (exponential backoff)
+     * with ±15% jitter to prevent thundering herd.
+     * @default 500
+     */
+    retryDelay?: number;
+}
+type InsForgeAdminConfig = Omit<InsForgeConfig, 'anonKey' | 'accessToken' | 'edgeFunctionToken' | 'isServerMode'> & {
+    /**
+     * Project admin API key. Keep this server-side only.
+     */
+    apiKey: string;
+};
+interface AuthSession {
+    user: UserSchema;
+    accessToken: string;
+    expiresAt?: Date;
+}
+interface AuthRefreshResponse {
+    user: UserSchema;
+    accessToken: string;
+    csrfToken?: string;
+    refreshToken?: string;
+}
+interface ApiError {
+    error: InsForgeErrorCode;
+    message: string;
+    statusCode: number;
+    nextActions?: string;
+}
+declare class InsForgeError extends Error {
+    statusCode: number;
+    error: InsForgeErrorCode;
+    nextActions?: string;
+    constructor(message: string, statusCode: number, error: InsForgeErrorCode, nextActions?: string);
+    static fromApiError(apiError: ApiError): InsForgeError;
+}
+
+export { type AuthSession as A, type InsForgeConfig as I, type InsForgeAdminConfig as a, type ApiError as b, type InsForgeErrorCode as c, InsForgeError as d, type AuthRefreshResponse as e };

package/dist/types-NjykhyRq.d.ts

@@ -0,0 +1,118 @@
+import { UserSchema, ErrorCode } from '@insforge/shared-schemas';
+
+/**
+ * InsForge SDK Types - only SDK-specific types here
+ * Use @insforge/shared-schemas directly for API types
+ */
+
+type InsForgeErrorCode = ErrorCode | (string & {});
+interface InsForgeConfig {
+    /**
+     * The base URL of the InsForge backend API
+     * @default "http://localhost:7130"
+     */
+    baseUrl?: string;
+    /**
+     * Anonymous API key (optional)
+     * Used for public/unauthenticated requests when no user token is set
+     */
+    anonKey?: string;
+    /**
+     * Static access token (optional)
+     * Seeds the client with a fixed bearer token used for all authenticated
+     * requests — e.g. a user JWT inside an edge function, or a server-signed
+     * JWT from an external auth provider. Disables automatic token refresh
+     * and implies server mode unless `isServerMode` is set explicitly.
+     */
+    accessToken?: string;
+    /**
+     * @deprecated Use `accessToken` instead. Same behavior; `accessToken`
+     * takes precedence when both are provided.
+     */
+    edgeFunctionToken?: string;
+    /**
+     * Direct URL to Deno Subhosting functions (optional)
+     * When provided, SDK will try this URL first for function invocations.
+     * Falls back to proxy URL if subhosting returns 404.
+     * @example "https://{appKey}.functions.insforge.app"
+     */
+    functionsUrl?: string;
+    /**
+     * Custom fetch implementation (useful for Node.js environments)
+     */
+    fetch?: typeof fetch;
+    /**
+     * Enable server-side auth mode (SSR/Node runtime)
+     * In this mode auth endpoints use `client_type=mobile` and refresh_token body flow.
+     *
+     * @deprecated Use `createServerClient()`, `createBrowserClient()`, and
+     * `updateSession()` from `@insforge/sdk/ssr` for SSR apps.
+     * @default false
+     */
+    isServerMode?: boolean;
+    /**
+     * Custom headers to include with every request
+     */
+    headers?: Record<string, string>;
+    /**
+     * Enable debug logging for HTTP requests and responses.
+     * When true, request/response details are logged to the console.
+     * Can also be a custom log function for advanced use cases.
+     * @default false
+     */
+    debug?: boolean | ((message: string, ...args: any[]) => void);
+    /**
+     * Request timeout in milliseconds.
+     * Requests that exceed this duration will be aborted.
+     * Set to 0 to disable timeout.
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Maximum number of retry attempts for failed requests.
+     * Retries are triggered on network errors and server errors (5xx).
+     * Client errors (4xx) are never retried.
+     * Set to 0 to disable retries.
+     * @default 3
+     */
+    retryCount?: number;
+    /**
+     * Initial delay in milliseconds before the first retry.
+     * The delay doubles with each subsequent attempt (exponential backoff)
+     * with ±15% jitter to prevent thundering herd.
+     * @default 500
+     */
+    retryDelay?: number;
+}
+type InsForgeAdminConfig = Omit<InsForgeConfig, 'anonKey' | 'accessToken' | 'edgeFunctionToken' | 'isServerMode'> & {
+    /**
+     * Project admin API key. Keep this server-side only.
+     */
+    apiKey: string;
+};
+interface AuthSession {
+    user: UserSchema;
+    accessToken: string;
+    expiresAt?: Date;
+}
+interface AuthRefreshResponse {
+    user: UserSchema;
+    accessToken: string;
+    csrfToken?: string;
+    refreshToken?: string;
+}
+interface ApiError {
+    error: InsForgeErrorCode;
+    message: string;
+    statusCode: number;
+    nextActions?: string;
+}
+declare class InsForgeError extends Error {
+    statusCode: number;
+    error: InsForgeErrorCode;
+    nextActions?: string;
+    constructor(message: string, statusCode: number, error: InsForgeErrorCode, nextActions?: string);
+    static fromApiError(apiError: ApiError): InsForgeError;
+}
+
+export { type AuthSession as A, type InsForgeConfig as I, type InsForgeAdminConfig as a, type ApiError as b, type InsForgeErrorCode as c, InsForgeError as d, type AuthRefreshResponse as e };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@insforge/sdk",
-  "version": "1.4.0",
+  "version": "1.4.1",
   "description": "Official JavaScript/TypeScript client for InsForge Backend-as-a-Service platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",
@@ -15,6 +15,11 @@
       "types": "./dist/ssr.d.ts",
       "import": "./dist/ssr.mjs",
       "require": "./dist/ssr.js"
+    },
+    "./ssr/middleware": {
+      "types": "./dist/ssr/middleware.d.ts",
+      "import": "./dist/ssr/middleware.mjs",
+      "require": "./dist/ssr/middleware.js"
     }
   },
   "files": [