@tinycloud/sdk-services 3.2.0-beta.3 → 3.2.0-beta.7

package/dist/kv/replication/prefix.cjs

@@ -0,0 +1,43 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/kv/replication/prefix.ts
+var prefix_exports = {};
+__export(prefix_exports, {
+  assertFolderPrefix: () => assertFolderPrefix,
+  kvPrefixCovers: () => kvPrefixCovers
+});
+module.exports = __toCommonJS(prefix_exports);
+function kvPrefixCovers(prefix, key) {
+  return prefix === "/" || key.startsWith(prefix);
+}
+function assertFolderPrefix(prefix) {
+  const validFolder = typeof prefix === "string" && prefix.length > 0 && !prefix.startsWith("/") && !prefix.includes("//") && prefix.endsWith("/");
+  if (prefix !== "/" && !validFolder) {
+    const folderHint = typeof prefix === "string" ? prefix.replace(/^\/+/, "").replace(/\/+$/, "") : "";
+    const suggestion = folderHint.length > 0 && !folderHint.includes("//") ? ` Use ${JSON.stringify(`${folderHint}/`)}.` : ' Use "/" or a slash-terminated folder path such as "notes/".';
+    throw new TypeError(`Replication prefix must be "/" or a non-empty slash-terminated folder path without empty segments.${suggestion}`);
+  }
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertFolderPrefix,
+  kvPrefixCovers
+});
+//# sourceMappingURL=prefix.cjs.map

package/dist/kv/replication/prefix.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kv/replication/prefix.ts"],"sourcesContent":["/** Shared prefix boundary and configuration rules; no runtime dependencies. */\nexport function kvPrefixCovers(prefix: string, key: string): boolean {\n  return prefix === \"/\" || key.startsWith(prefix);\n}\n\n/** Replication scopes are `/` or non-empty, slash-terminated folder paths. */\nexport function assertFolderPrefix(prefix: unknown): asserts prefix is string {\n  const validFolder = typeof prefix === \"string\" &&\n    prefix.length > 0 &&\n    !prefix.startsWith(\"/\") &&\n    !prefix.includes(\"//\") &&\n    prefix.endsWith(\"/\");\n  if (prefix !== \"/\" && !validFolder) {\n    const folderHint = typeof prefix === \"string\"\n      ? prefix.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\")\n      : \"\";\n    const suggestion = folderHint.length > 0 && !folderHint.includes(\"//\")\n      ? ` Use ${JSON.stringify(`${folderHint}/`)}.`\n      : ' Use \"/\" or a slash-terminated folder path such as \"notes/\".';\n    throw new TypeError(`Replication prefix must be \"/\" or a non-empty slash-terminated folder path without empty segments.${suggestion}`);\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AACO,SAAS,eAAe,QAAgB,KAAsB;AACnE,SAAO,WAAW,OAAO,IAAI,WAAW,MAAM;AAChD;AAGO,SAAS,mBAAmB,QAA2C;AAC5E,QAAM,cAAc,OAAO,WAAW,YACpC,OAAO,SAAS,KAChB,CAAC,OAAO,WAAW,GAAG,KACtB,CAAC,OAAO,SAAS,IAAI,KACrB,OAAO,SAAS,GAAG;AACrB,MAAI,WAAW,OAAO,CAAC,aAAa;AAClC,UAAM,aAAa,OAAO,WAAW,WACjC,OAAO,QAAQ,QAAQ,EAAE,EAAE,QAAQ,QAAQ,EAAE,IAC7C;AACJ,UAAM,aAAa,WAAW,SAAS,KAAK,CAAC,WAAW,SAAS,IAAI,IACjE,QAAQ,KAAK,UAAU,GAAG,UAAU,GAAG,CAAC,MACxC;AACJ,UAAM,IAAI,UAAU,qGAAqG,UAAU,EAAE;AAAA,EACvI;AACF;","names":[]}

package/dist/kv/replication/prefix.d.cts

@@ -0,0 +1,6 @@
+/** Shared prefix boundary and configuration rules; no runtime dependencies. */
+declare function kvPrefixCovers(prefix: string, key: string): boolean;
+/** Replication scopes are `/` or non-empty, slash-terminated folder paths. */
+declare function assertFolderPrefix(prefix: unknown): asserts prefix is string;
+
+export { assertFolderPrefix, kvPrefixCovers };

package/dist/kv/replication/prefix.d.ts

@@ -0,0 +1,6 @@
+/** Shared prefix boundary and configuration rules; no runtime dependencies. */
+declare function kvPrefixCovers(prefix: string, key: string): boolean;
+/** Replication scopes are `/` or non-empty, slash-terminated folder paths. */
+declare function assertFolderPrefix(prefix: unknown): asserts prefix is string;
+
+export { assertFolderPrefix, kvPrefixCovers };

package/dist/kv/replication/prefix.js

@@ -0,0 +1,17 @@
+// src/kv/replication/prefix.ts
+function kvPrefixCovers(prefix, key) {
+  return prefix === "/" || key.startsWith(prefix);
+}
+function assertFolderPrefix(prefix) {
+  const validFolder = typeof prefix === "string" && prefix.length > 0 && !prefix.startsWith("/") && !prefix.includes("//") && prefix.endsWith("/");
+  if (prefix !== "/" && !validFolder) {
+    const folderHint = typeof prefix === "string" ? prefix.replace(/^\/+/, "").replace(/\/+$/, "") : "";
+    const suggestion = folderHint.length > 0 && !folderHint.includes("//") ? ` Use ${JSON.stringify(`${folderHint}/`)}.` : ' Use "/" or a slash-terminated folder path such as "notes/".';
+    throw new TypeError(`Replication prefix must be "/" or a non-empty slash-terminated folder path without empty segments.${suggestion}`);
+  }
+}
+export {
+  assertFolderPrefix,
+  kvPrefixCovers
+};
+//# sourceMappingURL=prefix.js.map

package/dist/kv/replication/prefix.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/kv/replication/prefix.ts"],"sourcesContent":["/** Shared prefix boundary and configuration rules; no runtime dependencies. */\nexport function kvPrefixCovers(prefix: string, key: string): boolean {\n  return prefix === \"/\" || key.startsWith(prefix);\n}\n\n/** Replication scopes are `/` or non-empty, slash-terminated folder paths. */\nexport function assertFolderPrefix(prefix: unknown): asserts prefix is string {\n  const validFolder = typeof prefix === \"string\" &&\n    prefix.length > 0 &&\n    !prefix.startsWith(\"/\") &&\n    !prefix.includes(\"//\") &&\n    prefix.endsWith(\"/\");\n  if (prefix !== \"/\" && !validFolder) {\n    const folderHint = typeof prefix === \"string\"\n      ? prefix.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\")\n      : \"\";\n    const suggestion = folderHint.length > 0 && !folderHint.includes(\"//\")\n      ? ` Use ${JSON.stringify(`${folderHint}/`)}.`\n      : ' Use \"/\" or a slash-terminated folder path such as \"notes/\".';\n    throw new TypeError(`Replication prefix must be \"/\" or a non-empty slash-terminated folder path without empty segments.${suggestion}`);\n  }\n}\n"],"mappings":";AACO,SAAS,eAAe,QAAgB,KAAsB;AACnE,SAAO,WAAW,OAAO,IAAI,WAAW,MAAM;AAChD;AAGO,SAAS,mBAAmB,QAA2C;AAC5E,QAAM,cAAc,OAAO,WAAW,YACpC,OAAO,SAAS,KAChB,CAAC,OAAO,WAAW,GAAG,KACtB,CAAC,OAAO,SAAS,IAAI,KACrB,OAAO,SAAS,GAAG;AACrB,MAAI,WAAW,OAAO,CAAC,aAAa;AAClC,UAAM,aAAa,OAAO,WAAW,WACjC,OAAO,QAAQ,QAAQ,EAAE,EAAE,QAAQ,QAAQ,EAAE,IAC7C;AACJ,UAAM,aAAa,WAAW,SAAS,KAAK,CAAC,WAAW,SAAS,IAAI,IACjE,QAAQ,KAAK,UAAU,GAAG,UAAU,GAAG,CAAC,MACxC;AACJ,UAAM,IAAI,UAAU,qGAAqG,UAAU,EAAE;AAAA,EACvI;AACF;","names":[]}

package/dist/{scope-BmLxwyl-.d.ts → scope-CoKKmMiI.d.ts}

@@ -1,4 +1,4 @@
-import { R as Result, F as FetchFunction } from './types-7A5rHWRY.js';
+import { R as Result, F as FetchFunction } from './types-D-9A3Sut.js';
 
 /**
  * KV Service Types
@@ -729,6 +729,8 @@ interface KVReplicationDeps {
      * after restart. Pending-state failures also fail closed to network reads.
      */
     pending: PendingWriteStore;
+    /** Node `/info` features discovered on sign-in for protocol gating. */
+    nodeFeatures?: readonly string[];
     scheduler: ReplicationScheduler;
     emit(event: ReplicationEvent): void;
     fetch?: FetchFunction;
@@ -818,7 +820,7 @@ interface ReplicationControl {
 }
 interface ReplicationOptions {
     enabled: boolean;
-    /** Non-empty primary-space prefixes; none empty or overlapping. Prefer no trailing slash. */
+    /** Non-empty list of folder prefixes ending in `/`, or `/` for the whole space. */
     prefixes: string[];
     /** Required for prefixes/spaces where requiresSecretsOptIn returns true. */
     allowSecrets?: boolean;
@@ -949,9 +951,7 @@ declare function canonicalReplicationIdentity(raw: ReplicationIdentity): Replica
 /** Stable in-memory key; durable adapters hash its UTF-8 bytes with their platform crypto. */
 declare function replicationIdentityKey(id: ReplicationIdentity): string;
 
-/** Published replica selector semantics: exact key plus descendants by segment. */
-declare function kvPrefixCovers(prefix: string, key: string): boolean;
 /** Whether replicating this space/prefix can copy encrypted secret material to disk. */
 declare function requiresSecretsOptIn(space: string, prefix: string): boolean;
 
-export { type KVListOptions as $, type AuthorityRefusal as A, type ReplicationScheduler as B, CLEAR_PENDING_WARNING as C, type ResolvedReplicationOptions as D, canonicalReplicationIdentity as E, kvPrefixCovers as F, replicationIdentityKey as G, requiresSecretsOptIn as H, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as I, KVAction as J, type KVReplicationDeps as K, type LocalGetResult as L, type KVActionType as M, type KVBatchPutItem as N, type KVBatchPutOptions as O, type PendingWriteStore as P, type KVBatchPutResponse as Q, type ReplicationIdentity as R, type KVBatchReadResponse as S, type KVChange as T, type KVChangesAuthority as U, type KVChangesOptions as V, type KVChangesResponse as W, type KVCreateSignedReadUrlOptions as X, type KVDeleteOptions as Y, type KVGetOptions as Z, type KVHeadOptions as _, type KVReplicationController as a, type KVListResponse as a0, type KVPutOptions as a1, type KVResponse as a2, type KVResponseHeaders as a3, type KVServiceConfig as a4, type KVSignedReadUrlResponse as a5, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type PurgeTarget as n, type ReplicaAuthorityState as o, type ReplicaCoverage as p, type ReplicaDevice as q, type ReplicaGrantInfo as r, type ReplicaState as s, type ReplicaStatusEntry as t, type ReplicationAuthority as u, type ReplicationControl as v, type ReplicationEvent as w, type ReplicationOptions as x, type ReplicationPurgeReport as y, type ReplicationReason as z };
+export { type KVListResponse as $, type AuthorityRefusal as A, type ReplicationScheduler as B, CLEAR_PENDING_WARNING as C, type ResolvedReplicationOptions as D, canonicalReplicationIdentity as E, replicationIdentityKey as F, requiresSecretsOptIn as G, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as H, KVAction as I, type KVActionType as J, type KVReplicationDeps as K, type LocalGetResult as L, type KVBatchPutItem as M, type KVBatchPutOptions as N, type KVBatchPutResponse as O, type PendingWriteStore as P, type KVBatchReadResponse as Q, type ReplicationIdentity as R, type KVChange as S, type KVChangesAuthority as T, type KVChangesOptions as U, type KVChangesResponse as V, type KVCreateSignedReadUrlOptions as W, type KVDeleteOptions as X, type KVGetOptions as Y, type KVHeadOptions as Z, type KVListOptions as _, type KVReplicationController as a, type KVPutOptions as a0, type KVResponse as a1, type KVResponseHeaders as a2, type KVServiceConfig as a3, type KVSignedReadUrlResponse as a4, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type PurgeTarget as n, type ReplicaAuthorityState as o, type ReplicaCoverage as p, type ReplicaDevice as q, type ReplicaGrantInfo as r, type ReplicaState as s, type ReplicaStatusEntry as t, type ReplicationAuthority as u, type ReplicationControl as v, type ReplicationEvent as w, type ReplicationOptions as x, type ReplicationPurgeReport as y, type ReplicationReason as z };

package/dist/{scope-D855kRDx.d.cts → scope-D7wmjbMH.d.cts}

@@ -1,4 +1,4 @@
-import { R as Result, F as FetchFunction } from './types-7A5rHWRY.cjs';
+import { R as Result, F as FetchFunction } from './types-D-9A3Sut.cjs';
 
 /**
  * KV Service Types
@@ -729,6 +729,8 @@ interface KVReplicationDeps {
      * after restart. Pending-state failures also fail closed to network reads.
      */
     pending: PendingWriteStore;
+    /** Node `/info` features discovered on sign-in for protocol gating. */
+    nodeFeatures?: readonly string[];
     scheduler: ReplicationScheduler;
     emit(event: ReplicationEvent): void;
     fetch?: FetchFunction;
@@ -818,7 +820,7 @@ interface ReplicationControl {
 }
 interface ReplicationOptions {
     enabled: boolean;
-    /** Non-empty primary-space prefixes; none empty or overlapping. Prefer no trailing slash. */
+    /** Non-empty list of folder prefixes ending in `/`, or `/` for the whole space. */
     prefixes: string[];
     /** Required for prefixes/spaces where requiresSecretsOptIn returns true. */
     allowSecrets?: boolean;
@@ -949,9 +951,7 @@ declare function canonicalReplicationIdentity(raw: ReplicationIdentity): Replica
 /** Stable in-memory key; durable adapters hash its UTF-8 bytes with their platform crypto. */
 declare function replicationIdentityKey(id: ReplicationIdentity): string;
 
-/** Published replica selector semantics: exact key plus descendants by segment. */
-declare function kvPrefixCovers(prefix: string, key: string): boolean;
 /** Whether replicating this space/prefix can copy encrypted secret material to disk. */
 declare function requiresSecretsOptIn(space: string, prefix: string): boolean;
 
-export { type KVListOptions as $, type AuthorityRefusal as A, type ReplicationScheduler as B, CLEAR_PENDING_WARNING as C, type ResolvedReplicationOptions as D, canonicalReplicationIdentity as E, kvPrefixCovers as F, replicationIdentityKey as G, requiresSecretsOptIn as H, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as I, KVAction as J, type KVReplicationDeps as K, type LocalGetResult as L, type KVActionType as M, type KVBatchPutItem as N, type KVBatchPutOptions as O, type PendingWriteStore as P, type KVBatchPutResponse as Q, type ReplicationIdentity as R, type KVBatchReadResponse as S, type KVChange as T, type KVChangesAuthority as U, type KVChangesOptions as V, type KVChangesResponse as W, type KVCreateSignedReadUrlOptions as X, type KVDeleteOptions as Y, type KVGetOptions as Z, type KVHeadOptions as _, type KVReplicationController as a, type KVListResponse as a0, type KVPutOptions as a1, type KVResponse as a2, type KVResponseHeaders as a3, type KVServiceConfig as a4, type KVSignedReadUrlResponse as a5, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type PurgeTarget as n, type ReplicaAuthorityState as o, type ReplicaCoverage as p, type ReplicaDevice as q, type ReplicaGrantInfo as r, type ReplicaState as s, type ReplicaStatusEntry as t, type ReplicationAuthority as u, type ReplicationControl as v, type ReplicationEvent as w, type ReplicationOptions as x, type ReplicationPurgeReport as y, type ReplicationReason as z };
+export { type KVListResponse as $, type AuthorityRefusal as A, type ReplicationScheduler as B, CLEAR_PENDING_WARNING as C, type ResolvedReplicationOptions as D, canonicalReplicationIdentity as E, replicationIdentityKey as F, requiresSecretsOptIn as G, DEFAULT_SIGNED_READ_URL_EXPIRY_MS as H, KVAction as I, type KVActionType as J, type KVReplicationDeps as K, type LocalGetResult as L, type KVBatchPutItem as M, type KVBatchPutOptions as N, type KVBatchPutResponse as O, type PendingWriteStore as P, type KVBatchReadResponse as Q, type ReplicationIdentity as R, type KVChange as S, type KVChangesAuthority as T, type KVChangesOptions as U, type KVChangesResponse as V, type KVCreateSignedReadUrlOptions as W, type KVDeleteOptions as X, type KVGetOptions as Y, type KVHeadOptions as Z, type KVListOptions as _, type KVReplicationController as a, type KVPutOptions as a0, type KVResponse as a1, type KVResponseHeaders as a2, type KVServiceConfig as a3, type KVSignedReadUrlResponse as a4, type KVListPage as b, type KVReadThrough as c, type KVReplicaHandle as d, type KVReplicaSpec as e, type KVReplicaStorage as f, type LocalListResult as g, type LocalReadMeta as h, type LocalReplicaStatus as i, type LocalSyncResult as j, type PendingWriteRecord as k, type PendingWriteState as l, type PinnedKey as m, type PurgeTarget as n, type ReplicaAuthorityState as o, type ReplicaCoverage as p, type ReplicaDevice as q, type ReplicaGrantInfo as r, type ReplicaState as s, type ReplicaStatusEntry as t, type ReplicationAuthority as u, type ReplicationControl as v, type ReplicationEvent as w, type ReplicationOptions as x, type ReplicationPurgeReport as y, type ReplicationReason as z };

package/dist/sql/index.cjs

@@ -65,6 +65,8 @@ var ErrorCodes = {
   // Storage quota errors
   STORAGE_QUOTA_EXCEEDED: "STORAGE_QUOTA_EXCEEDED",
   STORAGE_LIMIT_REACHED: "STORAGE_LIMIT_REACHED",
+  /** The node answered the usage read without usage numbers (it predates the read). */
+  STORAGE_STATUS_UNAVAILABLE: "STORAGE_STATUS_UNAVAILABLE",
   // DuckDB-specific errors
   DUCKDB_ERROR: "DUCKDB_ERROR",
   DUCKDB_PERMISSION_DENIED: "DUCKDB_PERMISSION_DENIED",
@@ -94,7 +96,9 @@ var TelemetryEvents = {
   REPLICATION_WRITE: "replication.write",
   REPLICATION_SYNC: "replication.sync",
   REPLICATION_STATE: "replication.state",
-  REPLICATION_DIVERGENCE: "replication.divergence"
+  REPLICATION_DIVERGENCE: "replication.divergence",
+  /** Emitted once, on the first write rejected because storage is full. */
+  STORAGE_FULL: "storage.full"
 };
 function ok(data) {
   return { ok: true, data };
@@ -194,8 +198,43 @@ function parseStorageQuotaBytes(responseText) {
     limitBytes: parseInt(match[2], 10)
   };
 }
+var STORAGE_REJECTION_BODY_ERRORS = {
+  storage_quota_exceeded: true,
+  storage_limit_reached: true
+};
+function isByteCount(value) {
+  return typeof value === "number" && Number.isSafeInteger(value) && value >= 0;
+}
+function byteCountsOf(value) {
+  if (typeof value !== "object" || value === null) return void 0;
+  const { usedBytes, limitBytes } = value;
+  return isByteCount(usedBytes) && isByteCount(limitBytes) ? { usedBytes, limitBytes } : void 0;
+}
+function parseStorageRejection(responseText) {
+  let body;
+  try {
+    body = JSON.parse(responseText);
+  } catch {
+    return parseStorageQuotaBytes(responseText);
+  }
+  if (typeof body !== "object" || body === null) return void 0;
+  const record = body;
+  const message = typeof record.message === "string" ? record.message : "";
+  const space = byteCountsOf(record.space) ?? parseStorageQuotaBytes(message);
+  const isStorageBody = typeof record.error === "string" && STORAGE_REJECTION_BODY_ERRORS[record.error] === true;
+  if (!space && !isStorageBody) {
+    return void 0;
+  }
+  const details = { ...space };
+  const account = byteCountsOf(record.account);
+  if (account) {
+    const plan = record.account.plan;
+    details.account = typeof plan === "string" && plan !== "" ? { ...account, plan } : account;
+  }
+  return details;
+}
 function storageRejectionError(service, status, meta, responseText) {
-  const quotaMeta = { ...meta, ...parseStorageQuotaBytes(responseText) };
+  const quotaMeta = { ...meta, ...parseStorageRejection(responseText) };
   return status === 402 ? storageQuotaExceededError(service, STORAGE_FULL_MESSAGE, quotaMeta) : storageLimitReachedError(service, STORAGE_WRITE_TOO_LARGE_MESSAGE, quotaMeta);
 }
 function wrapError(service, error, defaultCode = ErrorCodes.NETWORK_ERROR) {
@@ -927,6 +966,9 @@ var SQLService = class extends BaseService {
     if (response.status === 402) {
       return err(storageRejectionError("sql", 402, meta, errorText));
     }
+    if (response.status === 413 && parseStorageRejection(errorText)) {
+      return err(storageRejectionError("sql", 413, meta, errorText));
+    }
     const errorBody = parseServiceErrorBody(errorText);
     const errorCode = this.mapHttpStatusToErrorCode(
       response.status,