taladb 0.11.0 → 0.11.2

package/dist/index.browser.mjs

@@ -310,6 +310,10 @@ function encodeUlid(value) {
   }
   return out;
 }
+var DOC_ID_PATTERN = /^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$/;
+function isDocId(value) {
+  return typeof value === "string" && DOC_ID_PATTERN.test(value);
+}
 function deriveDocId(collection, key) {
   const bytes = [...UTF8.encode(collection), 0, ...UTF8.encode(key)];
   let hash = FNV1A128_OFFSET_BASIS;
@@ -923,7 +927,11 @@ async function createBrowserDB(dbName, webhook, config, passphrase, migrations)
   return handle;
 }
 async function createNodeDB(dbName, webhook, config, passphrase, migrations) {
-  const native = await import("./node-A4LKRSW5.mjs");
+  const native = await import(
+    /* webpackIgnore: true */
+    /* turbopackIgnore: true */
+    "./node-A4LKRSW5.mjs"
+  );
   const TalaDBNode = native.TalaDbNode ?? native.TalaDBNode;
   if (!TalaDBNode) throw new Error("@taladb/node loaded but exports no TalaDbNode class \u2014 rebuild the native module");
   const configJson = config !== void 0 ? JSON.stringify(config) : null;
@@ -1151,6 +1159,7 @@ export {
   createWebhookDispatcher,
   decorateCollection,
   deriveDocId,
+  isDocId,
   openDB,
   runMigrations,
   validateWebhookConfig

package/dist/index.d.mts

@@ -781,22 +781,18 @@ interface TalaDbConfig {
  * trusts, not adversarial input.
  */
 /**
- * Derive a stable `_id` for a row replicated from a remote origin.
+ * Whether `value` is usable as a document `_id`.
  *
- * `collection` is part of the preimage, so the same remote id in two different
- * collections cannot collide.
+ * Ids are 16 raw bytes on disk, so only a ULID qualifies — a natural key like
+ * `'sku-1'`, `'265'` or a UUID is rejected on insert. Use this to check a value
+ * before writing it, and {@link deriveDocId} to turn a natural key into one.
  *
  * @example
- * deriveDocId('products', 'sku-123')  // → '56GC678DQYWW1Z98HPYJ90WVKH', always
- *
- * ## Ordering caveat
- *
- * The result is a hash, so its ULID timestamp prefix is **not** chronological.
- * Documents written with a derived id do not come back in insertion order from an
- * unsorted `find()`; reads over replicated collections must carry an explicit
- * sort. Documents written via `insert`/`insertMany` are unaffected — they still
- * get monotonic ULIDs.
+ * isDocId(deriveDocId('products', 'sku-123'))  // true
+ * isDocId('sku-123')                           // false
+ * isDocId(crypto.randomUUID())                 // false — a UUID is not a ULID
  */
+declare function isDocId(value: unknown): value is string;
 declare function deriveDocId(collection: string, key: string): string;
 
 /**
@@ -949,4 +945,4 @@ interface OpenDBOptions {
  */
 declare function openDB(dbName?: string, options?: OpenDBOptions): Promise<TalaDB>;
 
-export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createWebhookDispatcher, decorateCollection, deriveDocId, openDB, runMigrations, validateWebhookConfig };
+export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createWebhookDispatcher, decorateCollection, deriveDocId, isDocId, openDB, runMigrations, validateWebhookConfig };

package/dist/index.d.ts

@@ -781,22 +781,18 @@ interface TalaDbConfig {
  * trusts, not adversarial input.
  */
 /**
- * Derive a stable `_id` for a row replicated from a remote origin.
+ * Whether `value` is usable as a document `_id`.
  *
- * `collection` is part of the preimage, so the same remote id in two different
- * collections cannot collide.
+ * Ids are 16 raw bytes on disk, so only a ULID qualifies — a natural key like
+ * `'sku-1'`, `'265'` or a UUID is rejected on insert. Use this to check a value
+ * before writing it, and {@link deriveDocId} to turn a natural key into one.
  *
  * @example
- * deriveDocId('products', 'sku-123')  // → '56GC678DQYWW1Z98HPYJ90WVKH', always
- *
- * ## Ordering caveat
- *
- * The result is a hash, so its ULID timestamp prefix is **not** chronological.
- * Documents written with a derived id do not come back in insertion order from an
- * unsorted `find()`; reads over replicated collections must carry an explicit
- * sort. Documents written via `insert`/`insertMany` are unaffected — they still
- * get monotonic ULIDs.
+ * isDocId(deriveDocId('products', 'sku-123'))  // true
+ * isDocId('sku-123')                           // false
+ * isDocId(crypto.randomUUID())                 // false — a UUID is not a ULID
  */
+declare function isDocId(value: unknown): value is string;
 declare function deriveDocId(collection: string, key: string): string;
 
 /**
@@ -949,4 +945,4 @@ interface OpenDBOptions {
  */
 declare function openDB(dbName?: string, options?: OpenDBOptions): Promise<TalaDB>;
 
-export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createWebhookDispatcher, decorateCollection, deriveDocId, openDB, runMigrations, validateWebhookConfig };
+export { type AggregatePipeline, type AggregateStage, type Collection, type CollectionIndexInfo, type CollectionOptions, type Document, type DurabilityConfig, type Filter, type HybridSearchOptions, type HybridSearchResult, type InsertDoc, type Migration, type OpenDBOptions, type Schema, type TalaDB, type TalaDbConfig, TalaDbValidationError, type TextSearchOptions, type TextSearchResult, type Update, type Value, type VectorIndexOptions, type VectorMetric, type VectorSearchResult, type WebhookConfig, type WebhookDispatcher, type WebhookEvent, type WebhookOp, type WebhookStats, applySchema, createWebhookDispatcher, decorateCollection, deriveDocId, isDocId, openDB, runMigrations, validateWebhookConfig };

package/dist/index.js

@@ -35,6 +35,7 @@ __export(index_exports, {
   createWebhookDispatcher: () => createWebhookDispatcher,
   decorateCollection: () => decorateCollection,
   deriveDocId: () => deriveDocId,
+  isDocId: () => isDocId,
   openDB: () => openDB,
   runMigrations: () => runMigrations,
   validateWebhookConfig: () => validateWebhookConfig
@@ -382,6 +383,10 @@ function encodeUlid(value) {
   }
   return out;
 }
+var DOC_ID_PATTERN = /^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$/;
+function isDocId(value) {
+  return typeof value === "string" && DOC_ID_PATTERN.test(value);
+}
 function deriveDocId(collection, key) {
   const bytes = [...UTF8.encode(collection), 0, ...UTF8.encode(key)];
   let hash = FNV1A128_OFFSET_BASIS;
@@ -996,7 +1001,11 @@ async function createBrowserDB(dbName, webhook, config, passphrase, migrations)
   return handle;
 }
 async function createNodeDB(dbName, webhook, config, passphrase, migrations) {
-  const native = await import("@taladb/node");
+  const native = await import(
+    /* webpackIgnore: true */
+    /* turbopackIgnore: true */
+    "@taladb/node"
+  );
   const TalaDBNode = native.TalaDbNode ?? native.TalaDBNode;
   if (!TalaDBNode) throw new Error("@taladb/node loaded but exports no TalaDbNode class \u2014 rebuild the native module");
   const configJson = config !== void 0 ? JSON.stringify(config) : null;
@@ -1225,6 +1234,7 @@ function attachWebhook(db, webhook) {
   createWebhookDispatcher,
   decorateCollection,
   deriveDocId,
+  isDocId,
   openDB,
   runMigrations,
   validateWebhookConfig

package/dist/index.mjs

@@ -339,6 +339,10 @@ function encodeUlid(value) {
   }
   return out;
 }
+var DOC_ID_PATTERN = /^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$/;
+function isDocId(value) {
+  return typeof value === "string" && DOC_ID_PATTERN.test(value);
+}
 function deriveDocId(collection, key) {
   const bytes = [...UTF8.encode(collection), 0, ...UTF8.encode(key)];
   let hash = FNV1A128_OFFSET_BASIS;
@@ -952,7 +956,11 @@ async function createBrowserDB(dbName, webhook, config, passphrase, migrations)
   return handle;
 }
 async function createNodeDB(dbName, webhook, config, passphrase, migrations) {
-  const native = await import("@taladb/node");
+  const native = await import(
+    /* webpackIgnore: true */
+    /* turbopackIgnore: true */
+    "@taladb/node"
+  );
   const TalaDBNode = native.TalaDbNode ?? native.TalaDBNode;
   if (!TalaDBNode) throw new Error("@taladb/node loaded but exports no TalaDbNode class \u2014 rebuild the native module");
   const configJson = config !== void 0 ? JSON.stringify(config) : null;
@@ -1180,6 +1188,7 @@ export {
   createWebhookDispatcher,
   decorateCollection,
   deriveDocId,
+  isDocId,
   openDB,
   runMigrations,
   validateWebhookConfig

package/dist/index.react-native.mjs

@@ -310,6 +310,10 @@ function encodeUlid(value) {
   }
   return out;
 }
+var DOC_ID_PATTERN = /^[0-9A-HJKMNP-TV-Za-hjkmnp-tv-z]{26}$/;
+function isDocId(value) {
+  return typeof value === "string" && DOC_ID_PATTERN.test(value);
+}
 function deriveDocId(collection, key) {
   const bytes = [...UTF8.encode(collection), 0, ...UTF8.encode(key)];
   let hash = FNV1A128_OFFSET_BASIS;
@@ -923,7 +927,11 @@ async function createBrowserDB(dbName, webhook, config, passphrase, migrations)
   return handle;
 }
 async function createNodeDB(dbName, webhook, config, passphrase, migrations) {
-  const native = await import("./node-A4LKRSW5.mjs");
+  const native = await import(
+    /* webpackIgnore: true */
+    /* turbopackIgnore: true */
+    "./node-A4LKRSW5.mjs"
+  );
   const TalaDBNode = native.TalaDbNode ?? native.TalaDBNode;
   if (!TalaDBNode) throw new Error("@taladb/node loaded but exports no TalaDbNode class \u2014 rebuild the native module");
   const configJson = config !== void 0 ? JSON.stringify(config) : null;
@@ -1151,6 +1159,7 @@ export {
   createWebhookDispatcher,
   decorateCollection,
   deriveDocId,
+  isDocId,
   openDB,
   runMigrations,
   validateWebhookConfig

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "taladb",
-  "version": "0.11.0",
+  "version": "0.11.2",
   "description": "The embedded vector database for on-device AI — documents, similarity search, and offline sync for browser, React Native, and Node.js",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -62,8 +62,8 @@
     "vitest": "^3.2.0"
   },
   "peerDependencies": {
-    "@taladb/web": "0.11.0",
-    "@taladb/node": "0.11.0"
+    "@taladb/web": "0.11.2",
+    "@taladb/node": "0.11.2"
   },
   "peerDependenciesMeta": {
     "@taladb/web": {