@sylphx/sdk 0.10.0 → 0.10.2

package/dist/react/index.d.ts

@@ -922,7 +922,7 @@ type FlagClientEvent = {
  * import { createClient } from '@sylphx/sdk'
  *
  * const sylphx = createClient(process.env.SYLPHX_URL!)
- * // Parses: sylphx://pk_prod_{hex}@bold-river-a1b2c3.api.sylphx.com
+ * // Parses: sylphx://pk_prod_{ref?}_{hex}@bold-river-a1b2c3.api.sylphx.com
  * ```
  */
 
@@ -2377,6 +2377,8 @@ interface AuthContextValue extends AuthState {
     }) => Promise<void>;
     /** Get current access token (refreshes if expired) */
     getToken: () => Promise<string | null>;
+    /** Exchange the current session for an org-scoped access token. */
+    switchOrganizationToken: (orgId: string) => Promise<void>;
     /** Reset password with token */
     resetPassword: (options: ResetPasswordOptions) => Promise<void>;
     /** Verify email with token */
@@ -2827,6 +2829,8 @@ interface UseOrganizationReturn {
     hasPermission: (permission: 'manage_members' | 'access_billing' | 'manage_apps' | 'view_analytics') => boolean;
     /** Switch to a different organization */
     setOrganization: (orgIdOrSlug: string | null) => Promise<void>;
+    /** Switch to a different organization and refresh the active session token. */
+    switchOrg: (orgIdOrSlug: string | null) => Promise<void>;
     /** Create a new organization */
     createOrganization: (data: {
         name: string;
@@ -6414,6 +6418,8 @@ interface PlatformContextValue {
     appId: string;
     /** Platform API URL */
     platformUrl: string;
+    /** Same-origin auth route prefix used by middleware BFF routes. */
+    authPrefix: string;
     /** Project slug (ADR-055) for SDK config */
     slug?: string;
     /**
@@ -7428,7 +7434,7 @@ interface SylphxProviderProps {
      *
      * export default async function RootLayout({ children }) {
      *   const config = await getAppConfig({
-     *     secretKey: process.env.SYLPHX_SECRET_KEY!,
+     *     secretKey: createServerClient(process.env.SYLPHX_SECRET_URL!).secretKey!,
      *     appId: process.env.NEXT_PUBLIC_SYLPHX_APP_ID!,
      *   })
      *
@@ -7789,9 +7795,8 @@ declare function useHasPermission(permissions: string[], required: string | stri
  * Features (built-in defaults, ADR-100 §2.8):
  * - Idempotency-Key auto-generated (UUIDv7) on every POST
  * - Single-part PUT or multipart, picked server-side from `size`
- * - Streaming SHA-256 (browser `crypto.subtle.digest` / node `crypto.createHash`)
- * - Resumable: persists `(uploadId, completedParts[])` to localStorage
- *   (browser) or `~/.sylphx/uploads.json` (node)
+ * - Streaming SHA-256 via the Web Crypto API
+ * - Resumable: persists `(uploadId, completedParts[])` to localStorage when available
  * - AbortSignal cancellation; auto-DELETE upload session on abort
  * - Exponential backoff with full jitter (5 retries, 1s base, 30s cap)
  * - Progress: byte-accurate via XHR (browser) or stream sampling (node)
@@ -7849,10 +7854,13 @@ interface ListFilesOptions {
 
 interface UseStorageReturn {
     upload(file: Blob | File, options?: UploadCreateOptions): Promise<File$1>;
+    uploadAvatar(file: Blob | File, options?: UploadCreateOptions): Promise<File$1>;
     files: File$1[] | undefined;
     isUploading: boolean;
     isLoadingFiles: boolean;
+    progress: number;
     error: Error | null;
+    uploadError: Error | null;
     refetch(): Promise<void>;
 }
 /**
@@ -9960,17 +9968,17 @@ declare function sanitizeUrl$1(url: string): string | null;
  * 5. Single Source of Truth - All key logic in one place
  *
  * Key Formats (ADR-021):
- * - Publishable key: pk_(dev|stg|prod)_{ref}_{32hex} — client-safe (new)
- * - Secret Key:      sk_(dev|stg|prod)_{ref}_{64hex} — server-side only
+ * - Publishable key: pk_(dev|stg|prod|prev)_{ref}_{32hex} — client-safe (new)
+ * - Secret Key:      sk_(dev|stg|prod|prev)_{ref}_{64hex} — server-side only
  *
  * Legacy Key Formats (backward-compat):
- * - App ID (old):    app_(dev|stg|prod)_[identifier] — Public identifier
+ * - App ID (old):    app_(dev|stg|prod|prev)_[identifier] — Public identifier
  *
  * Special Internal Formats (NOT rotated):
  * - Console bootstrap: app_prod_platform_{slug} / sk_prod_platform_{slug}
  */
 /** Environment type derived from key prefix */
-type EnvironmentType = 'development' | 'staging' | 'production';
+type EnvironmentType = 'development' | 'staging' | 'production' | 'preview';
 /** Key type - publicKey (pk_*), appId (legacy app_*), or secret (sk_*) */
 type KeyType = 'publicKey' | 'appId' | 'secret';
 /** Validation result with clear error information */
@@ -10020,7 +10028,7 @@ declare function validateAndSanitizeAppId(key: string | undefined | null): strin
  *
  * @example
  * ```typescript
- * const result = validateSecretKey(process.env.SYLPHX_SECRET_KEY)
+ * const result = validateSecretKey('sk_prod_...')
  * if (!result.valid) {
  *   throw new Error(result.error)
  * }
@@ -10092,7 +10100,7 @@ declare function isSecretKey(key: string): boolean;
  *
  * @example
  * ```typescript
- * const result = validateKey(process.env.SYLPHX_SECRET_KEY)
+ * const result = validateKey('sk_prod_...')
  * if (!result.valid) {
  *   throw new Error(result.error)
  * }
@@ -13862,7 +13870,7 @@ declare function useKv(options?: UseKvOptions): UseKvReturn;
  * import { createConfig, indexDocument, search, batchIndex } from '@sylphx/sdk'
  *
  * const config = createConfig({
- *   secretKey: process.env.SYLPHX_SECRET_KEY!,
+ *   secretKey: createServerClient(process.env.SYLPHX_SECRET_URL!).secretKey!,
  * })
  *
  * // Index a document