@butterbase/sdk 2.3.1 → 2.3.3

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,10 +1,6 @@
-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);
-}
+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(m: string, c: string, s: number, r?: string, d?: unknown);
 }
@@ -20,6 +16,9 @@ export declare class QuotaError extends ButterbaseError {
 export declare class NetworkError extends ButterbaseError {
     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 a backend response into a typed ButterbaseError subclass.
  *

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/errors/index.ts"],"names":[],"mappings":"AAEA,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;AAED,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;AA+B1M;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,eAAe,CAe5E"}
+{"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,18 +1,7 @@
 import { ErrorCodes, isAgentFriendlyError } from '@butterbase/shared';
-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;
-    }
-}
+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(m, c, s, r, d) { super(m, c, s, r, d); this.name = 'AuthError'; }
 }
@@ -28,6 +17,8 @@ export class QuotaError extends ButterbaseError {
 export class NetworkError extends ButterbaseError {
     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,
@@ -35,9 +26,30 @@ const EXACT = {
     [ErrorCodes.AUTH_INSUFFICIENT_PERMISSIONS]: AuthError,
     [ErrorCodes.RESOURCE_NOT_FOUND]: NotFoundError,
 };
-function classifyByCode(code) {
+// 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_'))

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

@@ -3,6 +3,7 @@ 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';
@@ -27,7 +28,7 @@ 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, parseApiError, } 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';

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

@@ -7,6 +7,8 @@ export { InsertBuilder, UpdateBuilder, DeleteBuilder } from './lib/mutation-buil
 // 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';
@@ -35,7 +37,9 @@ 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, parseApiError, } 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';

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,kBAAkB;AAClB,OAAO,EAAE,mBAAmB,EAAwC,MAAM,wBAAwB,CAAC;AACnG,OAAO,EAAE,UAAU,EAAiB,MAAM,cAAc,CAAC;AAEzD,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;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAC9E,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,0BAA0B,EAAE,MAAM,oCAAoC,CAAC;AAEhF,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,EACZ,aAAa,GACd,MAAM,mBAAmB,CAAC;AAE3B,4BAA4B;AAC5B,OAAO,EACL,UAAU,EACV,oBAAoB,GACrB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,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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"}

package/dist/kv-config.d.ts

@@ -0,0 +1,11 @@
+export type KvRole = 'public' | 'authed' | 'owner' | 'deny';
+export interface KvExposeRule {
+    pattern: string;
+    read: KvRole;
+    write: KvRole;
+}
+export interface KvConfigInput {
+    expose: KvExposeRule[];
+}
+export declare function defineKvConfig(config: KvConfigInput): KvConfigInput;
+//# sourceMappingURL=kv-config.d.ts.map

package/dist/kv-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv-config.d.ts","sourceRoot":"","sources":["../src/kv-config.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;AAE5D,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,YAAY,EAAE,CAAC;CACxB;AAED,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,aAAa,CAEnE"}

package/dist/kv-config.js

@@ -0,0 +1,4 @@
+export function defineKvConfig(config) {
+    return config;
+}
+//# sourceMappingURL=kv-config.js.map

package/dist/kv-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv-config.js","sourceRoot":"","sources":["../src/kv-config.ts"],"names":[],"mappings":"AAYA,MAAM,UAAU,cAAc,CAAC,MAAqB;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/kv.d.ts

@@ -0,0 +1,47 @@
+export type Role = 'public' | 'authed' | 'owner' | 'deny';
+export interface KvShim {
+    get<T = unknown>(key: string, opts?: {
+        touch?: boolean;
+    }): Promise<T | null>;
+    set(key: string, value: unknown, opts?: {
+        ttl?: number | null;
+        ephemeral?: boolean;
+    }): Promise<void>;
+    del(key: string): Promise<number>;
+    incr(key: string, by?: number): Promise<number>;
+    decr(key: string, by?: number): Promise<number>;
+    setnx(key: string, value: unknown, opts?: {
+        ttl?: number | null;
+        ephemeral?: boolean;
+    }): Promise<boolean>;
+    setex(key: string, value: unknown, ttl: number, opts?: {
+        ephemeral?: boolean;
+    }): Promise<void>;
+    cas(key: string, expected: unknown, next: unknown): Promise<boolean>;
+    exists(key: string): Promise<boolean>;
+    ttl(key: string): Promise<number | null>;
+    expire(key: string, ttl: number | null): Promise<boolean>;
+    mget<T = unknown>(keys: string[]): Promise<(T | null)[]>;
+    mset(entries: Record<string, unknown>, opts?: {
+        ttl?: number | null;
+    }): Promise<void>;
+    expose(pattern: string, opts: {
+        read: Role;
+        write: Role;
+    }): Promise<void>;
+    unexpose(pattern: string): Promise<number>;
+    listRules(): Promise<Array<{
+        pattern: string;
+        read: Role;
+        write: Role;
+        order: number;
+    }>>;
+}
+export interface MakeKvOptions {
+    appId: string;
+    apiKey: string;
+    baseUrl: string;
+    fetch?: typeof fetch;
+}
+export declare function makeKv(opts: MakeKvOptions): KvShim;
+//# sourceMappingURL=kv.d.ts.map

package/dist/kv.d.ts.map

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

package/dist/kv.js

@@ -0,0 +1,170 @@
+// packages/sdk/src/kv.ts
+import { KvError, KvKeyInvalidError, KvAuthError, KvForbiddenError, KvConnectionError, KvCasMismatchError, KvExposeConflictError, KvValueTooLargeError, KvRateLimitedError, KvCreditsExhaustedError, KvStorageFullError, KvKeysExhaustedError, } from './errors/kv.js';
+export function makeKv(opts) {
+    const f = opts.fetch ?? fetch;
+    const root = `${opts.baseUrl}/v1/${opts.appId}/kv`;
+    const headers = {
+        authorization: `Bearer ${opts.apiKey}`,
+        'content-type': 'application/json',
+    };
+    async function call(method, pathSuffix, body) {
+        return f(`${root}/${pathSuffix}`, {
+            method,
+            headers,
+            body: body === undefined ? undefined : JSON.stringify(body),
+        });
+    }
+    function throwForStatus(res, body) {
+        const msg = body?.message ?? `kv error (status ${res.status})`;
+        if (res.status === 400)
+            throw new KvKeyInvalidError(msg);
+        if (res.status === 401)
+            throw new KvAuthError(msg);
+        if (res.status === 402)
+            throw new KvCreditsExhaustedError(msg);
+        if (res.status === 403)
+            throw new KvForbiddenError(msg);
+        if (res.status === 409) {
+            if (body?.error === 'KV_EXPOSE_CONFLICT')
+                throw new KvExposeConflictError(msg);
+            throw new KvCasMismatchError(msg); // reserved for future strict-CAS mode
+        }
+        if (res.status === 413)
+            throw new KvValueTooLargeError(msg);
+        if (res.status === 429)
+            throw new KvRateLimitedError(body?.retry_after ?? 0, msg);
+        if (res.status === 503)
+            throw new KvConnectionError(msg);
+        if (res.status === 507) {
+            if (body?.error === 'kv_storage_full') {
+                throw new KvStorageFullError(body?.used_bytes ?? 0, body?.cap_bytes ?? 0, msg);
+            }
+            if (body?.error === 'kv_keys_exhausted') {
+                throw new KvKeysExhaustedError(body?.keys ?? 0, body?.cap ?? 0, msg);
+            }
+            // Unknown 507 — fall through to generic KvError
+        }
+        throw new KvError(msg, body?.error ?? 'KV_ERROR', res.status);
+    }
+    return {
+        async get(key, opts) {
+            const path = opts?.touch === true ? `${key}?touch=true` : key;
+            const res = await call('GET', path);
+            if (res.status === 404)
+                return null;
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).value;
+        },
+        async set(key, value, opts) {
+            const body = { value };
+            if (opts?.ttl !== undefined)
+                body.ttl = opts.ttl;
+            if (opts?.ephemeral !== undefined)
+                body.ephemeral = opts.ephemeral;
+            const res = await call('PUT', key, body);
+            if (!res.ok && res.status !== 204)
+                throwForStatus(res, await res.json().catch(() => null));
+        },
+        async del(key) {
+            const res = await call('DELETE', key);
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).deleted;
+        },
+        async incr(key, by) {
+            const body = by !== undefined ? { by } : {};
+            const res = await call('POST', `${key}/incr`, body);
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).value;
+        },
+        async decr(key, by) {
+            const body = by !== undefined ? { by } : {};
+            const res = await call('POST', `${key}/decr`, body);
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).value;
+        },
+        async setnx(key, value, opts) {
+            const body = { value };
+            if (opts?.ttl !== undefined)
+                body.ttl = opts.ttl;
+            if (opts?.ephemeral !== undefined)
+                body.ephemeral = opts.ephemeral;
+            const res = await call('POST', `${key}/setnx`, body);
+            if (res.status === 201)
+                return true;
+            if (res.status === 200)
+                return false;
+            throwForStatus(res, await res.json().catch(() => null));
+        },
+        async setex(key, value, ttl, opts) {
+            return this.set(key, value, { ttl, ephemeral: opts?.ephemeral });
+        },
+        async cas(key, expected, next) {
+            const res = await call('POST', `${key}/cas`, { expected, next });
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).swapped;
+        },
+        async exists(key) {
+            const res = await call('GET', `${key}/exists`);
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).exists;
+        },
+        async ttl(key) {
+            const res = await call('GET', `${key}/ttl`);
+            if (res.status === 404)
+                return null;
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).ttl;
+        },
+        async expire(key, ttl) {
+            const res = await call('POST', `${key}/expire`, { ttl });
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).ok;
+        },
+        async mget(keys) {
+            const ops = keys.map((key) => ({ op: 'get', key }));
+            const res = await call('POST', '_batch', { ops });
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            const { results } = await res.json();
+            return results.map((r) => {
+                if ('error' in r)
+                    return null;
+                if ('value' in r)
+                    return r.value;
+                throw new KvError('unexpected batch result shape', 'KV_BATCH_SHAPE', 500);
+            });
+        },
+        async mset(entries, opts) {
+            // Uses parallel PUTs — gateway batch does not honor ttl/ephemeral for set ops.
+            await Promise.all(Object.entries(entries).map(([key, value]) => this.set(key, value, opts)));
+        },
+        async expose(pattern, opts) {
+            const res = await call('PUT', `_expose/${encodeURIComponent(pattern)}`, opts);
+            if (res.status === 204)
+                return;
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+        },
+        async unexpose(pattern) {
+            const res = await call('DELETE', `_expose/${encodeURIComponent(pattern)}`);
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).deleted;
+        },
+        async listRules() {
+            const res = await call('GET', '_expose');
+            if (!res.ok)
+                throwForStatus(res, await res.json().catch(() => null));
+            return (await res.json()).rules;
+        },
+    };
+}
+//# sourceMappingURL=kv.js.map

package/dist/kv.js.map

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

package/package.json

@@ -1,7 +1,17 @@
 {
   "name": "@butterbase/sdk",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "Universal TypeScript SDK for Butterbase",
+  "license": "Apache-2.0",
+  "homepage": "https://butterbase.ai",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/NetGPT-Inc/butterbase-oss",
+    "directory": "packages/sdk"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -15,8 +25,8 @@
     "dist"
   ],
   "scripts": {
-    "build": "tsc",
-    "dev": "tsc --watch",
+    "build": "tsc -b",
+    "dev": "tsc -b --watch",
     "test": "vitest run"
   },
   "keywords": [
@@ -28,7 +38,7 @@
     "storage"
   ],
   "dependencies": {
-    "@butterbase/shared": "*"
+    "@butterbase/shared": "^0.2.1"
   },
   "devDependencies": {
     "typescript": "^5.7.0",