@butterbase/sdk 2.0.2 → 2.3.2

package/dist/ai/types.d.ts

@@ -1,6 +1,23 @@
+export type ChatContentPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'image_url';
+    image_url: {
+        url: string;
+        detail?: 'low' | 'high' | 'auto';
+    };
+} | {
+    type: 'video_url';
+    video_url: {
+        url: string;
+    };
+};
 export interface ChatMessage {
-    role: 'system' | 'user' | 'assistant';
-    content: string;
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    content: string | ChatContentPart[];
+    name?: string;
+    tool_call_id?: string;
 }
 export interface ChatOptions {
     model?: string;
@@ -44,4 +61,33 @@ export interface AiUsage {
         cost: number;
     }>;
 }
+export interface EmbeddingRequest {
+    model?: string;
+    input: string | string[];
+    encoding_format?: 'float' | 'base64';
+}
+export interface EmbeddingVector {
+    object: 'embedding';
+    index: number;
+    embedding: number[];
+}
+export interface EmbeddingResponse {
+    object: 'list';
+    model: string;
+    data: EmbeddingVector[];
+    usage: {
+        prompt_tokens: number;
+        total_tokens: number;
+    };
+}
+export interface AiModel {
+    id: string;
+    provider: string;
+    capabilities: ('chat' | 'embed' | 'vision' | 'tool_use')[];
+    context_window?: number;
+    pricing?: {
+        input_per_mtok?: number;
+        output_per_mtok?: number;
+    };
+}
 //# sourceMappingURL=types.d.ts.map

package/dist/ai/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,KAAK,CAAC;QACb,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,OAAO,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3C,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;IACH,KAAK,CAAC,EAAE;QACN,aAAa,EAAE,MAAM,CAAC;QACtB,iBAAiB,EAAE,MAAM,CAAC;QAC1B,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,QAAQ;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,OAAO;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;CACJ"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/ai/types.ts"],"names":[],"mappings":"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"}

package/dist/errors/base.d.ts

@@ -0,0 +1,8 @@
+export declare class ButterbaseError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly remediation?: string;
+    readonly details?: unknown;
+    constructor(message: string, code: string, status: number, remediation?: string, details?: unknown);
+}
+//# sourceMappingURL=base.d.ts.map

package/dist/errors/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAQnG"}

package/dist/errors/base.js

@@ -0,0 +1,15 @@
+export class ButterbaseError extends Error {
+    code;
+    status;
+    remediation;
+    details;
+    constructor(message, code, status, remediation, details) {
+        super(message);
+        this.name = 'ButterbaseError';
+        this.code = code;
+        this.status = status;
+        this.remediation = remediation;
+        this.details = details;
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/errors/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/errors/base.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,eAAgB,SAAQ,KAAK;IAC/B,IAAI,CAAS;IACb,MAAM,CAAS;IACf,WAAW,CAAU;IACrB,OAAO,CAAW;IAE3B,YAAY,OAAe,EAAE,IAAY,EAAE,MAAc,EAAE,WAAoB,EAAE,OAAiB;QAChG,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;CACF"}

package/dist/errors/index.d.ts

@@ -1,26 +1,30 @@
-export declare class ButterbaseError extends Error {
-    readonly code: string;
-    readonly status: number;
-    readonly remediation?: string;
-    constructor(message: string, code: string, status: number, remediation?: string);
-}
+import { ButterbaseError } from './base.js';
+import { KvError, KvAuthError, KvForbiddenError, KvNotFoundError, KvKeyInvalidError, KvConnectionError, KvQuotaExceededError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, KvValueTooLargeError, KvCasMismatchError, KvExposeConflictError } from './kv.js';
+export { ButterbaseError };
 export declare class AuthError extends ButterbaseError {
-    constructor(message: string, code: string, status: number, remediation?: string);
+    constructor(m: string, c: string, s: number, r?: string, d?: unknown);
 }
 export declare class ValidationError extends ButterbaseError {
-    constructor(message: string, code: string, status: number, remediation?: string);
+    constructor(m: string, c: string, s: number, r?: string, d?: unknown);
 }
 export declare class NotFoundError extends ButterbaseError {
-    constructor(message: string, code: string, status: number, remediation?: string);
+    constructor(m: string, c: string, s: number, r?: string, d?: unknown);
 }
 export declare class QuotaError extends ButterbaseError {
-    constructor(message: string, code: string, status: number, remediation?: string);
+    constructor(m: string, c: string, s: number, r?: string, d?: unknown);
 }
 export declare class NetworkError extends ButterbaseError {
-    constructor(message: string, code?: string, status?: number, remediation?: string);
+    constructor(m: string, c?: string, s?: number, r?: string, d?: unknown);
 }
+export { KvError, KvAuthError, KvForbiddenError, KvNotFoundError, KvKeyInvalidError, KvConnectionError, KvQuotaExceededError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, KvValueTooLargeError, KvCasMismatchError, KvExposeConflictError, };
+type ErrCls = new (m: string, c: string, s: number, r?: string, d?: unknown) => ButterbaseError;
+export declare function classifyByCode(code: string): ErrCls | null;
 /**
- * Parse an API error response into the appropriate ButterbaseError subclass
+ * Parse a backend response into a typed ButterbaseError subclass.
+ *
+ * Dispatch order:
+ *   1. If body matches AgentFriendlyError shape, use the `code` (exact match, then prefix).
+ *   2. Otherwise fall back to HTTP status mapping.
  */
-export declare function parseApiError(status: number, body: any): ButterbaseError;
+export declare function parseApiError(status: number, body: unknown): ButterbaseError;
 //# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAAA,qBAAa,eAAgB,SAAQ,KAAK;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAOhF;AAED,qBAAa,SAAU,SAAQ,eAAe;gBAChC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,eAAgB,SAAQ,eAAe;gBACtC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,aAAc,SAAQ,eAAe;gBACpC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,UAAW,SAAQ,eAAe;gBACjC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;CAIhF;AAED,qBAAa,YAAa,SAAQ,eAAe;gBACnC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,MAAwB,EAAE,MAAM,GAAE,MAAU,EAAE,WAAW,CAAC,EAAE,MAAM;CAItG;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,GAAG,GAAG,eAAe,CAsBxE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EACL,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAC7F,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,oBAAoB,EAC3G,oBAAoB,EAAE,kBAAkB,EAAE,qBAAqB,EAChE,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,eAAe,EAAE,CAAC;AAE3B,qBAAa,SAAgB,SAAQ,eAAe;gBAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO;CAAsD;AACjL,qBAAa,eAAgB,SAAQ,eAAe;gBAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO;CAA4D;AACvL,qBAAa,aAAgB,SAAQ,eAAe;gBAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO;CAA0D;AACrL,qBAAa,UAAgB,SAAQ,eAAe;gBAAe,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO;CAAuD;AAClL,qBAAa,YAAgB,SAAQ,eAAe;gBAAe,CAAC,EAAE,MAAM,EAAE,CAAC,GAAE,MAAwB,EAAE,CAAC,GAAE,MAAU,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO;CAAyD;AAG1M,OAAO,EACL,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,eAAe,EAAE,iBAAiB,EAAE,iBAAiB,EAC7F,oBAAoB,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,kBAAkB,EAAE,oBAAoB,EAC3G,oBAAoB,EAAE,kBAAkB,EAAE,qBAAqB,GAChE,CAAC;AAEF,KAAK,MAAM,GAAG,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,EAAE,OAAO,KAAK,eAAe,CAAC;AA4BhG,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU1D;AAWD;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,CAe5E"}

package/dist/errors/index.js

@@ -1,64 +1,100 @@
-export class ButterbaseError extends Error {
-    code;
-    status;
-    remediation;
-    constructor(message, code, status, remediation) {
-        super(message);
-        this.name = 'ButterbaseError';
-        this.code = code;
-        this.status = status;
-        this.remediation = remediation;
-    }
-}
+import { ErrorCodes, isAgentFriendlyError } from '@butterbase/shared';
+import { ButterbaseError } from './base.js';
+import { KvError, KvAuthError, KvForbiddenError, KvNotFoundError, KvKeyInvalidError, KvConnectionError, KvQuotaExceededError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, KvValueTooLargeError, KvCasMismatchError, KvExposeConflictError, } from './kv.js';
+export { ButterbaseError };
 export class AuthError extends ButterbaseError {
-    constructor(message, code, status, remediation) {
-        super(message, code, status, remediation);
-        this.name = 'AuthError';
-    }
+    constructor(m, c, s, r, d) { super(m, c, s, r, d); this.name = 'AuthError'; }
 }
 export class ValidationError extends ButterbaseError {
-    constructor(message, code, status, remediation) {
-        super(message, code, status, remediation);
-        this.name = 'ValidationError';
-    }
+    constructor(m, c, s, r, d) { super(m, c, s, r, d); this.name = 'ValidationError'; }
 }
 export class NotFoundError extends ButterbaseError {
-    constructor(message, code, status, remediation) {
-        super(message, code, status, remediation);
-        this.name = 'NotFoundError';
-    }
+    constructor(m, c, s, r, d) { super(m, c, s, r, d); this.name = 'NotFoundError'; }
 }
 export class QuotaError extends ButterbaseError {
-    constructor(message, code, status, remediation) {
-        super(message, code, status, remediation);
-        this.name = 'QuotaError';
-    }
+    constructor(m, c, s, r, d) { super(m, c, s, r, d); this.name = 'QuotaError'; }
 }
 export class NetworkError extends ButterbaseError {
-    constructor(message, code = 'NETWORK_ERROR', status = 0, remediation) {
-        super(message, code, status, remediation);
-        this.name = 'NetworkError';
-    }
+    constructor(m, c = 'NETWORK_ERROR', s = 0, r, d) { super(m, c, s, r, d); this.name = 'NetworkError'; }
+}
+// Re-export KV error classes
+export { KvError, KvAuthError, KvForbiddenError, KvNotFoundError, KvKeyInvalidError, KvConnectionError, KvQuotaExceededError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, KvValueTooLargeError, KvCasMismatchError, KvExposeConflictError, };
+// Exact code → class
+const EXACT = {
+    [ErrorCodes.AUTH_INVALID_API_KEY]: AuthError,
+    [ErrorCodes.AUTH_INVALID_TOKEN]: AuthError,
+    [ErrorCodes.AUTH_INSUFFICIENT_PERMISSIONS]: AuthError,
+    [ErrorCodes.RESOURCE_NOT_FOUND]: NotFoundError,
+};
+// KV code → class
+const KV_CODE_TO_CLASS = {
+    KV_UNAUTHORIZED: KvAuthError,
+    KV_FORBIDDEN: KvForbiddenError,
+    KV_NOT_FOUND: KvNotFoundError,
+    KV_KEY_INVALID: KvKeyInvalidError,
+    KV_CONNECTION: KvConnectionError,
+    KV_VALUE_TOO_LARGE: KvValueTooLargeError,
+    KV_CAS_MISMATCH: KvCasMismatchError,
+    KV_EXPOSE_CONFLICT: KvExposeConflictError,
+    // lowercase quota codes from the control-api preHandler (Task 5)
+    kv_rate_limited: KvQuotaExceededError,
+    kv_credits_exhausted: KvQuotaExceededError,
+    kv_storage_full: KvQuotaExceededError,
+    kv_keys_exhausted: KvQuotaExceededError,
+    value_too_large: KvValueTooLargeError,
+};
+export function classifyByCode(code) {
+    if (EXACT[code])
+        return EXACT[code];
+    if (KV_CODE_TO_CLASS[code])
+        return KV_CODE_TO_CLASS[code];
+    if (code.startsWith('KV_') || code.startsWith('kv_'))
+        return KvError;
+    if (code.startsWith('AUTH_'))
+        return AuthError;
+    if (code.startsWith('VALIDATION_'))
+        return ValidationError;
+    if (code.startsWith('RESOURCE_'))
+        return NotFoundError;
+    if (code.startsWith('QUOTA_'))
+        return QuotaError;
+    if (code.startsWith('EXTERNAL_'))
+        return NetworkError;
+    return null;
+}
+function classifyByStatus(status) {
+    if (status === 401 || status === 403)
+        return AuthError;
+    if (status === 400 || status === 422)
+        return ValidationError;
+    if (status === 404)
+        return NotFoundError;
+    if (status === 429)
+        return QuotaError;
+    if (status === 0 || status === 502 || status === 503)
+        return NetworkError;
+    return ButterbaseError;
 }
 /**
- * Parse an API error response into the appropriate ButterbaseError subclass
+ * Parse a backend response into a typed ButterbaseError subclass.
+ *
+ * Dispatch order:
+ *   1. If body matches AgentFriendlyError shape, use the `code` (exact match, then prefix).
+ *   2. Otherwise fall back to HTTP status mapping.
  */
 export function parseApiError(status, body) {
-    const message = body?.error || body?.message || 'Unknown error';
-    const code = body?.code || '';
-    const remediation = body?.remediation;
-    if (status === 401 || status === 403 || code.startsWith('AUTH_')) {
-        return new AuthError(message, code || 'AUTH_UNAUTHORIZED', status, remediation);
-    }
-    if (status === 404 || code === 'RESOURCE_NOT_FOUND') {
-        return new NotFoundError(message, code || 'RESOURCE_NOT_FOUND', status, remediation);
-    }
-    if (status === 429 || code.startsWith('QUOTA_')) {
-        return new QuotaError(message, code || 'QUOTA_EXCEEDED', status, remediation);
-    }
-    if (status === 400 || status === 422 || code.startsWith('VALIDATION_')) {
-        return new ValidationError(message, code || 'VALIDATION_INVALID', status, remediation);
+    if (isAgentFriendlyError(body)) {
+        const { code, message, remediation, details } = body.error;
+        const Cls = classifyByCode(code) ?? classifyByStatus(status);
+        return new Cls(message, code, status, remediation, details);
     }
-    return new ButterbaseError(message, code || 'UNKNOWN_ERROR', status, remediation);
+    // Legacy shape — backend sometimes returns { error: "string" } or { message }.
+    const message = body && typeof body === 'object'
+        ? (typeof body.error === 'string' ? body.error
+            : typeof body.message === 'string' ? body.message
+                : 'Unknown error')
+        : 'Unknown error';
+    const Cls = classifyByStatus(status);
+    return new Cls(message, `HTTP_${status}`, status);
 }
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"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"}

package/dist/errors/kv.d.ts

@@ -0,0 +1,59 @@
+import { ButterbaseError } from './base.js';
+export declare class KvError extends ButterbaseError {
+    constructor(message: string, code?: string, status?: number, remediation?: string, details?: unknown);
+}
+export declare class KvAuthError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvForbiddenError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvNotFoundError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvKeyInvalidError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvConnectionError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvCasMismatchError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvExposeConflictError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+export declare class KvValueTooLargeError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+/** Parent / legacy alias for quota-class KV errors. */
+export declare class KvQuotaExceededError extends KvError {
+    constructor(m?: string, c?: string, s?: number, r?: string, d?: unknown);
+}
+/** HTTP 429 – kv_rate_limited */
+export declare class KvRateLimitedError extends KvQuotaExceededError {
+    /** Seconds the caller should wait before retrying. */
+    readonly retryAfterSec: number;
+    constructor(retryAfterSec?: number, m?: string);
+}
+/** HTTP 402 – kv_credits_exhausted */
+export declare class KvCreditsExhaustedError extends KvQuotaExceededError {
+    constructor(m?: string);
+}
+/** HTTP 507 – kv_storage_full */
+export declare class KvStorageFullError extends KvQuotaExceededError {
+    /** Bytes currently used. */
+    readonly usedBytes: number;
+    /** Storage cap in bytes. */
+    readonly capBytes: number;
+    constructor(usedBytes?: number, capBytes?: number, m?: string);
+}
+/** HTTP 507 – kv_keys_exhausted */
+export declare class KvKeysExhaustedError extends KvQuotaExceededError {
+    /** Current key count. */
+    readonly keys: number;
+    /** Maximum allowed keys. */
+    readonly cap: number;
+    constructor(keys?: number, cap?: number, m?: string);
+}
+//# sourceMappingURL=kv.d.ts.map

package/dist/errors/kv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.d.ts","sourceRoot":"","sources":["../../src/errors/kv.ts"],"names":[],"mappings":"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"}

package/dist/errors/kv.js

@@ -0,0 +1,109 @@
+import { ButterbaseError } from './base.js';
+export class KvError extends ButterbaseError {
+    constructor(message, code = 'KV_ERROR', status = 500, remediation, details) {
+        super(message, code, status, remediation, details);
+        this.name = 'KvError';
+    }
+}
+export class KvAuthError extends KvError {
+    constructor(m = 'unauthorized', c = 'KV_UNAUTHORIZED', s = 401, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvAuthError';
+    }
+}
+export class KvForbiddenError extends KvError {
+    constructor(m = 'forbidden', c = 'KV_FORBIDDEN', s = 403, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvForbiddenError';
+    }
+}
+export class KvNotFoundError extends KvError {
+    constructor(m = 'not found', c = 'KV_NOT_FOUND', s = 404, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvNotFoundError';
+    }
+}
+export class KvKeyInvalidError extends KvError {
+    constructor(m = 'invalid key', c = 'KV_KEY_INVALID', s = 400, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvKeyInvalidError';
+    }
+}
+export class KvConnectionError extends KvError {
+    constructor(m = 'connection error', c = 'KV_CONNECTION', s = 503, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvConnectionError';
+    }
+}
+// Reserved for a future stricter-CAS endpoint that returns 409 on mismatch.
+// Today the kv-gateway returns 200 {swapped:false} for normal CAS, so callers
+// should use the boolean return from KvShim.cas(); this error is not thrown yet.
+export class KvCasMismatchError extends KvError {
+    constructor(m = 'cas mismatch', c = 'KV_CAS_MISMATCH', s = 409, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvCasMismatchError';
+    }
+}
+export class KvExposeConflictError extends KvError {
+    constructor(m = 'expose pattern conflicts with existing rule', c = 'KV_EXPOSE_CONFLICT', s = 409, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvExposeConflictError';
+    }
+}
+export class KvValueTooLargeError extends KvError {
+    constructor(m = 'value too large', c = 'KV_VALUE_TOO_LARGE', s = 413, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvValueTooLargeError';
+    }
+}
+/** Parent / legacy alias for quota-class KV errors. */
+export class KvQuotaExceededError extends KvError {
+    constructor(m = 'quota exceeded', c = 'KV_QUOTA_EXCEEDED', s = 429, r, d) {
+        super(m, c, s, r, d);
+        this.name = 'KvQuotaExceededError';
+    }
+}
+/** HTTP 429 – kv_rate_limited */
+export class KvRateLimitedError extends KvQuotaExceededError {
+    /** Seconds the caller should wait before retrying. */
+    retryAfterSec;
+    constructor(retryAfterSec = 0, m) {
+        super(m ?? `rate limited; retry after ${retryAfterSec}s`, 'kv_rate_limited', 429);
+        this.name = 'KvRateLimitedError';
+        this.retryAfterSec = retryAfterSec;
+    }
+}
+/** HTTP 402 – kv_credits_exhausted */
+export class KvCreditsExhaustedError extends KvQuotaExceededError {
+    constructor(m) {
+        super(m ?? 'credits exhausted; please top up your account', 'kv_credits_exhausted', 402);
+        this.name = 'KvCreditsExhaustedError';
+    }
+}
+/** HTTP 507 – kv_storage_full */
+export class KvStorageFullError extends KvQuotaExceededError {
+    /** Bytes currently used. */
+    usedBytes;
+    /** Storage cap in bytes. */
+    capBytes;
+    constructor(usedBytes = 0, capBytes = 0, m) {
+        super(m ?? `storage full (${usedBytes} / ${capBytes} bytes used)`, 'kv_storage_full', 507);
+        this.name = 'KvStorageFullError';
+        this.usedBytes = usedBytes;
+        this.capBytes = capBytes;
+    }
+}
+/** HTTP 507 – kv_keys_exhausted */
+export class KvKeysExhaustedError extends KvQuotaExceededError {
+    /** Current key count. */
+    keys;
+    /** Maximum allowed keys. */
+    cap;
+    constructor(keys = 0, cap = 0, m) {
+        super(m ?? `key limit reached (${keys} / ${cap} keys)`, 'kv_keys_exhausted', 507);
+        this.name = 'KvKeysExhaustedError';
+        this.keys = keys;
+        this.cap = cap;
+    }
+}
+//# sourceMappingURL=kv.js.map

package/dist/errors/kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.js","sourceRoot":"","sources":["../../src/errors/kv.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,6 +1,9 @@
 export { ButterbaseClient, createClient } from './lib/butterbase-client.js';
 export { QueryBuilder } from './lib/query-builder.js';
 export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-builders.js';
+export { computeLockfileHash, type LockfileResult, type FileReader } from './lib/lockfile-hash.js';
+export { consumeSse, type SseEvent } from './lib/sse.js';
+export { defineKvConfig, type KvConfigInput, type KvExposeRule, type KvRole } from './kv-config.js';
 export { AuthClient } from './auth/auth-client.js';
 export { StorageClient } from './storage/storage-client.js';
 export { FunctionsClient } from './functions/functions-client.js';
@@ -20,14 +23,21 @@ export { AdminAuditLogsClient } from './admin/audit-logs-client.js';
 export { AdminFrontendClient } from './admin/frontend-client.js';
 export { AdminRealtimeClient } from './admin/realtime-client.js';
 export { AdminDomainsClient } from './admin/domains-client.js';
+export { AdminDurableObjectsClient } from './admin/durable-objects-client.js';
+export { AdminEdgeSsrClient } from './admin/edge-ssr-client.js';
+export { AdminMigrationsClient } from './admin/migrations-client.js';
+export { AdminPlatformBillingClient } from './admin/platform-billing-client.js';
 export { RealtimeClient } from './realtime/realtime-client.js';
-export { ButterbaseError, AuthError, ValidationError, NotFoundError, QuotaError, NetworkError, } from './errors/index.js';
+export { ButterbaseError, AuthError, ValidationError, NotFoundError, QuotaError, NetworkError, parseApiError, KvError, KvAuthError, KvForbiddenError, KvNotFoundError, KvKeyInvalidError, KvConnectionError, KvCasMismatchError, KvExposeConflictError, KvValueTooLargeError, KvQuotaExceededError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, } from './errors/index.js';
+export { ErrorCodes, isAgentFriendlyError, } from '@butterbase/shared';
+export type { ErrorCode, AgentFriendlyError } from '@butterbase/shared';
+export { parseRegions, loadRegionConfig, butterbaseRegionToFlyRegion, } from '@butterbase/shared';
 export { SessionManager } from './auth/session-manager.js';
 export { LocalSessionStorage, MemorySessionStorage, detectSessionStorage } from './auth/session-storage.js';
 export type { SessionStorage } from './auth/session-storage.js';
-export type { ButterbaseClientOptions, ButterbaseResponse, User, Session, SignUpParams, SignInParams, AuthResponse, LoginResponse, SignupResponse, OAuthParams, OAuthCallbackResult, StorageObject, UploadResponse, DownloadUrlResponse, QueryOperator, QueryFilter, OrderByOptions, InvokeFunctionOptions, AuthEvent, AuthChangeCallback, Subscription, ChatMessage, ChatOptions, ChatCompletion, ChatStreamChunk, AiConfig, AiUsage, Plan, CreatePlanParams, Product, CreateProductParams, BillingSubscription, CheckoutSession, SubscribeParams, PurchaseParams, PurchaseResult, Order, ConnectOnboardResult, ConnectStatus, SchemaTable, SchemaColumn, SchemaIndex, SchemaDefinition, MigrationResult, Migration, RlsPolicy, CreatePolicyParams, OAuthConfig, OAuthConfigParams, AppConfig, CorsConfig, JwtConfig, DeployFunctionParams, FunctionDetails, FunctionSummary, FunctionLog, LogOptions, ApiKey, ApiKeySummary, AuditLog, AuditLogQueryOptions, Deployment, CreateDeploymentParams, RealtimeConfig, RealtimeTableResult, CustomDomain, CustomDomainAddResult, CustomDomainStatus, } from './types/index.js';
+export type { ButterbaseClientOptions, ButterbaseResponse, User, Session, SignUpParams, SignInParams, AuthResponse, LoginResponse, SignupResponse, OAuthParams, OAuthCallbackResult, StorageObject, UploadResponse, DownloadUrlResponse, QueryOperator, QueryFilter, OrderByOptions, InvokeFunctionOptions, AuthEvent, AuthChangeCallback, Subscription, ChatMessage, ChatOptions, ChatCompletion, ChatStreamChunk, AiConfig, AiUsage, EmbeddingRequest, EmbeddingResponse, EmbeddingVector, AiModel, Plan, CreatePlanParams, Product, CreateProductParams, BillingSubscription, CheckoutSession, SubscribeParams, PurchaseParams, PurchaseResult, Order, ConnectOnboardResult, ConnectStatus, SchemaTable, SchemaColumn, SchemaIndex, SchemaDefinition, MigrationResult, Migration, RlsPolicy, CreatePolicyParams, OAuthConfig, OAuthConfigParams, AppConfig, CorsConfig, JwtConfig, DeployFunctionParams, FunctionDetails, FunctionSummary, FunctionLog, LogOptions, ApiKey, ApiKeySummary, AuditLog, AuditLogQueryOptions, Deployment, CreateDeploymentParams, RealtimeConfig, RealtimeTableResult, CustomDomain, CustomDomainAddResult, CustomDomainStatus, PlatformBillingStatus, TopupRequest, SpendingCap, PlatformMeterType, PlatformUsageOptions, } from './types/index.js';
 export type { IntegrationConfig as IntegrationConfigType, AvailableIntegration, ConnectedAccount as ConnectedAccountType, IntegrationTool, ToolResult, ConfigureOptions, ConnectOptions, ConnectResult, ListAvailableOptions, } from './integrations/types.js';
 export type { PartnerListItem, PartnerListResponse, } from './partners/types.js';
-export type { Collection, CollectionDetails, RagDocument, IngestResult, QueryChunk, QueryResult, SynthesizedQueryResult, CreateCollectionOptions, IngestOptions, QueryOptions, } from './rag/types.js';
+export type { Collection, CollectionDetails, RagDocument, IngestResult, QueryChunk, QueryResult, CreateCollectionOptions, IngestOptions, QueryOptions, } from './rag/types.js';
 export type { RealtimeStatus, RealtimeChange, PresenceEvent, ChangeCallback, PresenceCallback, StatusCallback, RealtimeSubscription, } from './realtime/types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -4,6 +4,11 @@ export { ButterbaseClient, createClient } from './lib/butterbase-client.js';
 export { QueryBuilder } from './lib/query-builder.js';
 // Mutation builders
 export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-builders.js';
+// Utility helpers
+export { computeLockfileHash } from './lib/lockfile-hash.js';
+export { consumeSse } from './lib/sse.js';
+// KV config helper
+export { defineKvConfig } from './kv-config.js';
 // Client modules
 export { AuthClient } from './auth/auth-client.js';
 export { StorageClient } from './storage/storage-client.js';
@@ -25,10 +30,19 @@ export { AdminAuditLogsClient } from './admin/audit-logs-client.js';
 export { AdminFrontendClient } from './admin/frontend-client.js';
 export { AdminRealtimeClient } from './admin/realtime-client.js';
 export { AdminDomainsClient } from './admin/domains-client.js';
+export { AdminDurableObjectsClient } from './admin/durable-objects-client.js';
+export { AdminEdgeSsrClient } from './admin/edge-ssr-client.js';
+export { AdminMigrationsClient } from './admin/migrations-client.js';
+export { AdminPlatformBillingClient } from './admin/platform-billing-client.js';
 // Realtime client
 export { RealtimeClient } from './realtime/realtime-client.js';
 // Error types
-export { ButterbaseError, AuthError, ValidationError, NotFoundError, QuotaError, NetworkError, } from './errors/index.js';
+export { ButterbaseError, AuthError, ValidationError, NotFoundError, QuotaError, NetworkError, parseApiError, 
+// KV error classes
+KvError, KvAuthError, KvForbiddenError, KvNotFoundError, KvKeyInvalidError, KvConnectionError, KvCasMismatchError, KvExposeConflictError, KvValueTooLargeError, KvQuotaExceededError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, } from './errors/index.js';
+// Shared package re-exports
+export { ErrorCodes, isAgentFriendlyError, } from '@butterbase/shared';
+export { parseRegions, loadRegionConfig, butterbaseRegionToFlyRegion, } from '@butterbase/shared';
 // Session persistence
 export { SessionManager } from './auth/session-manager.js';
 export { LocalSessionStorage, MemorySessionStorage, detectSessionStorage } from './auth/session-storage.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc;AACd,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAE5E,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,oBAAoB;AACpB,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEzF,iBAAiB;AACjB,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uCAAuC,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,eAAe;AACf,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACnE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,kBAAkB;AAClB,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAE/D,cAAc;AACd,OAAO,EACL,eAAe,EACf,SAAS,EACT,eAAe,EACf,aAAa,EACb,UAAU,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,sBAAsB;AACtB,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}