@seedprotocol/sdk 0.7.7 → 0.7.8-next.1066.gac32194

package/dist/{index-DpgQMIRq.js → index-CI0NFf4B.js}

@@ -4,7 +4,7 @@ import { easName, DEFAULT_NAME_MATCH_LEVEL, compareNameMatchTiers, isNameMatchLe
 import { waitFor } from 'xstate';
 import pluralize from 'pluralize';
 import { Type } from '@sinclair/typebox';
-import { sqliteTable, integer, text, unique, int, blob, uniqueIndex } from 'drizzle-orm/sqlite-core';
+import { sqliteTable, integer, text, unique, int, blob, uniqueIndex, index } from 'drizzle-orm/sqlite-core';
 import { relations, and, eq, inArray, desc, isNull, isNotNull, or } from 'drizzle-orm';
 import { customAlphabet } from 'nanoid';
 import { alphanumeric } from 'nanoid-dictionary';
@@ -14,6 +14,44 @@ import { sha3_256 } from '@noble/hashes/sha3';
 import { bytesToHex } from '@noble/hashes/utils';
 import { throttle } from 'lodash-es';
 
+const logger$5 = debug('seedSdk:browser:db:sqliteBusyRetry');
+/** Waits between attempts; about 1 s in total. */
+const SQLITE_BUSY_RETRY_DELAYS_MS = [25, 75, 150, 300, 450];
+/**
+ * Another connection (usually another tab) holds the database lock. SQLite reports this as
+ * SQLITE_BUSY ("database is locked") or SQLITE_LOCKED ("database table is locked").
+ */
+function isSqliteBusyError(error) {
+    // Drizzle wraps a driver's error ("Failed query: ...") and keeps it as `cause`
+    for (let current = error, depth = 0; current != null && depth < 5; depth++) {
+        const message = current instanceof Error ? current.message : String(current);
+        if (/SQLITE_BUSY|SQLITE_LOCKED|database (table )?is locked/i.test(message))
+            return true;
+        current = current.cause;
+    }
+    return false;
+}
+/**
+ * Retries a statement another tab's lock rejected. Safe for the SDK's writes because each is a
+ * single autocommit statement: one that failed with SQLITE_BUSY didn't apply. Don't use this for
+ * statements inside a transaction, where a retry would replay part of it.
+ */
+function withSqliteBusyRetry(driver, delaysMs = SQLITE_BUSY_RETRY_DELAYS_MS) {
+    return async (...args) => {
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await driver(...args);
+            }
+            catch (error) {
+                if (!isSqliteBusyError(error) || attempt >= delaysMs.length)
+                    throw error;
+                logger$5(`database busy (attempt ${attempt + 1}); retrying`);
+                await new Promise((resolve) => setTimeout(resolve, delaysMs[attempt]));
+            }
+        }
+    };
+}
+
 class BaseDb {
     static configure(impl) {
         if (!impl) {
@@ -58,6 +96,28 @@ class BaseDb {
     static liveQuery(query) {
         return BaseDb.requireImpl().liveQuery(query);
     }
+    /**
+     * Runs `fn` in one transaction: every query it runs on `tx` (a Drizzle database, used like
+     * `getAppDb()`) commits together, or none does when `fn` throws. Queries on `getAppDb()` inside
+     * `fn` are not part of the transaction, and in the browser they wait for it to end, so don't
+     * call `getAppDb()` or `BaseDb.transaction` from `fn`.
+     *
+     * When another connection (another tab) holds the database lock, the whole transaction is
+     * retried, so `fn` must have no side effects outside `tx`.
+     */
+    static async transaction(fn) {
+        const impl = BaseDb.requireImpl();
+        for (let attempt = 0;; attempt++) {
+            try {
+                return await impl.transaction(fn);
+            }
+            catch (error) {
+                if (!isSqliteBusyError(error) || attempt >= SQLITE_BUSY_RETRY_DELAYS_MS.length)
+                    throw error;
+                await new Promise((resolve) => setTimeout(resolve, SQLITE_BUSY_RETRY_DELAYS_MS[attempt]));
+            }
+        }
+    }
 }
 BaseDb._impl = null;
 
@@ -701,6 +761,21 @@ function getMetadataPropertyNamesForQuery(propertyName, dataType, refValueType)
     }
     return [propertyName];
 }
+/**
+ * The name an item exposes a property under, from the name it is stored under: its alias when it
+ * has one (List of relation), else `tagIds` → `tags`, `authorId` → `author`. Names in
+ * PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP keep their `Id`.
+ */
+function toItemPropertyKey(storedName, alias) {
+    if (alias)
+        return alias;
+    if (storedName.endsWith('Ids'))
+        return pluralize(storedName.slice(0, -3));
+    if (storedName.endsWith('Id') && !PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP.has(storedName)) {
+        return storedName.slice(0, -2);
+    }
+    return storedName;
+}
 /**
  * Schema property name from metadata name (strip Id/Ids suffix).
  */
@@ -1074,6 +1149,49 @@ const htmlEmbeddedImageCoPublish = sqliteTable('html_embedded_image_co_publish',
     uniqueIndex('html_embed_co_pub_parent_html_stable').on(t.parentSeedLocalId, t.htmlSeedLocalId, t.stableKey),
 ]);
 
+/**
+ * The item write outbox (ADR 0019): one row per edit to an item, appended when the value is
+ * assigned and applied to `seeds`, `versions` and `metadata` by the leader tab's drainer.
+ */
+const pendingWrites = sqliteTable('pending_writes', {
+    id: int('id').primaryKey({ autoIncrement: true }),
+    /** Unique per op; the drainer and `save()` refer to an op by it. */
+    opId: text('op_id').notNull(),
+    /** Ops that apply together in one transaction (Item.create's seed, version and metadata rows). */
+    groupId: text('group_id'),
+    seedLocalId: text('seed_local_id').notNull(),
+    /** Null for ops on the seed itself (`create`, `delete`). */
+    propertyName: text('property_name'),
+    /** `create` | `set` | `delete` | `storage` */
+    kind: text('kind').notNull(),
+    /** JSON-encoded value. */
+    value: text('value'),
+    /** A staged file a `storage` op's value was written to, moved into place when it applies. */
+    valueRef: text('value_ref'),
+    /** The stored metadata row the edit was made against, to detect a synced row written since. */
+    baseRowId: text('base_row_id'),
+    baseUid: text('base_uid'),
+    createdAt: int('created_at').notNull(),
+    /** The tab that appended the op. */
+    tabId: text('tab_id'),
+    /** `pending` | `applied` | `superseded` | `failed`. An op is claimed and applied in one transaction. */
+    status: text('status').notNull(),
+    error: text('error'),
+    /** The name of the error that failed the op (`OwnershipError`, say), so a waiter can tell why. */
+    errorName: text('error_name'),
+    attempts: int('attempts').notNull().default(0),
+    appliedAt: int('applied_at'),
+    /** JSON the applier recorded when the op applied (for a `set`: the metadata row written). */
+    result: text('result'),
+    /** JSON: the synced value this op was applied over, when there was one (ADR 0019). */
+    conflict: text('conflict'),
+    conflictResolvedAt: int('conflict_resolved_at'),
+}, (table) => ({
+    opIdUnique: uniqueIndex('pending_writes_op_id_unique').on(table.opId),
+    /** The drainer's order: per property, oldest first, among one status. */
+    drainOrder: index('pending_writes_drain_order').on(table.status, table.seedLocalId, table.propertyName, table.createdAt),
+}));
+
 const seedUidToStorageTransactionId = new Map();
 const getStorageTransactionIdForSeedUid = async (seedUid) => {
     if (seedUidToStorageTransactionId.has(seedUid)) {
@@ -1947,10 +2065,10 @@ const hasStorageSettings = (columns) => columns.storageType != null || columns.l
 /**
  * Resolve property_id (integer properties.id) from a property's schemaFileId (the string `id` in
  * schema files and propertyRecordSchema). Scoped to the model since schemaFileIds are per schema file.
+ * Reads `db` (a transaction's `tx`, say), the app database by default.
  * @returns properties.id or null if not found
  */
-async function getPropertyIdForSchemaFileId(modelNameOrType, schemaFileId, scope = {}) {
-    const db = BaseDb.getAppDb();
+async function getPropertyIdForSchemaFileId(modelNameOrType, schemaFileId, scope = {}, db = BaseDb.getAppDb()) {
     if (!db || !modelNameOrType || !schemaFileId)
         return null;
     const modelRecord = await resolveModelRecordByNameOrType(modelNameOrType, scope, db);
@@ -1969,10 +2087,10 @@ async function getPropertyIdForSchemaFileId(modelNameOrType, schemaFileId, scope
  * @param modelNameOrType - Model name (PascalCase) or model type (snake_case)
  * @param propertyName - Property name as stored in metadata (may have Id/Ids suffix)
  * @param scope - Which model is meant when several schemas define one with this name
+ * @param db - The database or transaction to read; the app database by default
  * @returns properties.id or null if not found
  */
-async function getPropertyIdForModelAndName(modelNameOrType, propertyName, scope = {}) {
-    const db = BaseDb.getAppDb();
+async function getPropertyIdForModelAndName(modelNameOrType, propertyName, scope = {}, db = BaseDb.getAppDb()) {
     if (!db)
         return null;
     if (!modelNameOrType || !propertyName)
@@ -2077,6 +2195,11 @@ async function migrateMetadataForPropertyRename(modelName, oldPropertyName, newP
     if (updatedByFallback > 0) {
         logger$3(`[migrateMetadataForPropertyRename] Fallback updated ${updatedByFallback} rows (propertyId was null)`);
     }
+    // Edits of the property still in the outbox (ADR 0019) apply under its new name
+    await db
+        .update(pendingWrites)
+        .set({ propertyName: newPropertyName })
+        .where(and(eq(pendingWrites.propertyName, oldPropertyName), eq(pendingWrites.status, 'pending'), inArray(pendingWrites.seedLocalId, db.select({ localId: seeds.localId }).from(seeds).where(eq(seeds.type, modelType)))));
     const total = updatedByPropertyId + updatedByFallback;
     if (total > 0) {
         logger$3(`[migrateMetadataForPropertyRename] Migrated ${total} metadata rows for ${modelName}.${oldPropertyName} -> ${newPropertyName}`);
@@ -4318,8 +4441,8 @@ const syncDbFiles = async (_endpoints) => {
 const getAppDbReady = async () => {
     if (!BaseDb.isAppDbReady()) {
         // Wait for ClientManager to be ready (DB_INIT state or later)
-        const _mod_0 = await import('./ClientManager-2GtDWHq6.js');
-        const _ns_0 = _mod_0.O;
+        const _mod_0 = await import('./ClientManager-Dcju5x4k.js');
+        const _ns_0 = _mod_0.$;
         const clientManagerMod = _ns_0;
         const { getClient } = clientManagerMod;
         const clientManager = getClient();
@@ -5015,5 +5138,5 @@ const getArweaveUrlForTransaction = (storageTransactionId) => {
     return BaseArweaveClient.getRawUrl(storageTransactionId);
 };
 
-export { getItemStorageSubdir as $, schemas as A, BaseDb as B, seeds as C, DEFAULT_TEXT_MAX_LENGTH as D, uploadProcesses as E, versions as F, resolveStorageNameToSchemaName as G, AmbiguousModelError as H, eventEmitter as I, nameMatchLevels as J, getPropertyIdForModelAndName as K, resolveItemModelFileId as L, ModelPropertyDataTypes as M, addModelsToDb as N, INIT_SCRIPT_SUCCESS_MESSAGE as O, Property as P, getCorrectId as Q, isPublishedSeedRef as R, SCHEMA_TS as S, THtmlEmbeddedDataUriPolicy as T, normalizeRelationPropertyValue as U, resolveSeedIdsFromRefString as V, getArweaveUrlForTransaction as W, INTERNAL_STORAGE_MODEL_FILE_IDS as X, getStorageDirForDataType as Y, getContentSha256 as Z, buildArweaveContentTags as _, TProperty as a, toSchemaPropertyName as a$, getItemStorageLocalFileName as a0, isNode as a1, ZERO_BYTES32 as a2, resolveModelRecord as a3, getItemModelScope as a4, VERSION_SCHEMA_UID as a5, INTERNAL_PROPERTY_NAMES as a6, isStorageSeedRef as a7, defaultAttestationData as a8, INTERNAL_DATA_TYPES as a9, contentSha256TagMatches as aA, ensureImageLocal as aB, getAddressesForItemsFilter as aC, getFeedItemStringField as aD, normalizeAddressConfig as aE, normalizeAddressList as aF, normalizeArweaveTxIdForEnsure as aG, normalizeFeedItemFields as aH, resolveMediaRef as aI, isInternalSchema as aJ, writeModelToDb as aK, writePropertyToDb as aL, addSchemaToDb as aM, renameModelInDb as aN, currentNameMatchLevels as aO, loadModelsFromDbForSchema as aP, mergeDbModelsIntoSchemaModels as aQ, clearNameMatchLevels as aR, isTestOrSeedDev as aS, downloadAllFilesRequestHandler as aT, downloadAllFilesBinaryRequestHandler as aU, warnOnInvalidNameMatch as aV, INTERNAL_SCHEMA_IDS as aW, linkModelToSchema as aX, getWatchedAddressesFromDb as aY, getOwnedAddressesFromDb as aZ, CLIENT_NOT_INITIALIZED as a_, listRelationEasPropertyName as aa, easPropertyNameForPublish as ab, isBrowser as ac, EAS_SEED_DATA_SYNCED_TO_DB_EVENT as ad, normalizePublisher as ae, getAllAddressesFromDb as af, loadNameMatchLevels as ag, scheduleBulkFilesDownloadFromEasSync as ah, generateId as ai, normalizeHexAddress as aj, toMetadataPropertyName as ak, getItemStoragePropertiesForModel as al, SEED_CONFIG_FILE as am, SEED_CONFIG_FALLBACKS as an, getModelIdByFileId as ao, getModelId as ap, setCachedPropertyRefresher as aq, CONTENT_SHA256_TAG as ar, CONTENT_TYPE_TAG as as, ImageSize as at, SEED_PROTOCOL_SCHEMA_NAME as au, SeedModels as av, VERSION_SCHEMA_DEF as aw, VERSION_SCHEMA_UID_OPTIMISM_SEPOLIA as ax, classifyMediaRef as ay, closestImageSize as az, TPropertyConstructor as b, easSchemaDefinitionForProperty as b0, getStorageTransactionIdForSeedUid as b1, convertTxIdToImage as b2, getMetadataPropertyNamesForQuery as b3, downloadTransactionIdWithDedupe as b4, resolveMetadataRecord as b5, getPropertyIdForSchemaFileId as b6, getDataTypeFromString as b7, getMimeType as b8, listRelationStoragePropertyName as b9, PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP as ba, getAlternatePropertyNameForInstanceLookup as bb, BaseDb$1 as bc, ModelSchema as bd, BaseFileManager$1 as be, SchemaSchema as bf, ModelSchemaSchema as bg, resolveModelRecord$1 as bh, db as bi, download as bj, generateId$1 as bk, TPropertyDataType as c, TPropertyDefs as d, TStorageType as e, TValidationRules as f, normalizePropertyRecordSchema as g, BaseFileManager as h, isDataType as i, appState as j, arweaveL1FinalizeJobs as k, config as l, metadata as m, normalizeDataType as n, easSyncProcesses as o, htmlEmbeddedImageCoPublish as p, modelRelations as q, modelSchemas as r, modelUids as s, models as t, modelsRelations as u, properties as v, propertiesRelations as w, propertyUidRelations as x, propertyUids as y, publishProcesses as z };
-//# sourceMappingURL=index-DpgQMIRq.js.map
+export { buildArweaveContentTags as $, schemas as A, seeds as B, uploadProcesses as C, DEFAULT_TEXT_MAX_LENGTH as D, versions as E, BaseDb as F, resolveStorageNameToSchemaName as G, AmbiguousModelError as H, eventEmitter as I, nameMatchLevels as J, getPropertyIdForModelAndName as K, resolveItemModelFileId as L, ModelPropertyDataTypes as M, BaseFileManager as N, addModelsToDb as O, Property as P, INIT_SCRIPT_SUCCESS_MESSAGE as Q, getCorrectId as R, SCHEMA_TS as S, THtmlEmbeddedDataUriPolicy as T, isPublishedSeedRef as U, normalizeRelationPropertyValue as V, resolveSeedIdsFromRefString as W, getArweaveUrlForTransaction as X, INTERNAL_STORAGE_MODEL_FILE_IDS as Y, getStorageDirForDataType as Z, getContentSha256 as _, TProperty as a, getWatchedAddressesFromDb as a$, getItemStorageSubdir as a0, getItemStorageLocalFileName as a1, isNode as a2, ZERO_BYTES32 as a3, resolveModelRecord as a4, getItemModelScope as a5, VERSION_SCHEMA_UID as a6, INTERNAL_PROPERTY_NAMES as a7, isStorageSeedRef as a8, defaultAttestationData as a9, classifyMediaRef as aA, closestImageSize as aB, contentSha256TagMatches as aC, ensureImageLocal as aD, getAddressesForItemsFilter as aE, getFeedItemStringField as aF, normalizeAddressConfig as aG, normalizeAddressList as aH, normalizeArweaveTxIdForEnsure as aI, normalizeFeedItemFields as aJ, resolveMediaRef as aK, isInternalSchema as aL, writeModelToDb as aM, writePropertyToDb as aN, addSchemaToDb as aO, renameModelInDb as aP, currentNameMatchLevels as aQ, loadModelsFromDbForSchema as aR, mergeDbModelsIntoSchemaModels as aS, clearNameMatchLevels as aT, isTestOrSeedDev as aU, downloadAllFilesRequestHandler as aV, downloadAllFilesBinaryRequestHandler as aW, warnOnInvalidNameMatch as aX, INTERNAL_SCHEMA_IDS as aY, linkModelToSchema as aZ, getMetadataPropertyNamesForQuery as a_, INTERNAL_DATA_TYPES as aa, listRelationEasPropertyName as ab, easPropertyNameForPublish as ac, normalizePublisher as ad, getAllAddressesFromDb as ae, loadNameMatchLevels as af, scheduleBulkFilesDownloadFromEasSync as ag, EAS_SEED_DATA_SYNCED_TO_DB_EVENT as ah, generateId as ai, normalizeHexAddress as aj, toMetadataPropertyName as ak, getItemStoragePropertiesForModel as al, isBrowser as am, getModelIdByFileId as an, getModelId as ao, setCachedPropertyRefresher as ap, withSqliteBusyRetry as aq, SEED_CONFIG_FILE as ar, SEED_CONFIG_FALLBACKS as as, CONTENT_SHA256_TAG as at, CONTENT_TYPE_TAG as au, ImageSize as av, SEED_PROTOCOL_SCHEMA_NAME as aw, SeedModels as ax, VERSION_SCHEMA_DEF as ay, VERSION_SCHEMA_UID_OPTIMISM_SEPOLIA as az, TPropertyConstructor as b, getOwnedAddressesFromDb as b0, CLIENT_NOT_INITIALIZED as b1, toSchemaPropertyName as b2, isSqliteBusyError as b3, easSchemaDefinitionForProperty as b4, getStorageTransactionIdForSeedUid as b5, convertTxIdToImage as b6, getPropertyIdForSchemaFileId as b7, downloadTransactionIdWithDedupe as b8, resolveMetadataRecord as b9, getDataTypeFromString as ba, getMimeType as bb, listRelationStoragePropertyName as bc, PROPERTY_NAMES_EXEMPT_FROM_ID_SUFFIX_STRIP as bd, toItemPropertyKey as be, getAlternatePropertyNameForInstanceLookup as bf, BaseDb$1 as bg, ModelSchema as bh, BaseFileManager$1 as bi, SchemaSchema as bj, ModelSchemaSchema as bk, resolveModelRecord$1 as bl, db as bm, download as bn, generateId$1 as bo, TPropertyDataType as c, TPropertyDefs as d, TStorageType as e, TValidationRules as f, normalizePropertyRecordSchema as g, appState as h, isDataType as i, arweaveL1FinalizeJobs as j, config as k, easSyncProcesses as l, metadata as m, normalizeDataType as n, htmlEmbeddedImageCoPublish as o, modelRelations as p, modelSchemas as q, modelUids as r, models as s, modelsRelations as t, pendingWrites as u, properties as v, propertiesRelations as w, propertyUidRelations as x, propertyUids as y, publishProcesses as z };
+//# sourceMappingURL=index-CI0NFf4B.js.map