@seedprotocol/sdk 0.7.3-next.613.g79a8dfd → 0.7.3-next.654.g52217f6

package/dist/{ClientManager-DDA9956Y.js → ClientManager-C-QXqUK9.js}

@@ -1,15 +1,15 @@
 import debug from 'debug';
 import { createActor, setup, assign, fromPromise, fromCallback, waitFor } from 'xstate';
-import { m as eventEmitter, C as normalizeAddressConfig, E as normalizeAddressList, S as loadModelsFromDbForSchema, O as addSchemaToDb, n as normalizeDataType, U as linkModelToSchema, s as normalizePublisher, V as getWatchedAddressesFromDb, W as getOwnedAddressesFromDb } from './db-CQt-gcAl.js';
-import { u as MachineIds, V as ClientManagerEvents, C as ClientManagerState, W as resolvePublisherFromSeedRow, F as isLocalUnsealedDraft, I as Item } from './Item-D4FigtYS.js';
-import { a as BaseDb, e as easSyncProcesses, t as BasePathResolver, b as appState, B as BaseFileManager, j as models$1, i as modelUids, r as seeds, s as schemas, K as isInternalSchema, L as INTERNAL_SCHEMA_IDS, F as SEED_PROTOCOL_SCHEMA_NAME, g as modelSchemas, m as metadata$1, v as versions, h as htmlEmbeddedImageCoPublish, c as arweaveL1FinalizeJobs, q as publishProcesses, M as CLIENT_NOT_INITIALIZED } from './BasePathResolver-BdxCSIzn.js';
-import { eq, inArray, and, isNotNull, ne, desc, countDistinct, like, or, isNull } from 'drizzle-orm';
-import { q as withDbTabLock, k as isLeaderTab, x as postTabMessage, y as onTabMessage, w as whenLeaderTab, z as listenForOtherTabsEvents, B as isNode, C as isBrowser, D as startTabCoordination, E as downloadAllFilesRequestHandler, G as downloadAllFilesBinaryRequestHandler, t as toSnakeCase, v as withSeedDbLock, b as generateId, p as parseAddressesPersistedPayload, e as emitAcrossTabs, A as ADDRESSES_PERSISTED_EVENT, L as LOCAL_COPIES_REMOVED_EVENT } from './tabEvents-BZJMY5uK.js';
+import { m as eventEmitter, C as normalizeAddressConfig, E as normalizeAddressList, S as loadModelsFromDbForSchema, O as addSchemaToDb, n as normalizeDataType, U as linkModelToSchema, r as resolveItemModelFileId, s as normalizePublisher, V as getWatchedAddressesFromDb, W as getOwnedAddressesFromDb } from './db-D9K_f5cF.js';
+import { u as MachineIds, Y as ClientManagerEvents, Z as withLockedItemStorageRow, _ as getItemStorageFilePath, $ as writeItemStorageFile, c as compareMetadataRowsLatestFirst, C as ClientManagerState, a0 as resolvePublisherFromSeedRow, F as isLocalUnsealedDraft, I as Item } from './Item-C7sUUu2B.js';
+import { B as BaseDb, e as easSyncProcesses, r as BasePathResolver, a as appState, t as BaseFileManager, i as models$1, g as modelUids, q as seeds, s as schemas, K as isInternalSchema, L as INTERNAL_SCHEMA_IDS, F as SEED_PROTOCOL_SCHEMA_NAME, f as modelSchemas, m as metadata$1, p as properties, v as versions, h as htmlEmbeddedImageCoPublish, b as arweaveL1FinalizeJobs, o as publishProcesses, M as CLIENT_NOT_INITIALIZED } from './BasePathResolver-CfSfMW5_.js';
+import { eq, inArray, and, isNotNull, ne, desc, countDistinct, isNull, or, like } from 'drizzle-orm';
+import { D as withDbTabLock, v as isLeaderTab, H as postTabMessage, I as onTabMessage, B as whenLeaderTab, J as listenForOtherTabsEvents, K as isNode, M as isBrowser, N as startTabCoordination, O as downloadAllFilesRequestHandler, P as downloadAllFilesBinaryRequestHandler, t as toSnakeCase, G as withSeedDbLock, j as generateId, y as parseAddressesPersistedPayload, h as emitAcrossTabs, A as ADDRESSES_PERSISTED_EVENT, L as LOCAL_COPIES_REMOVED_EVENT } from './tabEvents-DguZpCCv.js';
 import { seedGatewayConfigFromSeedConfig, setPreferredArweaveReadBaseUrls, resolveSeedGatewayEndpoints, setResolvedSeedGatewayEndpoints, BaseArweaveClient, ensureReadGatewaySelected, DEFAULT_ARWEAVE_HOST } from '@seedprotocol/arweave';
 import { configureEasReadChain, BaseQueryClient, BaseEasClient, GET_SCHEMAS, whenEasReadChainSettled, getEasReadChainId, DEFAULT_EAS_CHAIN_ID, isEasReadChainConfigured, isValidEasAttestationUid } from '@seedprotocol/eas';
 import 'pluralize';
 import { sha3_256 } from '@noble/hashes/sha3';
-import { bytesToHex, utf8ToBytes } from '@noble/hashes/utils';
+import { utf8ToBytes, bytesToHex } from '@noble/hashes/utils';
 import { clearLocalQuerySource, registerLocalQuerySource, getSeed } from '@seedprotocol/query';
 import { startCase } from 'lodash-es';
 
@@ -109,7 +109,7 @@ const runEasSync = fromPromise(async ({ input, }) => {
         requestPayload: input.requestPayload,
         persistedSnapshot: input.runningSnapshot,
     });
-    const { runSyncFromEas } = await import('./syncDbWithEas-BU-jZ5bJ.js');
+    const { runSyncFromEas } = await import('./syncDbWithEas--HUA9WNb.js');
     try {
         // 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.
@@ -285,7 +285,7 @@ function newCorrelationId() {
     return `${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
 /** Requests deferred in this tab until it leads, by source; each runs once on takeover. */
-const deferredUntilLeader = new Set();
+const deferredUntilLeader$1 = new Set();
 /**
  * Automatic syncs run in the leader tab only (docs/MULTI_TAB.md). A tab that skips one runs it if
  * it later becomes leader, so closing the leader doesn't lose the catch-up sync.
@@ -296,11 +296,11 @@ function runInLeaderTab(source, request) {
         return;
     }
     log(`${source} sync skipped: another tab leads`);
-    if (deferredUntilLeader.has(source))
+    if (deferredUntilLeader$1.has(source))
         return;
-    deferredUntilLeader.add(source);
+    deferredUntilLeader$1.add(source);
     void whenLeaderTab().then(() => {
-        deferredUntilLeader.delete(source);
+        deferredUntilLeader$1.delete(source);
         request();
     });
 }
@@ -374,10 +374,10 @@ var easSyncManager = /*#__PURE__*/Object.freeze({
     startEasSyncActor: startEasSyncActor
 });
 
-const logger$b = debug('seedSdk:services:events');
+const logger$c = debug('seedSdk:services:events');
 const handleServiceSaveState = (event) => {
     const { state, serviceId } = event;
-    logger$b(`[browser] [service.saveState.request] serviceId: ${serviceId}`);
+    logger$c(`[browser] [service.saveState.request] serviceId: ${serviceId}`);
     // TODO: This is called from Node as well. Do we need it? If so, need to generalize this to all platforms.
     // localStorage.setItem(`seed_sdk_service_${serviceId}`, JSON.stringify(state))
 };
@@ -428,9 +428,9 @@ function normalizeSeedConfigEndpoints(config) {
     return { ...config, endpoints: next };
 }
 
-const logger$a = debug('seedSdk:ClientManager:initialize');
+const logger$b = debug('seedSdk:ClientManager:initialize');
 const platformClassesInit = fromCallback(({ sendBack, input: { context, event } }) => {
-    logger$a('initialize from ClientManager');
+    logger$b('initialize from ClientManager');
     const { isInitialized } = context;
     if (!event || !('options' in event)) {
         throw new Error('Initialize event must include options');
@@ -463,7 +463,7 @@ const platformClassesInit = fromCallback(({ sendBack, input: { context, event }
         }
         // Prefer the condition-resolved factory when available; fall back to explicit
         // platform imports so source/vitest resolution stays reliable.
-        const { configurePlatform } = await import('./configurePlatform-YcOiDQBZ.js');
+        const { configurePlatform } = await import('./configurePlatform-BRw2j0ZN.js');
         if (isBrowser()) {
             const { createPlatformServices } = await import('./platform.browser.js');
             configurePlatform(createPlatformServices());
@@ -602,7 +602,7 @@ const platformClassesInit = fromCallback(({ sendBack, input: { context, event }
     };
 });
 
-const logger$9 = debug('seedSdk:client:writeToDb');
+const logger$a = debug('seedSdk:client:writeToDb');
 const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
     const _saveAppState = async () => {
         try {
@@ -610,7 +610,7 @@ const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
             if (!appDb) {
                 // In test environments, continue anyway
                 if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-                    logger$9('[client/actors] [saveAppState] App DB not found, but continuing in test environment');
+                    logger$a('[client/actors] [saveAppState] App DB not found, but continuing in test environment');
                     return;
                 }
                 throw new Error('App DB not found');
@@ -626,13 +626,13 @@ const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
                     value: JSON.stringify(value),
                 },
             });
-            logger$9('result', result);
+            logger$a('result', result);
         }
         catch (error) {
-            logger$9('[client/actors] [saveAppState] Error saving app state:', error);
+            logger$a('[client/actors] [saveAppState] Error saving app state:', error);
             // In test environments, continue anyway
             if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-                logger$9('[client/actors] [saveAppState] Continuing despite error in test environment');
+                logger$a('[client/actors] [saveAppState] Continuing despite error in test environment');
                 return;
             }
             throw error;
@@ -647,10 +647,10 @@ const saveAppState = fromCallback(({ sendBack, input: { key, value } }) => {
         });
     })
         .catch((error) => {
-        logger$9('[client/actors] [saveAppState] Error in promise chain:', error);
+        logger$a('[client/actors] [saveAppState] Error in promise chain:', error);
         // In test environments, still send success to allow state machine to progress
         if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-            logger$9('[client/actors] [saveAppState] Sending success despite error in test environment');
+            logger$a('[client/actors] [saveAppState] Sending success despite error in test environment');
             sendBack({
                 type: 'saveAppStateSuccess',
                 key,
@@ -720,7 +720,7 @@ const fileSystemInit = fromCallback(({ sendBack, input: { context }, }) => {
     };
 });
 
-const logger$8 = debug('seedSdk:client:actors:dbInit');
+const logger$9 = debug('seedSdk:client:actors:dbInit');
 const dbInit = fromCallback(({ sendBack, input: { context } }) => {
     const _dbInit = async () => {
         const { filesDir } = context;
@@ -734,14 +734,14 @@ const dbInit = fromCallback(({ sendBack, input: { context } }) => {
         if (!appDb) {
             throw new Error('Database not available after preparation');
         }
-        logger$8('[client/actors] [dbInit] Database prepared and ready');
+        logger$9('[client/actors] [dbInit] Database prepared and ready');
     };
     _dbInit()
         .then(() => {
         sendBack({ type: ClientManagerEvents.DB_READY });
     })
         .catch((error) => {
-        logger$8('Error in dbInit:', error);
+        logger$9('Error in dbInit:', error);
         sendBack({
             type: 'error',
             error: error instanceof Error ? error : new Error(String(error))
@@ -749,7 +749,7 @@ const dbInit = fromCallback(({ sendBack, input: { context } }) => {
     });
 });
 
-const logger$7 = debug('seedSdk:client:actors:addModelsToStore');
+const logger$8 = debug('seedSdk:client:actors:addModelsToStore');
 const addModelsToStore = fromCallback(({ sendBack, input: { context } }) => {
     const _addModelsToStore = async () => {
         let { models } = context;
@@ -763,7 +763,7 @@ const addModelsToStore = fromCallback(({ sendBack, input: { context } }) => {
         // Models are now Model instances, no registration needed
         // They should be created via Model.create() and are accessible via Model static methods
         for (const [key] of Object.entries(allModels)) {
-            logger$7('model available:', key);
+            logger$8('model available:', key);
         }
     };
     _addModelsToStore()
@@ -771,7 +771,7 @@ const addModelsToStore = fromCallback(({ sendBack, input: { context } }) => {
         sendBack({ type: ClientManagerEvents.ADD_MODELS_TO_STORE_SUCCESS });
     })
         .catch((error) => {
-        logger$7('[client/actors] [addModelsToStore] Error:', error);
+        logger$8('[client/actors] [addModelsToStore] Error:', error);
         sendBack({
             type: 'error',
             error: error instanceof Error ? error : new Error(String(error)),
@@ -779,7 +779,7 @@ const addModelsToStore = fromCallback(({ sendBack, input: { context } }) => {
     });
 });
 
-const logger$6 = debug('seedSdk:client:actors:addModelsToDb');
+const logger$7 = debug('seedSdk:client:actors:addModelsToDb');
 /**
  * Returns every `models` row named in `modelNames`, inserting a null-schemaFileId stub for each name
  * with no row yet (the schema import adopts stubs via findOrCreateModelRecord). Check-then-insert:
@@ -802,7 +802,7 @@ async function ensureModelStubs(appDb, modelNames, filesDir) {
                 .returning({ id: models$1.id, name: models$1.name, schemaFileId: models$1.schemaFileId }));
             rows.push(...newlyInserted);
             for (const name of modelsToInsert) {
-                logger$6('[client/actors] [addModelsToDb] inserted model:', name);
+                logger$7('[client/actors] [addModelsToDb] inserted model:', name);
             }
         }
         return rows;
@@ -839,7 +839,7 @@ const addModelsToDb = fromCallback(({ sendBack, input: { context } }) => {
         for (const modelName of modelNames) {
             const foundModel = rowFor(modelName);
             if (!foundModel) {
-                logger$6('[client/actors] [addModelsToDb] Warning: Could not find or create model:', modelName);
+                logger$7('[client/actors] [addModelsToDb] Warning: Could not find or create model:', modelName);
                 hasModelsInDb = false;
                 continue;
             }
@@ -851,7 +851,7 @@ const addModelsToDb = fromCallback(({ sendBack, input: { context } }) => {
         }
         // If we have no models to process, still send success (empty models is valid)
         if (schemaDefsByModelName.size === 0) {
-            logger$6('[client/actors] [addModelsToDb] No models to process, but continuing');
+            logger$7('[client/actors] [addModelsToDb] No models to process, but continuing');
             sendBack({ type: ClientManagerEvents.ADD_MODELS_TO_DB_SUCCESS });
             return;
         }
@@ -894,15 +894,15 @@ const addModelsToDb = fromCallback(({ sendBack, input: { context } }) => {
                     requestEasSyncFromModelsInit();
                 }
                 else {
-                    logger$6('[client/actors] [addModelsToDb] No schemas found from EAS, but continuing');
+                    logger$7('[client/actors] [addModelsToDb] No schemas found from EAS, but continuing');
                 }
             }
             catch (error) {
                 if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-                    logger$6('[client/actors] [addModelsToDb] Warning: Could not fetch schemas from EAS (background):', error.message);
+                    logger$7('[client/actors] [addModelsToDb] Warning: Could not fetch schemas from EAS (background):', error.message);
                 }
                 else {
-                    logger$6('[client/actors] [addModelsToDb] Error fetching schemas (background):', error.message);
+                    logger$7('[client/actors] [addModelsToDb] Error fetching schemas (background):', error.message);
                 }
             }
         };
@@ -914,10 +914,10 @@ const addModelsToDb = fromCallback(({ sendBack, input: { context } }) => {
         sendBack({ type: ClientManagerEvents.ADD_MODELS_TO_DB_SUCCESS });
     })
         .catch((error) => {
-        logger$6('[client/actors] [addModelsToDb] Error:', error);
+        logger$7('[client/actors] [addModelsToDb] Error:', error);
         // In test environments, still send success to allow initialization to complete
         if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-            logger$6('[client/actors] [addModelsToDb] Continuing despite error in test environment');
+            logger$7('[client/actors] [addModelsToDb] Continuing despite error in test environment');
             sendBack({ type: ClientManagerEvents.ADD_MODELS_TO_DB_SUCCESS });
         }
         else {
@@ -930,7 +930,7 @@ const addModelsToDb = fromCallback(({ sendBack, input: { context } }) => {
     return () => { };
 });
 
-const logger$5 = debug('seedSdk:helpers:localDbChain');
+const logger$6 = debug('seedSdk:helpers:localDbChain');
 /** appState key recording which EAS chain the local database holds attestations from. */
 const EAS_CHAIN_ID_APP_STATE_KEY = 'easChainId';
 /**
@@ -1000,7 +1000,7 @@ async function loadLocalDbChain() {
     const localChainId = await resolveLocalDbChainId(appDb);
     if (localChainId !== undefined) {
         configureEasReadChain('localDb', { chainId: localChainId });
-        logger$5('local DB holds chain %d', localChainId);
+        logger$6('local DB holds chain %d', localChainId);
         return;
     }
     if (isEasReadChainConfigured()) {
@@ -1026,7 +1026,7 @@ async function assertLocalDbChain() {
     configureEasReadChain('localDb', { chainId: localChainId ?? chainId });
 }
 
-const logger$4 = debug('seedSdk:client:actors:saveConfig');
+const logger$5 = debug('seedSdk:client:actors:saveConfig');
 /**
  * Saves the addresses passed to init. Hosts pass `addresses: []` before a wallet connects. In the
  * first (leader) tab that clears stored addresses, as it always has, so drafts made before the
@@ -1046,13 +1046,13 @@ async function persistInitAddresses(appDb, { addresses, ownedAddresses, watchedA
         .onConflictDoUpdate({ target: appState.key, set: { value } });
 }
 const saveConfig = fromCallback(({ sendBack, input: { context } }) => {
-    logger$4('saveConfig starting');
+    logger$5('saveConfig starting');
     const { endpoints, addresses, ownedAddresses, watchedAddresses, arweaveDomain, uploadApiBaseUrl, gatewayTransport, gatewayHyperKey, gatewaySidecarHost, gatewaySidecarPort, gatewayProxyBaseUrl, } = context;
     // Validate endpoints - required for proper initialization
     // If endpoints are missing or invalid, initialization should fail
     if (!endpoints || !endpoints.filePaths || !endpoints.files) {
         const error = new Error('saveConfig called with invalid endpoints: endpoints must include both filePaths and files');
-        logger$4('[internal/actors] [saveConfig] Invalid endpoints:', { endpoints });
+        logger$5('[internal/actors] [saveConfig] Invalid endpoints:', { endpoints });
         throw error;
     }
     const _saveConfig = async () => {
@@ -1061,7 +1061,7 @@ const saveConfig = fromCallback(({ sendBack, input: { context } }) => {
             if (!appDb) {
                 // In test environments, continue anyway
                 if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-                    logger$4('[internal/actors] [saveConfig] App DB not found, but continuing in test environment');
+                    logger$5('[internal/actors] [saveConfig] App DB not found, but continuing in test environment');
                     return;
                 }
                 throw new Error('App DB not found');
@@ -1116,10 +1116,10 @@ const saveConfig = fromCallback(({ sendBack, input: { context } }) => {
             await loadLocalDbChain();
         }
         catch (error) {
-            logger$4('[internal/actors] [saveConfig] Error saving config:', error);
+            logger$5('[internal/actors] [saveConfig] Error saving config:', error);
             // In test environments, continue anyway
             if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-                logger$4('[internal/actors] [saveConfig] Continuing despite error in test environment');
+                logger$5('[internal/actors] [saveConfig] Continuing despite error in test environment');
                 return;
             }
             throw error;
@@ -1128,14 +1128,14 @@ const saveConfig = fromCallback(({ sendBack, input: { context } }) => {
     // Init writes run one tab at a time (docs/MULTI_TAB.md).
     withSeedDbLock('init', context.filesDir, _saveConfig)
         .then(() => {
-        logger$4('[internal/actors] [saveConfig] saveConfig success');
+        logger$5('[internal/actors] [saveConfig] saveConfig success');
         return sendBack({ type: ClientManagerEvents.SAVE_CONFIG_SUCCESS });
     })
         .catch((error) => {
-        logger$4('[internal/actors] [saveConfig] Error in saveConfig promise chain:', error);
+        logger$5('[internal/actors] [saveConfig] Error in saveConfig promise chain:', error);
         // In test environments, still send success to allow state machine to progress
         if (process.env.NODE_ENV === 'test' || process.env.IS_SEED_DEV) {
-            logger$4('[internal/actors] [saveConfig] Sending success despite error in test environment');
+            logger$5('[internal/actors] [saveConfig] Sending success despite error in test environment');
             sendBack({ type: ClientManagerEvents.SAVE_CONFIG_SUCCESS });
         }
         else {
@@ -1148,7 +1148,7 @@ const saveConfig = fromCallback(({ sendBack, input: { context } }) => {
     return () => { };
 });
 
-const logger$3 = debug('seedSdk:helpers:schema');
+const logger$4 = debug('seedSdk:helpers:schema');
 /**
  * Sanitize a schema name to be filesystem-safe
  * Replaces all special characters (except alphanumeric, hyphens, underscores) with underscores
@@ -1344,7 +1344,7 @@ async function listCompleteSchemaFiles() {
         const dirExists = await BaseFileManager.pathExists(workingDir);
         if (!dirExists) {
             // Directory doesn't exist yet - return empty array (not an error condition)
-            logger$3(`Working directory does not exist yet: ${workingDir}, returning empty schema list`);
+            logger$4(`Working directory does not exist yet: ${workingDir}, returning empty schema list`);
             return [];
         }
         const files = await fs.promises.readdir(workingDir);
@@ -1480,7 +1480,7 @@ async function loadAllSchemasFromDb() {
             }
             catch (error) {
                 // If we can't list schema files (e.g., directory doesn't exist yet), continue without file-based loading
-                logger$3(`Error listing complete schema files (continuing with DB data): ${error instanceof Error ? error.message : String(error)}`);
+                logger$4(`Error listing complete schema files (continuing with DB data): ${error instanceof Error ? error.message : String(error)}`);
                 completeSchemaFiles = [];
             }
         }
@@ -1533,7 +1533,7 @@ async function loadAllSchemasFromDb() {
                 continue;
             }
             catch (error) {
-                logger$3(`Error parsing schemaData for ${schemaName}:`, error);
+                logger$4(`Error parsing schemaData for ${schemaName}:`, error);
                 // Fall through to file-based loading
             }
         }
@@ -1575,7 +1575,7 @@ async function loadAllSchemasFromDb() {
                     continue;
                 }
                 catch (error) {
-                    logger$3(`Error loading schema file for ${schemaName}:`, error);
+                    logger$4(`Error loading schema file for ${schemaName}:`, error);
                     // Fall through to try loading from schemaData if available
                 }
             }
@@ -1619,7 +1619,7 @@ async function loadAllSchemasFromDb() {
                     continue;
                 }
                 catch (error) {
-                    logger$3(`Error parsing schemaData for ${schemaName}:`, error);
+                    logger$4(`Error parsing schemaData for ${schemaName}:`, error);
                 }
             }
         }
@@ -1630,11 +1630,11 @@ async function loadAllSchemasFromDb() {
         // Only process if not already in result
         if (!processedSchemaNames.has(schemaFileInfo.name)) {
             if (isInternalSchema(schemaFileInfo.name, schemaFileInfo.schemaFileId)) {
-                logger$3(`STEP 3: skipping internal schema file: ${schemaFileInfo.filePath}`);
+                logger$4(`STEP 3: skipping internal schema file: ${schemaFileInfo.filePath}`);
                 continue;
             }
             try {
-                logger$3(`STEP 3: processing schema file: ${schemaFileInfo.name} from ${schemaFileInfo.filePath}`);
+                logger$4(`STEP 3: processing schema file: ${schemaFileInfo.name} from ${schemaFileInfo.filePath}`);
                 const content = await BaseFileManager.readFileAsString(schemaFileInfo.filePath);
                 const schemaFile = JSON.parse(content);
                 // Import this schema to database (mark as non-draft since it's in a file)
@@ -1654,7 +1654,7 @@ async function loadAllSchemasFromDb() {
                 processedSchemaNames.add(schemaFileInfo.name);
             }
             catch (error) {
-                logger$3(`Error loading schema file ${schemaFileInfo.filePath}:`, error);
+                logger$4(`Error loading schema file ${schemaFileInfo.filePath}:`, error);
             }
         }
     }
@@ -1671,7 +1671,7 @@ async function migrateFileSchemasToDb() {
     if (!db) {
         throw new Error('Database not found');
     }
-    logger$3('Starting migration of file-based schemas to database');
+    logger$4('Starting migration of file-based schemas to database');
     // Get all complete schema files
     const completeSchemas = await listCompleteSchemaFiles();
     let migratedCount = 0;
@@ -1681,7 +1681,7 @@ async function migrateFileSchemasToDb() {
             const content = await BaseFileManager.readFileAsString(schemaFileInfo.filePath);
             const schemaFile = JSON.parse(content);
             if (!schemaFile.$schema || !schemaFile.metadata?.name) {
-                logger$3(`Skipping invalid schema file: ${schemaFileInfo.filePath}`);
+                logger$4(`Skipping invalid schema file: ${schemaFileInfo.filePath}`);
                 continue;
             }
             const schemaName = schemaFile.metadata.name;
@@ -1703,17 +1703,17 @@ async function migrateFileSchemasToDb() {
                 JSON.stringify(schemaFile, null, 2), // schemaData
                 false);
                 migratedCount++;
-                logger$3(`Migrated schema: ${schemaName} v${schemaFile.version}`);
+                logger$4(`Migrated schema: ${schemaName} v${schemaFile.version}`);
             }
             else {
-                logger$3(`Schema ${schemaName} already exists in database, skipping`);
+                logger$4(`Schema ${schemaName} already exists in database, skipping`);
             }
         }
         catch (error) {
-            logger$3(`Error migrating schema file ${schemaFileInfo.filePath}:`, error);
+            logger$4(`Error migrating schema file ${schemaFileInfo.filePath}:`, error);
         }
     }
-    logger$3(`Migration complete: ${migratedCount} schemas migrated`);
+    logger$4(`Migration complete: ${migratedCount} schemas migrated`);
     return migratedCount;
 }
 /**
@@ -1768,7 +1768,7 @@ const getDeterministicIdsWithPrefix = (prefix) => {
     return (suffix) => bytesToHex(prefixHash.clone().update(utf8ToBytes(suffix)).digest()).slice(0, 10);
 };
 
-const logger$2 = debug('seedSdk:imports:json');
+const logger$3 = debug('seedSdk:imports:json');
 /**
  * Get refValueType from a property object with case-insensitive key lookup.
  * Handles refValueType, refvaluetype, ref_value_type, elementType, and legacy items.type / items.Type.
@@ -1846,7 +1846,7 @@ function getRefValueType(prop) {
  * @returns Promise that resolves when properties are found, or rejects if not found after max retries
  */
 const verifyPropertiesPersisted = async (db, modelId, modelName, maxRetries = 10, retryDelay = 100) => {
-    const _mod_0 = await import('./BasePathResolver-BdxCSIzn.js');
+    const _mod_0 = await import('./BasePathResolver-CfSfMW5_.js');
     const _ns_0 = _mod_0.N;
     const modelSchemaMod = _ns_0;
     const { properties: propertiesTable } = modelSchemaMod;
@@ -1859,11 +1859,11 @@ const verifyPropertiesPersisted = async (db, modelId, modelName, maxRetries = 10
             .where(eq(propertiesTable.modelId, modelId))
             .limit(1);
         if (props.length > 0) {
-            logger$2(`Verified properties exist for model "${modelName}" (modelId: ${modelId}) after ${attempt + 1} attempt(s)`);
+            logger$3(`Verified properties exist for model "${modelName}" (modelId: ${modelId}) after ${attempt + 1} attempt(s)`);
             return;
         }
         if (attempt < maxRetries - 1) {
-            logger$2(`Properties not yet visible for model "${modelName}" (modelId: ${modelId}), retrying in ${retryDelay}ms (attempt ${attempt + 1}/${maxRetries})`);
+            logger$3(`Properties not yet visible for model "${modelName}" (modelId: ${modelId}), retrying in ${retryDelay}ms (attempt ${attempt + 1}/${maxRetries})`);
             await new Promise(resolve => setTimeout(resolve, retryDelay));
         }
     }
@@ -2169,7 +2169,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
             if (parsed.$schema && parsed.metadata) {
                 // It's already a complete schema format - preserve it (id may be missing, will be generated)
                 originalSchemaFile = parsed;
-                logger$2(`Input is complete schema format (${originalSchemaFile.id ? `preserving ID: ${originalSchemaFile.id}` : 'id will be generated'})`);
+                logger$3(`Input is complete schema format (${originalSchemaFile.id ? `preserving ID: ${originalSchemaFile.id}` : 'id will be generated'})`);
             }
         }
         catch {
@@ -2194,7 +2194,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         // Check DB for existing schema by name+version (same as minimal path)
         const db = BaseDb.getAppDb();
         if (db) {
-            const _mod_1 = await import('./BasePathResolver-BdxCSIzn.js');
+            const _mod_1 = await import('./BasePathResolver-CfSfMW5_.js');
             const _ns_1 = _mod_1.Q;
             const schemaSchemaMod = _ns_1;
             const { schemas: schemasTable } = schemaSchemaMod;
@@ -2208,16 +2208,16 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                 .limit(1);
             if (existingByName.length > 0 && existingByName[0].schemaData) {
                 const existing = existingByName[0];
-                logger$2(`Idempotency: found existing schema by name+version: ${schemaFile.metadata.name} v${schemaFile.version ?? version}`);
+                logger$3(`Idempotency: found existing schema by name+version: ${schemaFile.metadata.name} v${schemaFile.version ?? version}`);
                 const existingSchema = JSON.parse(existing.schemaData);
                 const contentMatches = compareSchemaContent(schemaFile, existingSchema);
-                logger$2(`Idempotency: compareSchemaContent=${contentMatches} for ${schemaFile.metadata.name}`);
+                logger$3(`Idempotency: compareSchemaContent=${contentMatches} for ${schemaFile.metadata.name}`);
                 if (contentMatches) {
                     if (existing.schemaFileId) {
                         const workingDir = BaseFileManager.getWorkingDir();
                         const existingFilePath = getSchemaFilePath(workingDir, schemaFile.metadata.name, schemaFile.version ?? version, existing.schemaFileId);
                         if (await BaseFileManager.pathExists(existingFilePath)) {
-                            logger$2(`Schema ${schemaFile.metadata.name} v${schemaFile.version} already exists with same content, loading existing file`);
+                            logger$3(`Schema ${schemaFile.metadata.name} v${schemaFile.version} already exists with same content, loading existing file`);
                             return await loadSchemaFromFile(existingFilePath);
                         }
                         await BaseFileManager.createDirIfNotExists(workingDir);
@@ -2225,7 +2225,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                         await BaseFileManager.waitForFileWithContent(existingFilePath, 100, 5000);
                         return await loadSchemaFromFile(existingFilePath);
                     }
-                    logger$2(`Schema ${schemaFile.metadata.name} v${schemaFile.version} already exists with same content (no schemaFileId), using DB`);
+                    logger$3(`Schema ${schemaFile.metadata.name} v${schemaFile.version} already exists with same content (no schemaFileId), using DB`);
                     return '';
                 }
             }
@@ -2241,7 +2241,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         // processSchemaFiles runs multiple times (React StrictMode, app restarts).
         if (!schemaFile.id) {
             schemaFile.id = await getDeterministicSchemaFileId(schemaFile);
-            logger$2(`Generated deterministic schema ID for ${schemaFile.metadata.name}:`, schemaFile.id);
+            logger$3(`Generated deterministic schema ID for ${schemaFile.metadata.name}:`, schemaFile.id);
         }
         // Before generating IDs, check if a file already exists with this schemaFileId
         // This handles the case where the schema was already loaded via loadSchemaFromFile
@@ -2251,7 +2251,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         const existingFileExists = await BaseFileManager.pathExists(existingFilePath);
         if (existingFileExists) {
             // File already exists with this schemaFileId - just load it instead of creating a new one
-            logger$2(`Schema file already exists with schemaFileId ${schemaFile.id}, loading it instead of creating new file`);
+            logger$3(`Schema file already exists with schemaFileId ${schemaFile.id}, loading it instead of creating new file`);
             return await loadSchemaFromFile(existingFilePath);
         }
         // Generate missing model and property IDs.
@@ -2262,12 +2262,12 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         for (const [modelName, model] of Object.entries(schemaFile.models || {})) {
             if (!model.id) {
                 model.id = getDeterministicId(modelName);
-                logger$2(`Generated deterministic model ID for ${modelName}:`, model.id);
+                logger$3(`Generated deterministic model ID for ${modelName}:`, model.id);
             }
             for (const [propName, prop] of Object.entries(model.properties || {})) {
                 if (!prop.id) {
                     prop.id = getDeterministicId(modelName + propName);
-                    logger$2(`Generated deterministic property ID for ${modelName}.${propName}:`, prop.id);
+                    logger$3(`Generated deterministic property ID for ${modelName}.${propName}:`, prop.id);
                 }
             }
         }
@@ -2279,7 +2279,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         // For minimal imports: check DB for existing schema before creating new file
         const db = BaseDb.getAppDb();
         if (db) {
-            const _mod_2 = await import('./BasePathResolver-BdxCSIzn.js');
+            const _mod_2 = await import('./BasePathResolver-CfSfMW5_.js');
             const _ns_2 = _mod_2.Q;
             const schemaSchemaMod = _ns_2;
             const { schemas: schemasTable } = schemaSchemaMod;
@@ -2303,14 +2303,14 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                                 const workingDir = BaseFileManager.getWorkingDir();
                                 const existingFilePath = getSchemaFilePath(workingDir, importData.name, version, existing.schemaFileId);
                                 if (await BaseFileManager.pathExists(existingFilePath)) {
-                                    logger$2(`Schema ${importData.name} v${version} already exists with same content, loading existing file`);
+                                    logger$3(`Schema ${importData.name} v${version} already exists with same content, loading existing file`);
                                     return await loadSchemaFromFile(existingFilePath);
                                 }
                                 // File missing but schemaData exists - restore file from schemaData
                                 await BaseFileManager.createDirIfNotExists(workingDir);
                                 await BaseFileManager.saveFile(existingFilePath, existing.schemaData);
                                 await BaseFileManager.waitForFileWithContent(existingFilePath, 100, 5000);
-                                logger$2(`Restored schema file from schemaData for ${importData.name} v${version}`);
+                                logger$3(`Restored schema file from schemaData for ${importData.name} v${version}`);
                                 return await loadSchemaFromFile(existingFilePath);
                             }
                             // No schemaFileId - restore file from schemaData using id from parsed schema
@@ -2321,10 +2321,10 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                                 await BaseFileManager.createDirIfNotExists(workingDir);
                                 await BaseFileManager.saveFile(existingFilePath, existing.schemaData);
                                 await BaseFileManager.waitForFileWithContent(existingFilePath, 100, 5000);
-                                logger$2(`Restored schema file from schemaData for ${importData.name} v${version}`);
+                                logger$3(`Restored schema file from schemaData for ${importData.name} v${version}`);
                                 return await loadSchemaFromFile(existingFilePath);
                             }
-                            logger$2(`Schema ${importData.name} v${version} already exists with same content (no id), using DB`);
+                            logger$3(`Schema ${importData.name} v${version} already exists with same content (no id), using DB`);
                             return '';
                         }
                         // Content differs - create new version
@@ -2335,7 +2335,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                             .orderBy(desc(schemasTable.version))
                             .limit(1);
                         const newVersion = latestVersionRows.length > 0 ? latestVersionRows[0].version + 1 : version;
-                        logger$2(`Schema ${importData.name} content changed, creating new version v${newVersion}`);
+                        logger$3(`Schema ${importData.name} content changed, creating new version v${newVersion}`);
                         schemaFile = transformImportToSchemaFile(importData, newVersion);
                         version = newVersion;
                     }
@@ -2359,7 +2359,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
     // Check if this is an internal SDK schema (should not create files in app directory)
     const isInternal = isInternalSchema(schemaFile.metadata.name, schemaFile.id);
     if (isInternal) {
-        logger$2(`Skipping file creation for internal schema: ${schemaFile.metadata.name}`);
+        logger$3(`Skipping file creation for internal schema: ${schemaFile.metadata.name}`);
         // For internal schemas, just load to database and store, don't create file
         // Extract schema name and version
         const schemaName = schemaFile.metadata?.name;
@@ -2416,7 +2416,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         // Use fixed internal schema ID if missing (never generate for internal)
         if (!schemaFile.id) {
             schemaFile.id = INTERNAL_SCHEMA_IDS[0];
-            logger$2('Using fixed internal schema ID:', schemaFile.id);
+            logger$3('Using fixed internal schema ID:', schemaFile.id);
         }
         // Extract schemaFileIds from JSON file and generate missing ones BEFORE creating models
         // This ensures Model instances are created with correct IDs
@@ -2426,7 +2426,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
             // Generate model ID if missing
             if (!model.id) {
                 model.id = generateId();
-                logger$2(`Generated model ID for ${modelName}:`, model.id);
+                logger$3(`Generated model ID for ${modelName}:`, model.id);
                 // Update the schemaFile object so it's included in schemaData
                 schemaFile.models[modelName].id = model.id;
             }
@@ -2436,7 +2436,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                 // Generate property ID if missing
                 if (!prop.id) {
                     prop.id = generateId();
-                    logger$2(`Generated property ID for ${modelName}.${propName}:`, prop.id);
+                    logger$3(`Generated property ID for ${modelName}.${propName}:`, prop.id);
                     // Update the schemaFile object so it's included in schemaData
                     schemaFile.models[modelName].properties[propName].id = prop.id;
                 }
@@ -2448,7 +2448,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         }
         // Convert JSON models to Model classes, passing modelFileIds and propertyFileIds so Model instances use correct IDs
         const modelDefinitions = await createModelsFromJson(importDataForInternal, modelFileIds, propertyFileIds);
-        logger$2('loadSchemaFromFile (internal) - modelDefinitions length:', Object.keys(modelDefinitions).length);
+        logger$3('loadSchemaFromFile (internal) - modelDefinitions length:', Object.keys(modelDefinitions).length);
         // Convert schema file metadata to schema input for database
         const schemaInput = {
             name: schemaName,
@@ -2458,7 +2458,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
             updatedAt: new Date(schemaFile.metadata.updatedAt).getTime(),
         };
         // Use dynamic import to break circular dependency
-        const _mod_3 = await import('./db-CQt-gcAl.js');
+        const _mod_3 = await import('./db-D9K_f5cF.js');
         const _ns_3 = _mod_3.Z;
         const dbMod = _ns_3;
         const { addSchemaToDb, addModelsToDb } = dbMod;
@@ -2480,11 +2480,11 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                     });
                     // Verify expected models are linked (single attempt - addModelsToDb already confirmed)
                     const expectedModelNames = Object.keys(schemaFile.models || {});
-                    const _mod_4 = await import('./BasePathResolver-BdxCSIzn.js');
+                    const _mod_4 = await import('./BasePathResolver-CfSfMW5_.js');
                     const _ns_4 = _mod_4.R;
                     const modelSchemaSchemaMod = _ns_4;
                     const { modelSchemas } = modelSchemaSchemaMod;
-                    const _mod_5 = await import('./BasePathResolver-BdxCSIzn.js');
+                    const _mod_5 = await import('./BasePathResolver-CfSfMW5_.js');
                     const _ns_5 = _mod_5.N;
                     const modelSchemaMod = _ns_5;
                     const { models: modelsTable } = modelSchemaMod;
@@ -2574,12 +2574,12 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
         }
         catch (dbError) {
             // Database not available - log warning but continue
-            logger$2('Database not available, skipping database operations:', dbError instanceof Error ? dbError.message : String(dbError));
+            logger$3('Database not available, skipping database operations:', dbError instanceof Error ? dbError.message : String(dbError));
         }
         // Models are now Model instances, no registration needed
         // They should be created via Model.create() and are accessible via Model static methods
         for (const [modelName] of Object.entries(modelDefinitions)) {
-            logger$2('loadSchemaFromFile (internal) - model available:', modelName);
+            logger$3('loadSchemaFromFile (internal) - model available:', modelName);
         }
         // Schema is now saved to database
         // useSchemas hook will pick it up via database queries
@@ -2590,7 +2590,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
     // Ensure schema ID is defined (should always be set by this point, but check for safety)
     if (!schemaFile.id) {
         schemaFile.id = generateId();
-        logger$2('Generated schema ID before file path creation:', schemaFile.id);
+        logger$3('Generated schema ID before file path creation:', schemaFile.id);
     }
     // Get the target file path using ID-based naming (preferred)
     const filePath = getSchemaFilePath(workingDir, schemaFile.metadata.name, version, schemaFile.id);
@@ -2609,7 +2609,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                     const data = JSON.parse(content);
                     if (data.$schema) {
                         // File is already a complete schema, just load it
-                        logger$2(`Schema file ${filePath} already exists and is complete, loading it`);
+                        logger$3(`Schema file ${filePath} already exists and is complete, loading it`);
                         return await loadSchemaFromFile(filePath);
                     }
                 }
@@ -2627,7 +2627,7 @@ async function importJsonSchema(importFilePathOrContents, version = 1) {
                 // Compare schemas structurally
                 if (compareSchemasStructurally(schemaFile, existingSchema)) {
                     // Schemas match - just load the existing file
-                    logger$2(`Schema ${schemaFile.metadata.name} v${version} already exists with matching content, loading it`);
+                    logger$3(`Schema ${schemaFile.metadata.name} v${version} already exists with matching content, loading it`);
                     return await loadSchemaFromFile(filePath);
                 }
                 else {
@@ -2683,7 +2683,7 @@ async function applySchemaToDb(schemaFile, modelDefinitions, modelFileIds, prope
         createdAt: new Date(schemaFile.metadata.createdAt).getTime(),
         updatedAt: new Date(schemaFile.metadata.updatedAt).getTime(),
     };
-    const _mod_6 = await import('./db-CQt-gcAl.js');
+    const _mod_6 = await import('./db-D9K_f5cF.js');
     const _ns_6 = _mod_6.Z;
     const dbMod = _ns_6;
     const { addSchemaToDb, addModelsToDb } = dbMod;
@@ -2804,7 +2804,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
         // Generate schema ID if missing (before creating schemaInput)
         if (!schemaFile.id) {
             schemaFile.id = generateId();
-            logger$2('Generated schema ID for schema file:', schemaFile.id);
+            logger$3('Generated schema ID for schema file:', schemaFile.id);
         }
         // Extract schemaFileIds from JSON file and generate missing ones BEFORE creating models
         // This ensures Model instances are created with correct IDs
@@ -2814,7 +2814,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
             // Generate model ID if missing
             if (!model.id) {
                 model.id = generateId();
-                logger$2(`Generated model ID for ${modelName}:`, model.id);
+                logger$3(`Generated model ID for ${modelName}:`, model.id);
                 // Update the schemaFile object so it's included in schemaData
                 schemaFile.models[modelName].id = model.id;
             }
@@ -2824,7 +2824,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
                 // Generate property ID if missing
                 if (!prop.id) {
                     prop.id = generateId();
-                    logger$2(`Generated property ID for ${modelName}.${propName}:`, prop.id);
+                    logger$3(`Generated property ID for ${modelName}.${propName}:`, prop.id);
                     // Update the schemaFile object so it's included in schemaData
                     schemaFile.models[modelName].properties[propName].id = prop.id;
                 }
@@ -2836,18 +2836,18 @@ const loadSchemaFromFile = async (schemaFilePath) => {
         }
         // Convert JSON models to Model classes, passing modelFileIds and propertyFileIds so Model instances use correct IDs
         const modelDefinitions = await createModelsFromJson(importData, modelFileIds, propertyFileIds);
-        logger$2('loadSchemaFromFile - modelDefinitions length:', Object.keys(modelDefinitions).length);
+        logger$3('loadSchemaFromFile - modelDefinitions length:', Object.keys(modelDefinitions).length);
         // Try to add schema and models to database if database is available
         try {
             const db = BaseDb.getAppDb();
             if (db) {
                 const { schemaRecord } = await applySchemaToDb(schemaFile, modelDefinitions, modelFileIds, propertyFileIds);
                 // Query the database to get model IDs that were just created
-                const _mod_7 = await import('./BasePathResolver-BdxCSIzn.js');
+                const _mod_7 = await import('./BasePathResolver-CfSfMW5_.js');
                 const _ns_7 = _mod_7.R;
                 const modelSchemaSchemaMod = _ns_7;
                 const { modelSchemas } = modelSchemaSchemaMod;
-                const _mod_8 = await import('./BasePathResolver-BdxCSIzn.js');
+                const _mod_8 = await import('./BasePathResolver-CfSfMW5_.js');
                 const _ns_8 = _mod_8.N;
                 const modelSchemaMod = _ns_8;
                 const { models: modelsTable } = modelSchemaMod;
@@ -2895,17 +2895,17 @@ const loadSchemaFromFile = async (schemaFilePath) => {
                             await new Promise(resolve => setTimeout(resolve, 100));
                         }
                     }
-                    logger$2(`Verifying properties: found ${modelLinks.length} model links for schema ${schemaName} (id: ${schemaRecord.id})`);
+                    logger$3(`Verifying properties: found ${modelLinks.length} model links for schema ${schemaName} (id: ${schemaRecord.id})`);
                     // If we didn't verify via direct lookup, verify via join table
                     if (!seedModelId || (seedModel.length === 0 || !seedModel[0].id)) {
                         const seedModelLink = modelLinks.find((link) => link.modelName === 'Seed');
                         if (seedModelLink && seedModelLink.modelId) {
-                            logger$2(`Verifying properties for Seed model via join table (modelId: ${seedModelLink.modelId})`);
+                            logger$3(`Verifying properties for Seed model via join table (modelId: ${seedModelLink.modelId})`);
                             await verifyPropertiesPersisted(db, seedModelLink.modelId, 'Seed', 10, 100);
                         }
                         else if (modelLinks.length > 0 && modelLinks[0].modelId) {
                             // Fallback to first model if Seed not found
-                            logger$2(`Verifying properties for ${modelLinks[0].modelName} model via join table (modelId: ${modelLinks[0].modelId})`);
+                            logger$3(`Verifying properties for ${modelLinks[0].modelName} model via join table (modelId: ${modelLinks[0].modelId})`);
                             await verifyPropertiesPersisted(db, modelLinks[0].modelId, modelLinks[0].modelName || 'unknown', 10, 100);
                         }
                     }
@@ -2913,7 +2913,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
                 // After properties are created (file path), ensure schemaFile has the correct IDs from database
                 // Query the database to get the actual schemaFileId values that were used
                 // This ensures schemaData matches what's actually in the database
-                const _mod_9 = await import('./BasePathResolver-BdxCSIzn.js');
+                const _mod_9 = await import('./BasePathResolver-CfSfMW5_.js');
                 const _ns_9 = _mod_9.N;
                 const modelSchemaMod2 = _ns_9;
                 const { properties: propertiesTable } = modelSchemaMod2;
@@ -2938,7 +2938,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
                                 const currentId = schemaFile.models[modelName].properties[propRecord.name].id;
                                 if (currentId !== propRecord.schemaFileId) {
                                     schemaFile.models[modelName].properties[propRecord.name].id = propRecord.schemaFileId;
-                                    logger$2(`Updated schemaFile property ID for ${modelName}.${propRecord.name} from ${currentId} to ${propRecord.schemaFileId}`);
+                                    logger$3(`Updated schemaFile property ID for ${modelName}.${propRecord.name} from ${currentId} to ${propRecord.schemaFileId}`);
                                     schemaFileUpdated = true;
                                 }
                             }
@@ -2949,7 +2949,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
                 // This is important even if nothing changed, to ensure consistency
                 const updatedSchemaData = JSON.stringify(schemaFile, null, 2);
                 // Update the schema record in the database with current schemaData
-                const _mod_10 = await import('./BasePathResolver-BdxCSIzn.js');
+                const _mod_10 = await import('./BasePathResolver-CfSfMW5_.js');
                 const _ns_10 = _mod_10.Q;
                 const schemaSchemaMod = _ns_10;
                 const { schemas: schemasTable } = schemaSchemaMod;
@@ -2958,21 +2958,21 @@ const loadSchemaFromFile = async (schemaFilePath) => {
                     .set({ schemaData: updatedSchemaData })
                     .where(eq(schemasTable.id, schemaRecord.id));
                 if (schemaFileUpdated) {
-                    logger$2(`Updated schemaData in database with actual property IDs for schema "${schemaName}"`);
+                    logger$3(`Updated schemaData in database with actual property IDs for schema "${schemaName}"`);
                 }
                 else {
-                    logger$2(`Verified schemaData in database matches schemaFile for schema "${schemaName}"`);
+                    logger$3(`Verified schemaData in database matches schemaFile for schema "${schemaName}"`);
                 }
             }
         }
         catch (dbError) {
             // Database not available - log warning but continue
-            logger$2('Database not available, skipping database operations:', dbError instanceof Error ? dbError.message : String(dbError));
+            logger$3('Database not available, skipping database operations:', dbError instanceof Error ? dbError.message : String(dbError));
         }
         // Models are now Model instances, no registration needed
         // They should be created via Model.create() and are accessible via Model static methods
         for (const [modelName] of Object.entries(modelDefinitions)) {
-            logger$2('loadSchemaFromFile - model available:', modelName);
+            logger$3('loadSchemaFromFile - model available:', modelName);
         }
         return schemaFilePath;
     }
@@ -2992,7 +2992,7 @@ const loadSchemaFromFile = async (schemaFilePath) => {
  */
 const createModelFromJson = async (modelName, modelDef, schemaName, modelFileId, // Optional modelFileId from JSON file
 propertyFileIds) => {
-    const _mod_11 = await import('./index-Xl1_4Lmb.js');
+    const _mod_11 = await import('./index-s15q14rm.js');
     const _ns_11 = _mod_11.f;
     const modelMod = _ns_11;
     const { Model } = modelMod;
@@ -3059,10 +3059,10 @@ propertyFileIds) => {
     // Pass id (schemaFileId) if provided to ensure Model instance uses correct ID
     // Note: indexes and description are ignored - they remain in JSON for schema file format compliance but are not used by Model instances
     if (modelFileId) {
-        logger$2(`Creating schema model "${modelName}" with modelFileId: ${modelFileId}`);
+        logger$3(`Creating schema model "${modelName}" with modelFileId: ${modelFileId}`);
     }
     else {
-        logger$2(`Warning: Creating schema model "${modelName}" without modelFileId - it will be renamed if duplicates exist`);
+        logger$3(`Warning: Creating schema model "${modelName}" without modelFileId - it will be renamed if duplicates exist`);
     }
     const modelInstance = Model.create(modelName, schemaName, {
         modelFileId: modelFileId, // Pass modelFileId (preferred) as id (schemaFileId) from JSON file
@@ -3088,7 +3088,7 @@ const createModelsFromJson = async (importData, modelFileIds, propertyFileIds) =
         // Use modelFileId from map (no fallback to modelDef.id as JsonImportSchema doesn't have id property)
         const finalModelFileId = modelFileId;
         if (!finalModelFileId) {
-            logger$2(`Warning: No modelFileId found for model "${modelName}" - model will be created without ID`);
+            logger$3(`Warning: No modelFileId found for model "${modelName}" - model will be created without ID`);
         }
         // Get propertyFileIds for this model if available
         const modelPropertyFileIds = propertyFileIds?.get(modelName);
@@ -3278,7 +3278,7 @@ var SEEDPROTOCOL_Seed_Protocol_v1 = /*#__PURE__*/Object.freeze({
     version: version
 });
 
-const logger$1 = debug('seedSdk:client:actors:processSchemaFiles');
+const logger$2 = debug('seedSdk:client:actors:processSchemaFiles');
 let processSchemaFilesChain = Promise.resolve();
 function resolveSchemaFilePath(schemaFile) {
     const path = BaseFileManager.getPathModule();
@@ -3306,7 +3306,7 @@ async function resolveSchemaNameFromSource(source) {
             }
         }
         catch (error) {
-            logger$1('Could not resolve schema name from path:', source, error);
+            logger$2('Could not resolve schema name from path:', source, error);
         }
     }
     return null;
@@ -3315,7 +3315,7 @@ async function resolveSchemaNameFromSource(source) {
 // Schema processing can be slow with syncSchemaFromSource, loadAllSchemasFromDb, and OPFS file I/O
 const PROCESS_SCHEMA_FILES_TIMEOUT_MS = 120000;
 const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
-    logger$1('processSchemaFiles started');
+    logger$2('processSchemaFiles started');
     let hasResponded = false;
     let timeoutId = null;
     const reportError = (error) => {
@@ -3325,7 +3325,7 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                 clearTimeout(timeoutId);
                 timeoutId = null;
             }
-            logger$1('processSchemaFiles error:', error);
+            logger$2('processSchemaFiles error:', error);
             sendBack({
                 type: 'error',
                 error: error instanceof Error ? error : new Error(String(error))
@@ -3339,7 +3339,7 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                 clearTimeout(timeoutId);
                 timeoutId = null;
             }
-            logger$1('processSchemaFiles completed');
+            logger$2('processSchemaFiles completed');
             sendBack({ type: ClientManagerEvents.PROCESS_SCHEMA_FILES_SUCCESS });
         }
     };
@@ -3351,7 +3351,7 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
         // Schemas written (or confirmed present) this run — skip redundant loadSchemaFromFile later
         const schemasWrittenThisRun = new Set();
         // First, load the internal seed-protocol schema
-        logger$1('Loading internal seed-protocol schema');
+        logger$2('Loading internal seed-protocol schema');
         const internalSchemaData = internalSchema;
         const db = BaseDb.getAppDb();
         const internalSchemaExists = db
@@ -3360,21 +3360,21 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
         // Always mark internal schema as written so the DB/file loop does not re-apply it
         schemasWrittenThisRun.add(SEED_PROTOCOL_SCHEMA_NAME);
         if (internalSchemaExists) {
-            logger$1('Internal seed-protocol schema already in DB, skipping import');
+            logger$2('Internal seed-protocol schema already in DB, skipping import');
         }
         else {
             try {
                 // Import the internal schema to database (will create models and add to store)
                 await importJsonSchema({ contents: JSON.stringify(internalSchemaData) }, internalSchemaData.version);
-                logger$1(`Loaded internal seed-protocol schema v${internalSchemaData.version}`);
+                logger$2(`Loaded internal seed-protocol schema v${internalSchemaData.version}`);
             }
             catch (error) {
                 // If schema already exists, that's fine - it means it was already loaded
                 if (error?.message?.includes('already exists')) {
-                    logger$1('Internal seed-protocol schema already loaded');
+                    logger$2('Internal seed-protocol schema already loaded');
                 }
                 else {
-                    logger$1('Error loading internal seed-protocol schema:', error);
+                    logger$2('Error loading internal seed-protocol schema:', error);
                     // Don't fail if internal schema can't be loaded - it might already be in DB
                 }
             }
@@ -3387,7 +3387,7 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                 : '';
             const schemaId = typeof context.schema === 'object' && context.schema?.id ? String(context.schema.id) : undefined;
             if (isInternalSchema(schemaName, schemaId)) {
-                logger$1('Schema is internal (Seed Protocol), already loaded - skipping syncSchemaFromSource');
+                logger$2('Schema is internal (Seed Protocol), already loaded - skipping syncSchemaFromSource');
             }
             else {
                 try {
@@ -3396,10 +3396,10 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                     if (syncedName) {
                         schemasWrittenThisRun.add(syncedName);
                     }
-                    logger$1(`Synced canonical schema from ${typeof context.schema === 'string' ? context.schema : 'object'}`);
+                    logger$2(`Synced canonical schema from ${typeof context.schema === 'string' ? context.schema : 'object'}`);
                 }
                 catch (error) {
-                    logger$1(`Error syncing canonical schema:`, error);
+                    logger$2(`Error syncing canonical schema:`, error);
                     // Don't fail init - schema might already be in DB
                 }
             }
@@ -3414,23 +3414,23 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                 if (parsed?.metadata?.name) {
                     schemasWrittenThisRun.add(String(parsed.metadata.name));
                 }
-                logger$1(`Loaded schema from ${resolvedPath}`);
+                logger$2(`Loaded schema from ${resolvedPath}`);
             }
             catch (error) {
-                logger$1(`Error loading schema file ${context.schemaFile}:`, error);
+                logger$2(`Error loading schema file ${context.schemaFile}:`, error);
                 // Don't fail init - schema might already be in DB
             }
         }
         // Process minimal import files (files without $schema) - skip when canonical schema is set
         if (!context.schema) {
-            logger$1('Listing schema files');
+            logger$2('Listing schema files');
             let schemaFiles = [];
             try {
                 schemaFiles = await listSchemaFiles();
-                logger$1(`Found ${schemaFiles.length} schema files to process`);
+                logger$2(`Found ${schemaFiles.length} schema files to process`);
             }
             catch (error) {
-                logger$1('Error listing schema files (continuing anyway):', error);
+                logger$2('Error listing schema files (continuing anyway):', error);
                 schemaFiles = [];
             }
             for (const schemaFile of schemaFiles) {
@@ -3441,19 +3441,19 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                     }
                 }
                 catch (error) {
-                    logger$1(`Error importing schema file ${schemaFile.filePath}:`, error);
+                    logger$2(`Error importing schema file ${schemaFile.filePath}:`, error);
                 }
             }
         }
         // Then, load all schemas using the unified database-first approach
-        logger$1('Loading schemas from database and files');
+        logger$2('Loading schemas from database and files');
         let allSchemasData = [];
         try {
             allSchemasData = await loadAllSchemasFromDb();
-            logger$1(`Loaded ${allSchemasData.length} schemas (${allSchemasData.filter(s => s.isDraft).length} drafts, ${allSchemasData.filter(s => !s.isDraft).length} published)`);
+            logger$2(`Loaded ${allSchemasData.length} schemas (${allSchemasData.filter(s => s.isDraft).length} drafts, ${allSchemasData.filter(s => !s.isDraft).length} published)`);
         }
         catch (error) {
-            logger$1('Error loading schemas from database (continuing anyway):', error);
+            logger$2('Error loading schemas from database (continuing anyway):', error);
             // Continue with empty array - this is not critical for initialization
             // Schemas can be loaded on-demand later
             allSchemasData = [];
@@ -3474,13 +3474,13 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                 }
             }
             catch (error) {
-                logger$1('Error counting linked models (re-applying all schema files):', error);
+                logger$2('Error counting linked models (re-applying all schema files):', error);
             }
         }
         for (const schemaData of allSchemasData) {
             const schema = schemaData.schema;
             const schemaName = schema.metadata?.name || 'unknown';
-            logger$1(`Processing schema: ${schemaName} v${schema.version} (${schemaData.isDraft ? 'draft' : 'published'}, source: ${schemaData.source})`);
+            logger$2(`Processing schema: ${schemaName} v${schema.version} (${schemaData.isDraft ? 'draft' : 'published'}, source: ${schemaData.source})`);
             // For published schemas (not drafts), load models from file if available
             if (!schemaData.isDraft && schema.id) {
                 // loadAllSchemasFromDb already picked the latest file for this schema (and read it)
@@ -3510,7 +3510,7 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                         }
                     }
                     catch (error) {
-                        logger$1(`Error loading schema file for ${schemaName}:`, error);
+                        logger$2(`Error loading schema file for ${schemaName}:`, error);
                     }
                 }
                 else {
@@ -3559,11 +3559,11 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                             };
                             const modelDefinitions = await createModelsFromJson(importData, modelFileIds, propertyFileIds);
                             Object.assign(allModels, modelDefinitions);
-                            logger$1(`Loaded ${Object.keys(modelDefinitions).length} models from schema data for ${schemaName}`);
+                            logger$2(`Loaded ${Object.keys(modelDefinitions).length} models from schema data for ${schemaName}`);
                         }
                     }
                     catch (error) {
-                        logger$1(`Error creating models from schema data for ${schemaName}:`, error);
+                        logger$2(`Error creating models from schema data for ${schemaName}:`, error);
                     }
                 }
             }
@@ -3613,11 +3613,11 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
                         };
                         const modelDefinitions = await createModelsFromJson(importData, modelFileIds, propertyFileIds);
                         Object.assign(allModels, modelDefinitions);
-                        logger$1(`Loaded ${Object.keys(modelDefinitions).length} models from draft schema ${schemaName}`);
+                        logger$2(`Loaded ${Object.keys(modelDefinitions).length} models from draft schema ${schemaName}`);
                     }
                 }
                 catch (error) {
-                    logger$1(`Error creating models from draft schema ${schemaName}:`, error);
+                    logger$2(`Error creating models from draft schema ${schemaName}:`, error);
                 }
             }
             // Schemas are now loaded on-demand via database queries (useSchemas hook uses loadAllSchemasFromDb)
@@ -3635,7 +3635,7 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
         // Its schema and model inserts check for rows first, so tabs take turns (docs/MULTI_TAB.md).
         .then(() => withSeedDbLock('init', context.filesDir, _processSchemaFiles))
         .catch((err) => {
-        logger$1('processSchemaFiles chain error:', err);
+        logger$2('processSchemaFiles chain error:', err);
         throw err;
     });
     processSchemaFilesChain.then(reportSuccess).catch((error) => {
@@ -3650,6 +3650,285 @@ const processSchemaFiles = fromCallback(({ sendBack, input: { context } }) => {
     };
 });
 
+/**
+ * A legacy ItemStorage draft row: a local edit (no attestation uid, not derived from one) that holds
+ * the content itself in property_value, with no file reference. Item.create / createNewItem stored
+ * ItemStorage values like this before they went through the save pipeline.
+ */
+const isVerbatimItemStorageDraftRow = (row) => !row.uid &&
+    row.derivedFromUid == null &&
+    !row.refResolvedValue &&
+    typeof row.propertyValue === 'string' &&
+    row.propertyValue !== '';
+/**
+ * Convert one legacy ItemStorage draft row (see {@link isVerbatimItemStorageDraftRow}) into the
+ * shape saveItemStorage gives a row: the content goes to the file a save would write
+ * (`<seedUid or seedLocalId><extension>` in the property's storage directory), and the row records
+ * `refResolvedValue`, `localStorageDir` and `refValueType: 'file'` with property_value cleared.
+ * Used by publish (resolveItemStorageChildFile) and the one-time migration (migrateLegacyItemStorageRows).
+ *
+ * Reading the row, writing the file and updating the row happen under the file's lock
+ * ({@link withItemStorageFileLock}), which saveItemStorage holds too: a save in this or another tab
+ * either finishes before (the row, read again once the lock is held, is no longer legacy and is
+ * left alone) or starts after (and overwrites the file and row with its content). Without the lock
+ * a save landing between the read and the file write would have its file overwritten with the old
+ * content. The row update also stays conditional on the row being unchanged, for writers that
+ * don't take the lock (a tab still running an older SDK).
+ *
+ * Returns undefined when there was nothing to convert. Throws when the file can't be written; the
+ * row is then unchanged.
+ */
+const convertVerbatimItemStorageRow = async (localId, storage = {}) => {
+    const appDb = BaseDb.getAppDb();
+    if (!appDb || !localId)
+        return undefined;
+    const targetOf = (row) => {
+        if (!isVerbatimItemStorageDraftRow(row))
+            return undefined;
+        const seedId = storage.seedId || row.seedUid || row.seedLocalId;
+        if (!seedId)
+            return undefined;
+        return {
+            seedId,
+            localStorageDir: storage.localStorageDir || row.localStorageDir,
+            filenameSuffix: storage.filenameSuffix,
+        };
+    };
+    return withLockedItemStorageRow(localId, (row) => {
+        const target = targetOf(row);
+        return target && getItemStorageFilePath(target);
+    }, async (row) => {
+        const content = row.propertyValue;
+        const { fileName, filePath, localStorageDir } = await writeItemStorageFile(targetOf(row), content);
+        await appDb
+            .update(metadata$1)
+            .set({ refResolvedValue: fileName, localStorageDir, refValueType: 'file', propertyValue: null })
+            .where(and(eq(metadata$1.localId, localId), isNull(metadata$1.refResolvedValue), eq(metadata$1.propertyValue, content)));
+        // Changed between the read and the update by a writer outside the lock: that change stands.
+        const after = await appDb
+            .select({ refResolvedValue: metadata$1.refResolvedValue, propertyValue: metadata$1.propertyValue })
+            .from(metadata$1)
+            .where(eq(metadata$1.localId, localId))
+            .limit(1);
+        if (after[0]?.refResolvedValue !== fileName || after[0]?.propertyValue != null)
+            return undefined;
+        return { fileName, filePath, localStorageDir, content };
+    });
+};
+
+const logger$1 = debug('seedSdk:db:migrateLegacyItemStorageRows');
+/** appState key recording that legacy ItemStorage rows have been written to their files. */
+const LEGACY_ITEM_STORAGE_MIGRATION_KEY = 'legacyItemStorageFiles:v1';
+/** Runs in a row that left rows unconverted because a file write failed, before giving up. */
+const LEGACY_ITEM_STORAGE_MIGRATION_MAX_ATTEMPTS = 3;
+const readMarker = async () => {
+    const db = BaseDb.getAppDb();
+    const rows = await db
+        .select({ value: appState.value })
+        .from(appState)
+        .where(eq(appState.key, LEGACY_ITEM_STORAGE_MIGRATION_KEY))
+        .limit(1);
+    if (!rows.length)
+        return undefined;
+    try {
+        return JSON.parse(rows[0].value ?? '');
+    }
+    catch {
+        return null;
+    }
+};
+const writeMarker = async (marker) => {
+    const db = BaseDb.getAppDb();
+    const now = Date.now();
+    const value = JSON.stringify(marker);
+    await db
+        .insert(appState)
+        .values({ key: LEGACY_ITEM_STORAGE_MIGRATION_KEY, value, createdAt: now, updatedAt: now })
+        .onConflictDoUpdate({ target: appState.key, set: { value, updatedAt: now } });
+};
+/**
+ * The storage settings of a metadata row's property: by its property_id, else by name in the
+ * seed's own model (model names are only unique per schema). Undefined when it can't be told.
+ */
+const createStorageResolver = () => {
+    const db = BaseDb.getAppDb();
+    const byPropertyId = new Map();
+    const byModelAndName = new Map();
+    return async (row) => {
+        if (row.propertyId != null) {
+            if (!byPropertyId.has(row.propertyId)) {
+                const found = await db
+                    .select({
+                    storageType: properties.storageType,
+                    localStorageDir: properties.localStorageDir,
+                    filenameSuffix: properties.filenameSuffix,
+                })
+                    .from(properties)
+                    .where(eq(properties.id, row.propertyId))
+                    .limit(1);
+                byPropertyId.set(row.propertyId, found[0]);
+            }
+            const fromId = byPropertyId.get(row.propertyId);
+            if (fromId)
+                return fromId;
+        }
+        const modelFileId = await resolveItemModelFileId({ seedLocalId: row.seedLocalId, seedUid: row.seedUid });
+        if (!modelFileId || !row.propertyName)
+            return undefined;
+        const key = `${modelFileId}\u0000${row.propertyName}`;
+        if (!byModelAndName.has(key)) {
+            const found = await db
+                .select({
+                storageType: properties.storageType,
+                localStorageDir: properties.localStorageDir,
+                filenameSuffix: properties.filenameSuffix,
+            })
+                .from(properties)
+                .innerJoin(models$1, eq(properties.modelId, models$1.id))
+                .where(and(eq(models$1.schemaFileId, modelFileId), eq(properties.name, row.propertyName)))
+                .limit(1);
+            byModelAndName.set(key, found[0]);
+        }
+        return byModelAndName.get(key);
+    };
+};
+/** True if `row` is the row readers show for its property: the newest of its seed's rows by that name. */
+const isNewestRowOfProperty = async (row) => {
+    if (!row.seedLocalId || !row.propertyName)
+        return false;
+    const db = BaseDb.getAppDb();
+    const siblings = await db
+        .select()
+        .from(metadata$1)
+        .where(and(eq(metadata$1.seedLocalId, row.seedLocalId), eq(metadata$1.propertyName, row.propertyName)));
+    return [...siblings].sort(compareMetadataRowsLatestFirst)[0]?.localId === row.localId;
+};
+/**
+ * One-time data migration: writes the content of legacy ItemStorage draft rows to their files.
+ *
+ * Before Item.create / createNewItem saved ItemStorage values through the save pipeline, a value
+ * given at creation was stored verbatim in metadata.property_value with no file. Publish converts
+ * such a row lazily (resolveItemStorageChildFile); this converts them all up front, with the same
+ * code ({@link convertVerbatimItemStorageRow}), so every ItemStorage draft has the shape a save
+ * gives it: the content in `<seedUid or seedLocalId><extension>`, the row holding
+ * refResolvedValue / localStorageDir / refValueType 'file' and no property_value.
+ *
+ * Only local drafts (no uid, not derived from an attestation) of properties whose properties row
+ * says `storage_type = 'ItemStorage'` are touched, and of those only the newest row of each
+ * seed's property: that is the row reads show and saves write to, and older rows sharing the one
+ * file name would overwrite it with older content. Published and synced rows are never changed.
+ *
+ * A row that fails is logged and left as it was (publish still converts it). The run is recorded
+ * in appState under {@link LEGACY_ITEM_STORAGE_MIGRATION_KEY}; a run with failed rows is retried
+ * on the next start, up to {@link LEGACY_ITEM_STORAGE_MIGRATION_MAX_ATTEMPTS} runs. Safe to run
+ * again regardless: a converted row no longer matches.
+ *
+ * @param options.force run even when the marker says it is done
+ */
+async function migrateLegacyItemStorageRows(options = {}) {
+    const result = {
+        alreadyDone: false,
+        candidates: 0,
+        converted: 0,
+        failed: 0,
+        skipped: 0,
+    };
+    const db = BaseDb.getAppDb();
+    if (!db)
+        return { ...result, alreadyDone: true };
+    const marker = await readMarker();
+    const previousAttempts = marker?.status === 'retry' ? marker.attempts : 0;
+    if (!options.force && marker && marker.status === 'done') {
+        return { ...result, alreadyDone: true };
+    }
+    const itemStorageNames = (await db
+        .selectDistinct({ name: properties.name })
+        .from(properties)
+        .where(eq(properties.storageType, 'ItemStorage'))).map((r) => r.name);
+    const candidates = itemStorageNames.length
+        ? await db
+            .select()
+            .from(metadata$1)
+            .where(and(inArray(metadata$1.propertyName, itemStorageNames), or(isNull(metadata$1.uid), eq(metadata$1.uid, '')), isNull(metadata$1.derivedFromUid), isNull(metadata$1.refResolvedValue), isNotNull(metadata$1.propertyValue), ne(metadata$1.propertyValue, '')))
+        : [];
+    const resolveStorage = createStorageResolver();
+    for (const row of candidates) {
+        if (!row.localId || !isVerbatimItemStorageDraftRow(row))
+            continue;
+        try {
+            const storage = await resolveStorage(row);
+            if (storage?.storageType !== 'ItemStorage')
+                continue;
+            result.candidates++;
+            if (!(await isNewestRowOfProperty(row))) {
+                result.skipped++;
+                continue;
+            }
+            const converted = await convertVerbatimItemStorageRow(row.localId, {
+                localStorageDir: storage.localStorageDir,
+                filenameSuffix: storage.filenameSuffix,
+            });
+            if (converted) {
+                result.converted++;
+                logger$1(`wrote ${row.propertyName} of ${row.seedLocalId} to ${converted.filePath}`);
+            }
+            else {
+                result.skipped++;
+            }
+        }
+        catch (error) {
+            result.failed++;
+            logger$1(`converting ${row.propertyName} of ${row.seedLocalId} (${row.localId}) failed; left as is`, error);
+        }
+    }
+    const attempts = previousAttempts + 1;
+    await writeMarker({
+        status: result.failed > 0 && attempts < LEGACY_ITEM_STORAGE_MIGRATION_MAX_ATTEMPTS ? 'retry' : 'done',
+        attempts,
+        converted: result.converted,
+        failed: result.failed,
+        at: Date.now(),
+    });
+    if (result.candidates > 0) {
+        logger$1(`legacy ItemStorage rows: ${result.converted} converted, ${result.failed} failed, ` +
+            `${result.skipped} skipped of ${result.candidates}`);
+    }
+    return result;
+}
+let running;
+let deferredUntilLeader = false;
+const runInBackground = () => {
+    running ?? (running = withDbTabLock('item-storage-migration', () => migrateLegacyItemStorageRows())
+        .then(() => undefined)
+        .catch((error) => {
+        // Never fails init: rows stay as they were and publish converts them lazily.
+        logger$1('legacy ItemStorage migration failed', error);
+    })
+        .finally(() => {
+        running = undefined;
+    }));
+    return running;
+};
+/**
+ * Starts {@link migrateLegacyItemStorageRows} in the background once client init has finished
+ * (the properties table then holds the current storage settings). It runs in the leader tab only
+ * (docs/MULTI_TAB.md), under a `seed:item-storage-migration:<db>` lock in case several tabs lead
+ * (`multiTab: 'off'`); a tab that isn't leader runs it if it takes over. Never throws.
+ */
+function startLegacyItemStorageMigration() {
+    if (isLeaderTab()) {
+        void runInBackground();
+        return;
+    }
+    if (deferredUntilLeader)
+        return;
+    deferredUntilLeader = true;
+    void whenLeaderTab().then(() => {
+        deferredUntilLeader = false;
+        void runInBackground();
+    });
+}
+
 const { UNINITIALIZED, PLATFORM_CLASSES_INIT, FILE_SYSTEM_INIT, DB_INIT, SAVE_CONFIG, PROCESS_SCHEMA_FILES, ADD_MODELS_TO_STORE, ADD_MODELS_TO_DB, IDLE, INIT_FAILED, } = ClientManagerState;
 const { UPDATE_CONTEXT, PLATFORM_CLASSES_READY, FILE_SYSTEM_READY, DB_READY, SAVE_CONFIG_SUCCESS, SAVE_APP_STATE_SUCCESS, SAVE_APP_STATE_ERROR, SET_ADDRESSES, ADD_MODELS_TO_STORE_SUCCESS, ADD_MODELS_TO_DB_SUCCESS, PROCESS_SCHEMA_FILES_SUCCESS, } = ClientManagerEvents;
 const logSyncAfterAddressSave = debug("seedSdk:client:clientManagerMachine:syncAfterAddressSave");
@@ -3870,9 +4149,15 @@ const clientManagerMachine = setup({
             },
         },
         [IDLE]: {
-            entry: assign({
-                isInitialized: true,
-            }),
+            entry: [
+                assign({
+                    isInitialized: true,
+                }),
+                // One-time data migration that writes files, so it can't be a SQL migration in prepareDb.
+                // In the background after init: the app is usable at once, the properties table holds the
+                // current storage settings by now, and a failure never fails init.
+                () => startLegacyItemStorageMigration(),
+            ],
             on: {
                 [SAVE_APP_STATE_SUCCESS]: {
                     actions: [
@@ -4764,5 +5049,5 @@ var ClientManager$1 = /*#__PURE__*/Object.freeze({
     getClient: getClient
 });
 
-export { startEasSyncActor as A, unregisterSeedQueryLocalSource as B, ClientManager as C, createModelsFromJson as D, EAS_CHAIN_ID_APP_STATE_KEY as E, getLatestSchemaVersion as F, schema as G, ClientManager$1 as H, SEEDPROTOCOL_Seed_Protocol_v1 as S, assertLocalDbChain as a, getRefValueType as b, claimUnpublishedDrafts as c, createLocalQueryDataSource as d, createSchema as e, easSyncActor as f, getContentHash as g, getClient as h, importJsonSchema as i, getPublishedSeedRecord as j, getSchemaNameFromId as k, loadSchemaFromFile as l, isSeedQueryLocalSourceRegistered as m, listCompleteSchemaFiles as n, loadAllSchemasFromDb as o, mergeEasSyncRequestIntents as p, readSchema as q, readJsonImportFile as r, syncSchemaFromSource as s, transformImportToSchemaFile as t, registerSeedQueryLocalSource as u, requestEasSyncFromAddressChange as v, waitForEasReadChain as w, requestEasSyncFromEventBus as x, requestEasSyncFromModelsInit as y, sendEasSyncClientRequest as z };
-//# sourceMappingURL=ClientManager-DDA9956Y.js.map
+export { requestEasSyncFromModelsInit as A, sendEasSyncClientRequest as B, ClientManager as C, startEasSyncActor as D, EAS_CHAIN_ID_APP_STATE_KEY as E, unregisterSeedQueryLocalSource as F, createModelsFromJson as G, getLatestSchemaVersion as H, schema as I, ClientManager$1 as J, SEEDPROTOCOL_Seed_Protocol_v1 as S, assertLocalDbChain as a, importJsonSchema as b, convertVerbatimItemStorageRow as c, getContentHash as d, claimUnpublishedDrafts as e, createLocalQueryDataSource as f, getRefValueType as g, createSchema as h, isVerbatimItemStorageDraftRow as i, easSyncActor as j, getClient as k, loadSchemaFromFile as l, getPublishedSeedRecord as m, getSchemaNameFromId as n, isSeedQueryLocalSourceRegistered as o, listCompleteSchemaFiles as p, loadAllSchemasFromDb as q, readJsonImportFile as r, syncSchemaFromSource as s, transformImportToSchemaFile as t, mergeEasSyncRequestIntents as u, readSchema as v, waitForEasReadChain as w, registerSeedQueryLocalSource as x, requestEasSyncFromAddressChange as y, requestEasSyncFromEventBus as z };
+//# sourceMappingURL=ClientManager-C-QXqUK9.js.map