@seedprotocol/sdk 0.7.10 → 0.7.11-next.1384.g8b47246

package/dist/{errors-CnT0fSMK.js → errors-DKxFSvb3.js}

@@ -1,11 +1,11 @@
 import { fromCallback, setup, assign, createActor, waitFor, fromPromise } from 'xstate';
-import { ak as isActorStopped, T as applyContextUpdate, U as isInternalUpdate, al as differsFromOriginals, X as isEntityTornDown, am as onEntityTeardown, V as evictionLog, Y as sameEntity, Z as DEFAULT_READY_TIMEOUT_MS, _ as createReactiveProxy, $ as runEntityLoad, a0 as waitForEntityReady, a2 as EntityUnloadedError, a3 as entityStatus, I as Item, a1 as evictEntities, a4 as releaseEntity, a5 as destroyEntity, a8 as modelPropertiesToObject, a6 as EntityCache, aa as easPropertyNameForPublish, af as matchMetadataProperty, aT as getSeedPublisher, ag as metadataRowsOfProperty, ah as METADATA_LATEST_FIRST_ORDER_SQL, aU as deleteStagedFile, aV as storageFileName, aW as STORAGE_SUBDIR, aX as resolveNewSeedFields, aY as lookupPropertySchemaUid, aZ as stageStorageContent, a_ as requireStagedFile, a$ as createSeed, b0 as createMetadata, H as compareMetadataRowsLatestFirst, b1 as storageValueRowOf, t as registerOutboxApplier, r as outboxOpValue, b2 as findSetConflict, b3 as recordPropertyEdit, h as OutboxOpDeferredError, u as startOutbox, i as OutboxOpFailedError, y as OwnershipError, B as isItemOwned, R as getLatestVersionRow, S as parseListPropertyValueFromStorage, au as resolvePublisherFromSeedRow, aE as isLocalUnsealedDraft, b4 as setEntityUnloadGraceMs, b5 as stopOutbox, b6 as evictAllEntities } from './Item-oPnmIehk.js';
+import { aE as isActorStopped, X as applyContextUpdate, Y as isInternalUpdate, aF as differsFromOriginals, bm as writeModelToDb, bn as writePropertyToDb, a0 as isEntityTornDown, aI as onEntityTeardown, Z as evictionLog, a1 as sameEntity, a2 as DEFAULT_READY_TIMEOUT_MS, a3 as createReactiveProxy, a4 as runEntityLoad, a5 as waitForEntityReady, A as AmbiguousModelError, a7 as EntityUnloadedError, a8 as entityStatus, I as Item, a6 as evictEntities, aa as releaseEntity, ab as destroyEntity, bo as currentNameMatchLevels, bp as renameModelInDb, ap as modelPropertiesToObject, af as EntityCache, ac as isClientReady, aV as MachineIds, b8 as normalizeAddressConfig, ao as nameMatchLevels, aj as loadNameMatchLevels, a9 as inDefinitionsTransaction, bq as insertModelStubs, b9 as normalizeAddressList, br as warnOnInvalidNameMatch, ad as upsertSchemaRow, bs as refreshCachedProperties, ar as easPropertyNameForPublish, H as findSeedRow, ag as normalizePublisher, aT as resolvePublisherFromSeedRow, az as matchMetadataProperty, aA as metadataRowsOfProperty, aB as METADATA_LATEST_FIRST_ORDER_SQL, bt as resolveMetadataProperty, as as metadataStorageName, bu as lookupPropertySchemaUid, U as getItemStorageSubdir, ay as getItemStorageLocalFileName, bv as deleteStagedFile, bw as storageFileName, bx as STORAGE_SUBDIR, by as resolveNewSeedFields, bz as stageStorageContent, bA as requireStagedFile, r as registerOutboxApplier, k as outboxOpValue, bB as findSetConflict, bC as recordPropertyEdit, d as OutboxOpDeferredError, bD as startOutbox, e as OutboxOpFailedError, q as OwnershipError, u as isItemOwned, D as compareMetadataRowsLatestFirst, bE as createSeed, bF as storageValueRowOf, P as getLatestVersionRow, S as parseListPropertyValueFromStorage, aU as ClientManagerState, bG as ClientManagerEvents, b5 as isLocalUnsealedDraft, T as writeInBatches, an as selectInBatches, bH as getWatchedAddressesFromDb, bI as getOwnedAddressesFromDb, bJ as setEntityUnloadGraceMs, bK as stopOutbox, bL as evictAllEntities, bM as registerClientActor } from './Item-Ld1iPicQ.js';
 import debug from 'debug';
 import { B as BaseDb, l as properties, d as models$1, j as modelSchemas, t as schemas, f as easSyncProcesses, a as appState, w as BaseFileManager, b as modelUids, s as seeds, v as versions, m as metadata$1, p as pendingWrites, h as htmlEmbeddedImageCoPublish, e as arweaveL1FinalizeJobs, r as publishProcesses } from './BaseFileManager-DLou1TZS.js';
-import { aI as writeModelToDb, aJ as writePropertyToDb, m as generateId, p as isInternalSchema, A as AmbiguousModelError, aK as currentNameMatchLevels, aL as renameModelInDb, s as isClientReady, a as TProperty, ay as withDbTabLock, af as MachineIds, ap as isLeaderTab, aM as postTabMessage, aN as onTabMessage, ax as whenLeaderTab, aO as listenForOtherTabsEvents, F as isBrowser, $ as isNode, aP as startTabCoordination, aq as normalizeAddressConfig, aQ as isTestOrSeedDev, L as nameMatchLevels, C as loadNameMatchLevels, aD as withSeedDbLock, q as inDefinitionsTransaction, aR as insertModelStubs, G as emitAcrossTabs, a8 as ADDRESSES_PERSISTED_EVENT, ar as normalizeAddressList, aS as warnOnInvalidNameMatch, u as upsertSchemaRow, aT as refreshCachedProperties, g as normalizePropertyRecordSchema, M as ModelPropertyDataTypes, j as findSeedRow, aU as tryWithTabLock, Y as getItemStorageSubdir, _ as getItemStorageLocalFileName, aV as notifyFileSaved, ad as ImageSize, n as normalizeDataType, ab as ClientManagerState, aW as ClientManagerEvents, at as parseAddressesPersistedPayload, x as normalizePublisher, w as writeInBatches, K as selectInBatches, ae as LOCAL_COPIES_REMOVED_EVENT, aX as getWatchedAddressesFromDb, aY as getOwnedAddressesFromDb, aZ as CLIENT_NOT_INITIALIZED, a_ as stopTabCoordination, a$ as registerClientActor } from './tabEvents-DT5ez6io.js';
 import { seedGatewayConfigFromSeedConfig, setPreferredArweaveReadBaseUrls, resolveSeedGatewayEndpoints, setResolvedSeedGatewayEndpoints, BaseArweaveClient, ensureReadGatewaySelected, DEFAULT_ARWEAVE_HOST } from '@seedprotocol/arweave';
 import 'pluralize';
 import { localNamesInBestMatchTier, configureEasReadChain, matchEasModelSchemas, whenEasReadChainSettled, getEasReadChainId, DEFAULT_EAS_CHAIN_ID, isEasReadChainConfigured, easName, isValidEasAttestationUid } from '@seedprotocol/eas';
+import { k as generateId, l as isInternalSchema, a as TProperty, N as withDbTabLock, C as isLeaderTab, a0 as postTabMessage, a1 as onTabMessage, K as whenLeaderTab, a2 as listenForOtherTabsEvents, o as isBrowser, u as isNode, a3 as startTabCoordination, W as withSeedDbLock, p as emitAcrossTabs, A as ADDRESSES_PERSISTED_EVENT, g as normalizePropertyRecordSchema, M as ModelPropertyDataTypes, n as normalizeDataType, a4 as tryWithTabLock, a5 as notifyFileSaved, I as ImageSize, G as parseAddressesPersistedPayload, L as LOCAL_COPIES_REMOVED_EVENT, a6 as CLIENT_NOT_INITIALIZED, a7 as stopTabCoordination } from './tabEvents-BnBzIdEi.js';
 import { eq, and, isNull, or, inArray, isNotNull, ne, desc, count, sql, like } from 'drizzle-orm';
 import { Type } from '@sinclair/typebox';
 import { isEqual } from 'lodash-es';
@@ -36,10 +36,10 @@ const validateModel = fromCallback(({ sendBack, input: { context }, self }) => {
     const _validateModel = async () => {
         try {
             // Use dynamic imports to break circular dependencies
-            const validationServiceMod = await import('./SchemaValidationService-CieGrj5c.js');
+            const validationServiceMod = await import('./SchemaValidationService-CW0s7V7R.js');
             const { SchemaValidationService } = validationServiceMod;
             const validationService = new SchemaValidationService();
-            const _mod_0 = await import('./Schema-BMXRF4j9.js');
+            const _mod_0 = await import('./Schema-BzeBUZxi.js');
             const _ns_0 = _mod_0.a;
             const schemaMod = _ns_0;
             const { Schema } = schemaMod;
@@ -320,7 +320,7 @@ async function createModelProperties(model, propertyDefinitions) {
         throw new Error('Model ID, file ID, and name are required to create properties');
     }
     logger$f(`Creating ${Object.keys(propertyDefinitions).length} properties for model "${modelName}" (id: ${_dbId})`);
-    const { ModelProperty } = await import('./ModelProperty-D2vJozmW.js');
+    const { ModelProperty } = await import('./ModelProperty-C8gTx4pO.js');
     const { and, eq } = await import('drizzle-orm');
     const db = BaseDb.getAppDb();
     for (const [propName, propData] of Object.entries(propertyDefinitions)) {
@@ -338,8 +338,8 @@ async function createModelProperties(model, propertyDefinitions) {
             : undefined;
         // Otherwise use provided ID or generate a random one
         // IDs should be generated in the import process before creating properties
-        const _mod_1 = await import('./tabEvents-DT5ez6io.js');
-        const _ns_1 = _mod_1.bl;
+        const _mod_1 = await import('./tabEvents-BnBzIdEi.js');
+        const _ns_1 = _mod_1.ak;
         const { generateId } = _ns_1;
         const propertyFileId = propData.id || propertyRecord?.schemaFileId || generateId();
         logger$f(`Creating property "${propName}" with fileId "${propertyFileId}"`);
@@ -356,8 +356,8 @@ async function createModelProperties(model, propertyDefinitions) {
                 }
                 else if (refModelName) {
                     // Fallback: resolve the ref by name within this model's schema
-                    const _mod_2 = await import('./tabEvents-DT5ez6io.js');
-                    const _ns_2 = _mod_2.bh;
+                    const _mod_2 = await import('./Item-Ld1iPicQ.js');
+                    const _ns_2 = _mod_2.bO;
                     const { resolveModelRecord } = _ns_2;
                     const refModelRecord = await resolveModelRecord(refModelName, { schemaName }, db);
                     if (refModelRecord?.id) {
@@ -452,7 +452,7 @@ const write = async (input) => {
         });
     }
     // Imported here: the validation service imports the Schema barrel, which imports this module's callers
-    const { SchemaValidationService } = await import('./SchemaValidationService-CieGrj5c.js');
+    const { SchemaValidationService } = await import('./SchemaValidationService-CW0s7V7R.js');
     const data = input.data();
     const { errors } = new SchemaValidationService().validatePropertyStructure(data);
     if (errors.length > 0) {
@@ -613,7 +613,7 @@ const createPropertyInstances = async (propertyFileIds, since) => {
         return;
     }
     try {
-        const mod = await import('./ModelProperty-D2vJozmW.js');
+        const mod = await import('./ModelProperty-C8gTx4pO.js');
         const ModelProperty = mod?.ModelProperty ?? mod?.default;
         if (!ModelProperty) {
             logger$d('createPropertyInstances: ModelProperty not available from dynamic import');
@@ -827,7 +827,7 @@ async function loadModel(context, isStopped) {
     // Step 2: Fallback to Schema context (only if database doesn't have the model)
     // This handles the case where model exists in schema file but not yet in database
     try {
-        const _mod_5 = await import('./Schema-BMXRF4j9.js');
+        const _mod_5 = await import('./Schema-BzeBUZxi.js');
         const _ns_5 = _mod_5.a;
         const { Schema } = _ns_5;
         // Stopped meanwhile (unloaded, or evicted with its schema): don't load the schema again
@@ -995,7 +995,7 @@ async function loadModel(context, isStopped) {
     }
     // Mark schema as draft when a new model is created so saveNewVersion() can persist it
     try {
-        const _mod_8 = await import('./Schema-BMXRF4j9.js');
+        const _mod_8 = await import('./Schema-BzeBUZxi.js');
         const _ns_8 = _mod_8.a;
         const { Schema } = _ns_8;
         if (!isStopped()) {
@@ -1089,7 +1089,7 @@ const saveDraftLogger = debug('seedSdk:model:saveDraftToDb');
 // Lazy import cache for ModelProperty to avoid circular dependency
 // Eagerly start loading to minimize delay on first access
 let ModelPropertyClass = null;
-const modelPropertyImportPromise = import('./ModelProperty-D2vJozmW.js')
+const modelPropertyImportPromise = import('./ModelProperty-C8gTx4pO.js')
     .then(module => {
     ModelPropertyClass = module.ModelProperty;
     return ModelPropertyClass;
@@ -1598,8 +1598,8 @@ class Model {
             if (db) {
                 const since = evictionLog.now();
                 try {
-                    const _mod_9 = await import('./tabEvents-DT5ez6io.js');
-                    const _ns_9 = _mod_9.bh;
+                    const _mod_9 = await import('./Item-Ld1iPicQ.js');
+                    const _ns_9 = _mod_9.bO;
                     const { resolveModelRecord, getModelSchemaName } = _ns_9;
                     const resolved = scope.modelFileId
                         ? await resolveModelRecord(undefined, { modelFileId: scope.modelFileId }, db)
@@ -1645,8 +1645,8 @@ class Model {
         }
         const since = options?.since ?? evictionLog.now();
         try {
-            const _mod_10 = await import('./tabEvents-DT5ez6io.js');
-            const _ns_10 = _mod_10.bh;
+            const _mod_10 = await import('./Item-Ld1iPicQ.js');
+            const _ns_10 = _mod_10.bO;
             const { resolveModelRecord, getModelSchemaName } = _ns_10;
             const resolved = await resolveModelRecord(modelName, schemaName ? { schemaName, strict: true } : {}, db);
             if (!resolved?.schemaFileId) {
@@ -2147,8 +2147,8 @@ class Model {
                     if (modelRecord) {
                         const modelId = modelRecord.id;
                         const { detachModelRows } = await import('./detachRowsBeforeDelete-BZr_0iZU.js');
-                        const _mod_11 = await import('./tabEvents-DT5ez6io.js');
-                        const _ns_11 = _mod_11.bj;
+                        const _mod_11 = await import('./Item-Ld1iPicQ.js');
+                        const _ns_11 = _mod_11.bQ;
                         const { inDefinitionsTransaction } = _ns_11;
                         // The model's rows go together or not at all
                         await inDefinitionsTransaction(async (tx) => {
@@ -2164,7 +2164,7 @@ class Model {
                 getModelProperty()?.evictForModel({ modelName, schemaName, modelId: dbId });
                 if (schemaName && modelName) {
                     // Imported here, not at module load: Model and Schema import each other.
-                    const _mod_12 = await import('./Schema-BMXRF4j9.js');
+                    const _mod_12 = await import('./Schema-BzeBUZxi.js');
                     const _ns_12 = _mod_12.a;
                     const { Schema } = _ns_12;
                     const schema = await Schema.find({ schemaName, waitForReady: false });
@@ -2203,8 +2203,8 @@ class Model {
                             return undefined;
                         }
                         // Model names are only unique per schema: find this model's row by its id (schemaFileId).
-                        const _mod_13 = await import('./tabEvents-DT5ez6io.js');
-                        const _ns_13 = _mod_13.bh;
+                        const _mod_13 = await import('./Item-Ld1iPicQ.js');
+                        const _ns_13 = _mod_13.bO;
                         const { resolveModelRecord } = _ns_13;
                         const modelRecord = await resolveModelRecord(modelName, { modelFileId: context.id, schemaName: context.schemaName }, db);
                         if (!modelRecord?.id) {
@@ -2382,7 +2382,6 @@ var Model$1 = /*#__PURE__*/Object.freeze({
 });
 
 // Export the Model class
-const TModelValues = Type.Record(Type.String(), Type.Any());
 const TModelSchema = Type.Record(Type.String(), TProperty);
 
 let writeTail = Promise.resolve();
@@ -2585,7 +2584,7 @@ function toRunSyncArg(options) {
     return undefined;
 }
 const runEasSync = fromPromise(async ({ input, }) => {
-    const { runSyncFromEas } = await import('./syncDbWithEas-FuyqoEKk.js');
+    const { runSyncFromEas } = await import('./syncDbWithEas-Dj_8VqM7.js');
     // Sync checks for rows and then inserts the rest (no unique index on uids), so syncs in
     // different tabs take turns. A sync can run for minutes, so wait without a timeout.
     await withDbTabLock('eas-sync', async () => {
@@ -3000,11 +2999,6 @@ const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
         try {
             const appDb = BaseDb.getAppDb();
             if (!appDb) {
-                // In test environments, continue anyway
-                if (isTestOrSeedDev()) {
-                    logger$a('[client/actors] [saveAppState] App DB not found, but continuing in test environment');
-                    return;
-                }
                 throw new Error('App DB not found');
             }
             const result = await appDb.insert(appState)
@@ -3022,11 +3016,6 @@ const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
         }
         catch (error) {
             logger$a('[client/actors] [saveAppState] Error saving app state:', error);
-            // In test environments, continue anyway
-            if (isTestOrSeedDev()) {
-                logger$a('[client/actors] [saveAppState] Continuing despite error in test environment');
-                return;
-            }
             throw error;
         }
     };
@@ -3040,23 +3029,12 @@ const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
     })
         .catch((error) => {
         logger$a('[client/actors] [saveAppState] Error in promise chain:', error);
-        // In test environments, still send success to allow state machine to progress
-        if (isTestOrSeedDev()) {
-            logger$a('[client/actors] [saveAppState] Sending success despite error in test environment');
-            sendBack({
-                type: 'saveAppStateSuccess',
-                key,
-                value,
-            });
-        }
-        else {
-            sendBack({
-                type: 'saveAppStateError',
-                error: error instanceof Error ? error : new Error(String(error)),
-                key,
-                value,
-            });
-        }
+        sendBack({
+            type: 'saveAppStateError',
+            error: error instanceof Error ? error : new Error(String(error)),
+            key,
+            value,
+        });
     });
 });
 
@@ -3205,7 +3183,7 @@ async function addModelsToDb(context) {
                     timeout = setTimeout(() => reject(new Error('EAS query timeout after 10 seconds')), 10000);
                 });
                 // The lookup and the model_uids rule sync uses too (each name at its nameMatch level).
-                const { getModelSchemasFromEas } = await import('./eas-FZPPqxqe.js');
+                const { getModelSchemasFromEas } = await import('./eas-CdhfODXL.js');
                 const lookups = await localModelSchemaLookups([...modelNamesWithRows]);
                 // Cleared, so a finished lookup doesn't keep a Node process alive for 10 s.
                 const schemas = await Promise.race([getModelSchemasFromEas(lookups), timeoutPromise]).finally(() => clearTimeout(timeout));
@@ -3221,12 +3199,7 @@ async function addModelsToDb(context) {
                 }
             }
             catch (error) {
-                if (isTestOrSeedDev()) {
-                    logger$8('[client/actors] [addModelsToDb] Warning: Could not fetch schemas from EAS (background):', error.message);
-                }
-                else {
-                    logger$8('[client/actors] [addModelsToDb] Error fetching schemas (background):', error.message);
-                }
+                logger$8('[client/actors] [addModelsToDb] Error fetching schemas (background):', error.message);
                 // Probably offline: the startup sync waits for this lookup, so try again.
                 modelUidsRetry.schedule();
             }
@@ -3245,9 +3218,7 @@ async function addModelsToDb(context) {
     }
     catch (error) {
         logger$8('[client/actors] [addModelsToDb] Error:', error);
-        // In test environments, initialization completes anyway
-        if (!isTestOrSeedDev())
-            throw error;
+        throw error;
     }
 }
 
@@ -3426,11 +3397,6 @@ async function saveConfig(context) {
         try {
             const appDb = BaseDb.getAppDb();
             if (!appDb) {
-                // In test environments, continue anyway
-                if (isTestOrSeedDev()) {
-                    logger$6('[internal/actors] [saveConfig] App DB not found, but continuing in test environment');
-                    return;
-                }
                 throw new Error('App DB not found');
             }
             const endpointsValueString = JSON.stringify(endpoints);
@@ -3484,11 +3450,6 @@ async function saveConfig(context) {
         }
         catch (error) {
             logger$6('[internal/actors] [saveConfig] Error saving config:', error);
-            // In test environments, continue anyway
-            if (isTestOrSeedDev()) {
-                logger$6('[internal/actors] [saveConfig] Continuing despite error in test environment');
-                return;
-            }
             throw error;
         }
     };
@@ -3920,8 +3881,8 @@ async function applySchemaFile(source, options = {}) {
     if (!schemaRecord) {
         warnOnEasNameCollisions(file);
         warnOnInvalidNameMatch(file);
-        const _mod_14 = await import('./tabEvents-DT5ez6io.js');
-        const _ns_14 = _mod_14.bk;
+        const _mod_14 = await import('./Item-Ld1iPicQ.js');
+        const _ns_14 = _mod_14.bR;
         const { addModelsToDb, broadcastSchemasInvalidate } = _ns_14;
         const modelFileIds = new Map(Object.entries(file.models).map(([name, model]) => [name, model.id]));
         const propertyDefinitions = schemaFilePropertyDefinitions(file);
@@ -4072,8 +4033,8 @@ async function resolveSchemaRow(row, db = BaseDb.getAppDb()) {
         metadata: { ...schema.metadata, name: row.name },
     };
     if (row.id && db) {
-        const _mod_15 = await import('./tabEvents-DT5ez6io.js');
-        const _ns_15 = _mod_15.bk;
+        const _mod_15 = await import('./Item-Ld1iPicQ.js');
+        const _ns_15 = _mod_15.bR;
         const { loadModelsFromDbForSchema, mergeDbModelsIntoSchemaModels } = _ns_15;
         const dbModels = await loadModelsFromDbForSchema(row.id, db);
         if (Object.keys(dbModels).length > 0) {
@@ -4679,6 +4640,22 @@ const getVersionData = async ({ localId, seedLocalId, uid, }, db = BaseDb.getApp
     return queryRows[0];
 };
 
+/**
+ * The publisher a seed's version and property rows take: the seed's own (its `publisher`, else the
+ * attester of its stored attestation). Undefined for a draft that belongs to no wallet yet; those
+ * rows are then claimed together with their seed (claimUnpublishedDrafts).
+ */
+async function getSeedPublisher(seedLocalId, 
+/** The database or transaction to read; the app database by default. */
+db = BaseDb.getAppDb()) {
+    if (!seedLocalId)
+        return undefined;
+    const row = await findSeedRow({ localId: seedLocalId }, db);
+    if (!row)
+        return undefined;
+    return normalizePublisher(resolvePublisherFromSeedRow(row));
+}
+
 const logger$1 = debug('seedSdk:write:updateItemPropertyValue');
 const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, newValue, seedUid, seedLocalId, modelName, refSeedType, refResolvedValue, refResolvedDisplayValue, versionLocalId, versionUid, schemaUid, localStorageDir, dataType, refValueType, retract, }, options = {}) => {
     if (!localIdParam && !seedLocalId) {
@@ -4739,7 +4716,9 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
             rows = newestRows.slice(0, 1);
     }
     if (rows && rows.length > 0) {
-        const { localId, uid, propertyId: propertyIdFromDb, propertyName: propertyNameFromDb, propertyValue: propertyValueFromDb, modelType, seedLocalId: seedLocalIdFromDb, versionLocalId, schemaUid, easDataType, refSeedType: refSeedTypeFromDb, refResolvedValue: refResolvedValueFromDb, retract: retractFromDb, } = rows[0];
+        const { localId, uid, propertyId: propertyIdFromDb, propertyName: propertyNameFromDb, propertyValue: propertyValueFromDb, modelType, seedLocalId: seedLocalIdFromDb, versionLocalId, schemaUid: schemaUidFromDb, easDataType, refSeedType: refSeedTypeFromDb, refResolvedValue: refResolvedValueFromDb, retract: retractFromDb, } = rows[0];
+        // The resolved schema uid fills in a row stored before its schema was known.
+        const rowSchemaUid = schemaUidFromDb || schemaUid;
         // Stored model types are the model's EAS name (ADR 0008): `blog_post` for BlogPost.
         const modelTypeForName = modelName ? easName(modelName) : undefined;
         if (propertyValueFromDb === newValue &&
@@ -4749,7 +4728,7 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
             (refResolvedValueFromDb ?? null) === (refResolvedValue ?? null) &&
             !!retractFromDb === !!retractValue) {
             logger$1(`[db/write] [updateItemPropertyValue] value is the same as most recent record for property: ${propertyNameFromDb}`);
-            return localId == null ? undefined : { localId, uid: uid ?? null, schemaUid: schemaUid ?? '' };
+            return localId == null ? undefined : { localId, uid: uid ?? null, schemaUid: schemaUidFromDb ?? '' };
         }
         // This means we already have a local-only record so we should just update that one
         if (!uid) {
@@ -4774,11 +4753,14 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
             if (propertyIdFromDb == null && property.propertyId != null) {
                 updatePayload.propertyId = property.propertyId;
             }
+            if (!schemaUidFromDb && schemaUid) {
+                updatePayload.schemaUid = schemaUid;
+            }
             await appDb
                 .update(metadata$1)
                 .set(updatePayload)
                 .where(eq(metadata$1.localId, localId));
-            return { localId, uid: null, schemaUid: schemaUid ?? '' };
+            return { localId, uid: null, schemaUid: rowSchemaUid ?? '' };
         }
         const seedDataFromDb = seedLocalId ? await findSeedRow({ localId: seedLocalId }, appDb) : null;
         const versionDataFromDb = versionLocalId ? await getVersionData({ localId: versionLocalId }, appDb) : null;
@@ -4798,7 +4780,7 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
             seedLocalId: seedLocalIdFromDb,
             versionLocalId,
             versionUid: versionDataFromDb?.uid || null,
-            schemaUid,
+            schemaUid: rowSchemaUid,
             easDataType: easDataType || null,
             refSeedType: refSeedType || null,
             refResolvedValue: refResolvedValue || null,
@@ -4809,7 +4791,7 @@ const updateItemPropertyValue = async ({ localId: localIdParam, propertyName, ne
         return {
             localId: newLocalId,
             uid: null,
-            schemaUid: schemaUid ?? '',
+            schemaUid: rowSchemaUid ?? '',
         };
     }
     // Here there are no records for this property on this seed so we should create one
@@ -4868,6 +4850,116 @@ const createVersion = async ({ seedLocalId, seedUid, seedType, uid, }, options =
     return newVersionLocalId;
 };
 
+/** Error thrown when metadata validation fails (e.g. enum violation). */
+class MetadataValidationError extends Error {
+    constructor(message, validationErrors) {
+        super(message);
+        this.validationErrors = validationErrors;
+        this.name = 'MetadataValidationError';
+    }
+}
+const createMetadata = async (metadataValues, propertyRecordSchema, options) => {
+    const appDb = options?.db ?? BaseDb.getAppDb();
+    metadataValues.localId = generateId();
+    // A property row belongs to its seed's wallet (none yet for a draft made with no wallet connected).
+    const publisher = await getSeedPublisher(metadataValues.seedLocalId, appDb);
+    if (publisher) {
+        metadataValues.publisher = publisher;
+    }
+    if (!metadataValues.modelType && metadataValues.modelName) {
+        metadataValues.modelType = easName(metadataValues.modelName);
+    }
+    // property_id is the match key (decision D4); the row is written under the property's storage name.
+    const property = await resolveMetadataProperty({
+        propertyId: metadataValues.propertyId,
+        definitionId: propertyRecordSchema?.id,
+        propertyName: metadataValues.propertyName,
+        modelName: metadataValues.modelName ?? metadataValues.modelType,
+        modelFileId: options?.modelFileId,
+        seedLocalId: metadataValues.seedLocalId,
+        seedUid: metadataValues.seedUid,
+    }, appDb, { onAmbiguousModel: 'none' });
+    if (property) {
+        metadataValues.propertyId = property.id;
+        metadataValues.propertyName = property.storageName;
+    }
+    else if (metadataValues.propertyName && propertyRecordSchema) {
+        metadataValues.propertyName = metadataStorageName(metadataValues.propertyName, propertyRecordSchema);
+    }
+    const isItemStorage = propertyRecordSchema && propertyRecordSchema.storageType === 'ItemStorage';
+    // if (
+    //   propertyRecordSchema &&
+    //   propertyRecordSchema.localStorageDir &&
+    //   isItemStorage
+    // ) {
+    //   const filename = `${metadataValues.seedUid || metadataValues.seedLocalId}${propertyRecordSchema.filenameSuffix}`
+    //   const filePath = path.join(propertyRecordSchema.localStorageDir, filename)
+    //   await fs.promises.writeFile(filePath, metadataValues.propertyValue)
+    //   metadataValues.propertyValue = filename
+    //   metadataValues.refValueType = 'file'
+    // }
+    // Convert propertyValue to string if it's not already (metadata table expects text)
+    if (metadataValues.propertyValue !== undefined && metadataValues.propertyValue !== null) {
+        if (Array.isArray(metadataValues.propertyValue)) {
+            // List values: JSON array is the storage format (String() would give legacy comma-separated ids)
+            metadataValues.propertyValue = JSON.stringify(metadataValues.propertyValue);
+        }
+        else if (typeof metadataValues.propertyValue !== 'string') {
+            metadataValues.propertyValue = String(metadataValues.propertyValue);
+        }
+    }
+    // Validate against property validation rules (enum, pattern, minLength, maxLength) unless skipped
+    if (!options?.skipValidation &&
+        propertyRecordSchema?.validation &&
+        metadataValues.propertyValue != null &&
+        metadataValues.propertyValue !== '') {
+        const { SchemaValidationService } = await import('./SchemaValidationService-CW0s7V7R.js');
+        const validationService = new SchemaValidationService();
+        const validationResult = validationService.validatePropertyValue(metadataValues.propertyValue, normalizeDataType(propertyRecordSchema.dataType), propertyRecordSchema.validation, propertyRecordSchema.refValueType
+            ? normalizeDataType(String(propertyRecordSchema.refValueType))
+            : undefined);
+        if (!validationResult.isValid && validationResult.errors.length > 0) {
+            const validationErrors = validationResult.errors.map((e) => ({
+                field: e.field,
+                message: e.message,
+                code: e.code,
+            }));
+            const message = validationErrors.map((e) => e.message).join('; ');
+            throw new MetadataValidationError(message, validationErrors);
+        }
+    }
+    // With a given db (a transaction), the caller resolves schemaUid first: the lookup may call EAS.
+    // Without one it isn't required for metadata insertion, so a failed lookup leaves it unset.
+    if (!options?.db && !isItemStorage && !metadataValues.schemaUid && metadataValues.propertyName) {
+        const schemaUid = await lookupPropertySchemaUid(metadataValues.propertyName, propertyRecordSchema);
+        if (schemaUid)
+            metadataValues.schemaUid = schemaUid;
+    }
+    let inserted;
+    try {
+        inserted = await appDb
+            .insert(metadata$1)
+            .values({
+            ...metadataValues,
+            // Stamped here: a value carried in metadataValues would otherwise win over the column default.
+            createdAt: Date.now(),
+            updatedAt: Date.now(),
+        })
+            .returning();
+    }
+    catch (error) {
+        // Drizzle's message is the full SQL; the driver error that explains it is only on `cause`.
+        const cause = error?.cause;
+        const reason = cause instanceof Error ? cause.message : cause != null ? String(cause) : undefined;
+        throw new Error(`Failed to insert metadata for property ${metadataValues.propertyName}` +
+            (reason ? `: ${reason}` : `: ${error instanceof Error ? error.message : String(error)}`), { cause: error });
+    }
+    if (!inserted || inserted.length === 0) {
+        throw new Error(`Failed to insert metadata record for property ${metadataValues.propertyName}`);
+    }
+    return inserted[0];
+};
+
 /** Absolute path of the file {@link writeItemStorageFile} writes for `target`. */
 const getItemStorageFilePath = (target) => BaseFileManager.getFilesPath(getItemStorageSubdir(target.localStorageDir), target.fileName || getItemStorageLocalFileName(target.seedId, target.filenameSuffix));
 /**
@@ -5008,8 +5100,8 @@ async function applyStorageValue(seedLocalId, propertyName, value, db, prepared)
     const row = prepared
         ? { ...stored, refResolvedValue: prepared.fileName, schemaUid: prepared.schemaUid, refModelUid: prepared.refModelUid }
         : stored;
-    const _mod_16 = await import('./Item-oPnmIehk.js');
-    const _ns_16 = _mod_16.b7;
+    const _mod_16 = await import('./Item-Ld1iPicQ.js');
+    const _ns_16 = _mod_16.bS;
     const { currentPropertyRow } = _ns_16;
     const existing = await currentPropertyRow({ seedLocalId }, {
         propertyName,
@@ -5322,8 +5414,8 @@ function startItemOutbox() {
                     return {};
                 // Cached, shared with item creation, so a save doesn't wait on the EAS indexer each time.
                 // Not required for the row; publish resolves the schema again.
-                const _mod_17 = await import('./Item-oPnmIehk.js');
-                const _ns_17 = _mod_17.ba;
+                const _mod_17 = await import('./Item-Ld1iPicQ.js');
+                const _ns_17 = _mod_17.bT;
                 const { lookupPropertySchemaUid } = _ns_17;
                 return {
                     schemaUid: await lookupPropertySchemaUid(op.propertyName, value.propertyRecordSchema),
@@ -6634,5 +6726,5 @@ var errors = /*#__PURE__*/Object.freeze({
     UnknownModelError: UnknownModelError
 });
 
-export { sendEasSyncClientRequest as $, waitForEasReadChain as A, assertLocalDbChain as B, ConflictError as C, writeModelUids as D, getContentHash as E, saveDefinition as F, EAS_CHAIN_ID_APP_STATE_KEY as G, INIT_CONFIG_CONFLICT_MESSAGE as H, ItemCreateValidationError as I, ItemCreateError as J, claimUnpublishedDrafts as K, createLocalQueryDataSource as L, Model as M, easSyncActor as N, getClient as O, getPublishedSeedRecord as P, getSchemaNameFromId as Q, RelationTargetError as R, SCHEMA_FILE_FORMAT as S, TModelSchema as T, UnknownModelError as U, isSeedQueryLocalSourceRegistered as V, listCompleteSchemaFiles as W, mergeEasSyncRequestIntents as X, registerSeedQueryLocalSource as Y, requestEasSyncFromAddressChange as Z, requestEasSyncFromModelsInit as _, applyCreateItem as a, setRetriesWhenOnlineEnabled as a0, startEasSyncActor as a1, unregisterSeedQueryLocalSource as a2, saveDefinition$1 as a3, Model$1 as a4, schema as a5, SEEDPROTOCOL_Seed_Protocol_v1 as a6, itemAppliers as a7, errors as a8, applyDelete as b, applyItemStorageValue as c, deleteFiles as d, applyStorageValue as e, TModelValues as f, ClientManager as g, syncSchemaFromSource as h, importJsonSchema as i, transformImportToSchemaFile as j, localModelSchemaLookups as k, loadSchemaFromFile as l, listLatestSchemaFiles as m, readSchemaFile as n, applySchemaFile as o, resolveSchemaRow as p, loadAllSchemasFromDb as q, readJsonImportFile as r, startItemOutbox as s, throwItemWriteError as t, getDraftSaveError as u, queueDraftSave as v, writeNextSchemaVersion as w, setupEntityLiveQuery as x, mergeSchemaFiles as y, trackDraftSave as z };
-//# sourceMappingURL=errors-CnT0fSMK.js.map
+export { schema as $, INIT_CONFIG_CONFLICT_MESSAGE as A, ItemCreateError as B, ConflictError as C, claimUnpublishedDrafts as D, EAS_CHAIN_ID_APP_STATE_KEY as E, createLocalQueryDataSource as F, easSyncActor as G, getClient as H, ItemCreateValidationError as I, getPublishedSeedRecord as J, getSchemaNameFromId as K, isSeedQueryLocalSourceRegistered as L, Model as M, listCompleteSchemaFiles as N, mergeEasSyncRequestIntents as O, registerSeedQueryLocalSource as P, requestEasSyncFromAddressChange as Q, requestEasSyncFromModelsInit as R, SCHEMA_FILE_FORMAT as S, TModelSchema as T, UnknownModelError as U, sendEasSyncClientRequest as V, setRetriesWhenOnlineEnabled as W, startEasSyncActor as X, unregisterSeedQueryLocalSource as Y, saveDefinition$1 as Z, Model$1 as _, ClientManager as a, SEEDPROTOCOL_Seed_Protocol_v1 as a0, itemAppliers as a1, errors as a2, syncSchemaFromSource as b, transformImportToSchemaFile as c, deleteFiles as d, localModelSchemaLookups as e, listLatestSchemaFiles as f, readSchemaFile as g, applySchemaFile as h, importJsonSchema as i, resolveSchemaRow as j, loadAllSchemasFromDb as k, loadSchemaFromFile as l, getDraftSaveError as m, setupEntityLiveQuery as n, mergeSchemaFiles as o, trackDraftSave as p, queueDraftSave as q, readJsonImportFile as r, startItemOutbox as s, throwItemWriteError as t, waitForEasReadChain as u, assertLocalDbChain as v, writeNextSchemaVersion as w, writeModelUids as x, getContentHash as y, saveDefinition as z };
+//# sourceMappingURL=errors-DKxFSvb3.js.map