@seedprotocol/sdk 0.7.9 → 0.7.10-next.1353.g74aeeed

package/dist/src/Model/Model.d.ts

@@ -4,8 +4,20 @@ import { Item } from '../Item/Item';
 import { ItemData } from '../types/item';
 import { EntityCache } from '../helpers/entity/entityCache';
 type ModelService = ActorRefFrom<typeof modelMachine>;
+/**
+ * `hold` for Model lookups. A model stays cached whether or not anyone holds it (see `Model.cache`),
+ * so a hold only counts this caller; `unload()` gives it back.
+ */
+export type ModelHoldOption = {
+    /** Take a cache hold, released with `unload()`. Default false. */
+    hold?: boolean;
+};
 export declare class Model {
-    /** Cached under its id and `schemaName:modelName` (ADR 0014). */
+    /**
+     * Cached under its id and `schemaName:modelName` (ADR 0014). Stays cached with no holds until it
+     * is destroyed or evicted (`unloadUnheld: false`): Model.resolve, findByModelType and sync read
+     * the cache synchronously.
+     */
     static readonly cache: EntityCache<Model>;
     protected readonly _service: ModelService;
     modelName?: string;
@@ -73,9 +85,7 @@ export declare class Model {
         waitForReady: false;
         /** @internal Schema import: see the implementation signature */
         persistedBy?: Promise<unknown>;
-        /** @internal SDK lookups pass false: see the implementation signature */
-        hold?: false;
-    }): Model;
+    } & ModelHoldOption): Model;
     static create(modelName: string, schemaNameOrSchema: string | any, options?: {
         id?: string;
         modelFileId?: string;
@@ -85,30 +95,30 @@ export declare class Model {
         registerWithSchema?: boolean;
         waitForReady?: true;
         readyTimeout?: number;
-        /** @internal SDK lookups pass false: see the implementation signature */
-        hold?: false;
-    }): Promise<Model>;
+    } & ModelHoldOption): Promise<Model>;
+    /** The model once ready; a call that took a hold gives it back when the model isn't ready in time. */
+    private static readyOrRelease;
+    /** The cached Model with this modelFileId. Takes no hold unless `hold: true`. */
+    static getById(modelFileId: string, options?: ModelHoldOption): Model | undefined;
     /**
-     * Get Model instance by modelFileId (O(1) lookup). Takes a hold on the instance; release it with
-     * `unload()`.
+     * The cached Model with this modelFileId, without taking a hold.
      */
-    static getById(modelFileId: string): Model | undefined;
+    static peek(modelFileId: string): Model | undefined;
     /**
-     * The cached Model with this modelFileId, without taking a hold. For SDK code that reads the
-     * model and doesn't hand it to a caller; callers that keep it use `getById`, `find` or `create`.
+     * Takes one more hold on a cached, running instance, released with `unload()`. False (and no
+     * hold) when the instance isn't cached or was stopped.
      */
-    static peek(modelFileId: string): Model | undefined;
+    static retain(instance: Model): boolean;
     /**
-     * Get Model instance by name (O(1) lookup via name→ID mapping). Takes a hold on the instance;
-     * release it with `unload()`.
+     * Get Model instance by name (O(1) lookup via name→ID mapping). Takes no hold unless `hold: true`.
      *
      * @param modelName - The name of the model
      * @param schemaName - The schema name (optional, will query DB if not provided)
      * @returns The Model instance if found, undefined otherwise
      */
-    static getByName(modelName: string, schemaName?: string): Model | undefined;
+    static getByName(modelName: string, schemaName?: string, options?: ModelHoldOption): Model | undefined;
     /**
-     * `getByName` without taking a hold. Without `schemaName` it searches every cached schema and
+     * The cached Model by name, without taking a hold. Without `schemaName` it searches every cached schema and
      * throws AmbiguousModelError when models from several schemas share the name; callers that know
      * the schema or model id should use Model.resolve() instead.
      */
@@ -152,7 +162,7 @@ export declare class Model {
      *
      * @param modelName - The name of the model
      * @param schemaName - Optional schema name (will query DB if not provided)
-     * @returns The Model instance if found, undefined otherwise. Takes a hold unless `hold: false`.
+     * @returns The Model instance if found, undefined otherwise. Takes no hold unless `hold: true`.
      */
     static getByNameAsync(modelName: string, schemaName?: string, options?: {
         /**
@@ -160,15 +170,13 @@ export declare class Model {
          * schema since then makes this return undefined instead of re-creating the model. Defaults to now.
          */
         since?: number;
-        /** @internal `hold: false` as for `create` */
-        hold?: false;
-    }): Promise<Model | undefined>;
+    } & ModelHoldOption): Promise<Model | undefined>;
     /**
      * Create or get Model instance by modelFileId
      * Checks cache first, then database if not found
      *
      * @param modelFileId - The model file ID to look up
-     * @returns The Model instance if found, undefined otherwise
+     * @returns The Model instance if found, undefined otherwise. Takes no hold unless `hold: true`.
      */
     static createById(modelFileId: string, options?: {
         /**
@@ -177,41 +185,41 @@ export declare class Model {
          * of re-creating the model. Defaults to now.
          */
         since?: number;
-        /** @internal `hold: false` as for `create` */
-        hold?: false;
-    }): Promise<Model | undefined>;
+    } & ModelHoldOption): Promise<Model | undefined>;
     /**
      * Find Model instance by modelFileId, modelName/schemaName, or both
-     * Waits for the model to be fully loaded (idle state) by default
+     * Waits for the model to be fully loaded (idle state) by default. Takes no hold unless
+     * `hold: true`; a call that throws (the model isn't ready in `readyTimeout`) keeps none.
      * @param options - Find options including lookup parameters and wait configuration
      * @returns Model instance if found, undefined otherwise
      */
-    static find({ modelFileId, modelName, schemaName, waitForReady, readyTimeout, }: {
+    static find({ modelFileId, modelName, schemaName, waitForReady, readyTimeout, hold, }: {
         modelFileId?: string;
         modelName?: string;
         schemaName?: string;
         waitForReady?: boolean;
         readyTimeout?: number;
-    }): Promise<Model | undefined>;
+    } & ModelHoldOption): Promise<Model | undefined>;
     /**
      * Get all Model instances for a schema by schemaFileId or schemaName
      * Queries database for all models with the given schemaId/schemaName and returns Model instances
      *
      * @param schemaIdentifier - The schema file ID or schema name to get models for
-     * @returns Array of Model instances for the schema
+     * @returns Array of Model instances for the schema. Takes no holds unless `hold: true`.
      */
-    static createBySchemaId(schemaIdentifier: string): Promise<Model[]>;
+    static createBySchemaId(schemaIdentifier: string, options?: ModelHoldOption): Promise<Model[]>;
     /**
      * Get all Model instances, optionally filtered by schema.
      * When DB is available, loads from DB via getModelsData; otherwise returns from cache.
      * With waitForReady, waits for each model to be ready (idle, with any properties from Model.create
-     * created) and leaves out models that error or time out. Takes no holds: a caller that keeps a
-     * model uses `Model.find` or `Model.create`.
+     * created) and leaves out models that error or time out. Takes no holds unless `hold: true`.
      */
     static all(schemaName?: string, options?: {
         waitForReady?: boolean;
         readyTimeout?: number;
-    }): Promise<Model[]>;
+    } & ModelHoldOption): Promise<Model[]>;
+    /** Throws EntityUnloadedError, naming the model, when this instance was destroyed or evicted. */
+    private _assertLoaded;
     getService(): ModelService;
     private _getSnapshot;
     private _getSnapshotContext;
@@ -278,7 +286,10 @@ export declare class Model {
      * @returns names of the evicted models (so callers can evict their ModelProperty instances)
      */
     static evictForSchema(schemaName: string): string[];
-    /** Release this caller's hold. The model is stopped and leaves the cache with its last hold. */
+    /**
+     * Release this caller's hold, if it took one. The model stays cached (see `Model.cache`); only
+     * `destroy`, eviction or client stop stop it.
+     */
     unload(): void;
     /**
      * Destroy the model: delete its rows (model, its properties, its schema links), remove it from its

package/dist/src/Model/Model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../../src/Model/Model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsC,MAAM,QAAQ,CAAA;AACzE,OAAO,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAA;AAI1E,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAElC,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAA;AAYvC,OAAO,EAAE,WAAW,EAAe,MAAM,8BAA8B,CAAA;AAuBvE,KAAK,YAAY,GAAG,YAAY,CAAC,OAAO,YAAY,CAAC,CAAA;AAgFrD,qBAAa,KAAK;IAChB,iEAAiE;IACjE,MAAM,CAAC,QAAQ,CAAC,KAAK,qBAA2B;IAEhD,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,YAAY,CAAA;IAEzC,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,GAAG,EAAE,CAAA;gBAIjB,SAAS,EAAE,MAAM,EACjB,UAAU,EAAE,MAAM,EAClB,EAAE,CAAC,EAAE,MAAM,EAAE,oCAAoC;IACjD,cAAc,CAAC,EAAE,IAAI,CAAC,mBAAmB,EAAE,6BAA6B,CAAC,EACzE,YAAY,CAAC,EAAE,OAAO;IAqBxB;;;OAGG;mBACkB,IAAI;IAiBzB;;;;OAIG;mBACkB,eAAe;IAkDpC;;;;OAIG;IACH,OAAO,CAAC,MAAM,CAAC,cAAc;IAI7B,qFAAqF;IACrF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE;IAUxE;;;;;;;;OAQG;IACH,MAAM,CAAC,mBAAmB,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,aAAa,GAAE,OAAe,GAAG,MAAM;IAmCzG;;;;;;;;;;;;;;;;;;;OAmBG;IACH,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GAAG,GAAG,EAAE,uDAAuD;IACzF,OAAO,EAAE;QACP,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,UAAU,CAAC,EAAE;YAAE,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAA;QAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAA;QAC5B,YAAY,EAAE,KAAK,CAAA;QACnB,gEAAgE;QAChE,WAAW,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;QAC9B,yEAAyE;QACzE,IAAI,CAAC,EAAE,KAAK,CAAA;KACb,GACA,KAAK;IACR,MAAM,CAAC,MAAM,CACX,SAAS,EAAE,MAAM,EACjB,kBAAkB,EAAE,MAAM,GAAG,GAAG,EAChC,OAAO,CAAC,EAAE;QACR,EAAE,CAAC,EAAE,MAAM,CAAA;QACX,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,UAAU,CAAC,EAAE;YAAE,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAA;SAAE,CAAA;QAC5C,kBAAkB,CAAC,EAAE,OAAO,CAAA;QAC5B,YAAY,CAAC,EAAE,IAAI,CAAA;QACnB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,yEAAyE;QACzE,IAAI,CAAC,EAAE,KAAK,CAAA;KACb,GACA,OAAO,CAAC,KAAK,CAAC;IAgMjB;;;OAGG;IACH,MAAM,CAAC,OAAO,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAItD;;;OAGG;IACH,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAInD;;;;;;;OAOG;IACH,MAAM,CAAC,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAK3E;;;;OAIG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAK5E;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,qBAAqB;IAepC;;;OAGG;IACH,MAAM,CAAC,OAAO,CACZ,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,GACtE,KAAK,GAAG,SAAS;IAapB;;;;;OAKG;IACH,MAAM,CAAC,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS;IAS5D;;;OAGG;IACH,MAAM,CAAC,2BAA2B,CAAC,UAAU,EAAE,MAAM,GAAG,KAAK,EAAE;IAI/D;;;OAGG;WACU,YAAY,CACvB,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,GAAE;QAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAO,GACtE,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAoC7B;;;;;;;OAOG;WACU,cAAc,CACzB,SAAS,EAAE,MAAM,EACjB,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR;;;WAGG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,8CAA8C;QAC9C,IAAI,CAAC,EAAE,KAAK,CAAA;KACb,GACA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IA0C7B;;;;;;OAMG;WACU,UAAU,CACrB,WAAW,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QACR;;;;WAIG;QACH,KAAK,CAAC,EAAE,MAAM,CAAA;QACd,8CAA8C;QAC9C,IAAI,CAAC,EAAE,KAAK,CAAA;KACb,GACA,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAiE7B;;;;;OAKG;WACU,IAAI,CAAC,EAChB,WAAW,EACX,SAAS,EACT,UAAU,EACV,YAAmB,EACnB,YAAuC,GACxC,EAAE;QACD,WAAW,CAAC,EAAE,MAAM,CAAA;QACpB,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,UAAU,CAAC,EAAE,MAAM,CAAA;QACnB,YAAY,CAAC,EAAE,OAAO,CAAA;QACtB,YAAY,CAAC,EAAE,MAAM,CAAA;KACtB,GAAG,OAAO,CAAC,KAAK,GAAG,SAAS,CAAC;IAU9B;;;;;;OAMG;WACU,gBAAgB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,EAAE,CAAC;IAqEzE;;;;;;OAMG;WACU,GAAG,CACd,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,CAAC,EAAE;QAAE,YAAY,CAAC,EAAE,OAAO,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,GAC1D,OAAO,CAAC,KAAK,EAAE,CAAC;IAqDnB,UAAU,IAAI,YAAY;IAI1B,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,mBAAmB;IAI3B;;;OAGG;YACW,kBAAkB;IAqChC;;;;;OAKG;YACW,cAAc;IA2C5B,4FAA4F;IAC5F,YAAY,CAAC,OAAO,CAAC,EAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3D,gHAAgH;IAChH,IAAI,MAAM,4DAET;IAED,mGAAmG;IACnG,IAAI,aAAa,IAAI,KAAK,GAAG,SAAS,CAErC;IAED,IAAI,gBAAgB,mCAEnB;IAED,IAAI,OAAO,YAGV;IAED,IAAI,QAAQ,YAcX;IAED,IAAI,EAAE,uBAEL;IAED,IAAI,IAAI,WAEP;IAED;;;;OAIG;IACH,IAAI,UAAU,IAAI,GAAG,EAAE,CAkCtB;IAED;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,GAAG,EAAE,CAAA;KAAE,CAAC;IAQ9D;;;;;;;;;;OAUG;IACG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAejF;;;OAGG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAM7B;;;;;OAKG;IACH,MAAM,CAAC,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,EAAE;IAYnD,gGAAgG;IAChG,MAAM,IAAI,IAAI;IAId;;;OAGG;IACG,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAuD9B;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IA2GnC;;OAEG;YACW,wBAAwB;IAoEtC;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;;;OAIG;WACU,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAMnE"}
+{"version":3,"file":"Model.d.ts","sourceRoot":"","sources":["../../../src/Model/Model.ts"],"names":[],"mappings":"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"}

package/dist/src/ModelProperty/ModelProperty.d.ts

@@ -8,8 +8,8 @@ import { EntityCache } from '../helpers/entity/entityCache';
 type ModelPropertyService = ActorRefFrom<typeof modelPropertyMachine>;
 export declare class ModelProperty {
     /**
-     * Cached under its id (schemaFileId) and `modelName:name` (ADR 0014). Its model holds it (see
-     * holdForModel), so app holders' unloads don't stop a model's property.
+     * Cached under its id (schemaFileId) and `modelName:name` (ADR 0014). Stays cached with no holds
+     * until it is destroyed or evicted (`unloadUnheld: false`), as Schema and Model do.
      */
     static readonly cache: EntityCache<ModelProperty>;
     private static pendingWrites;
@@ -82,16 +82,18 @@ export declare class ModelProperty {
     static create(property: Static<typeof TProperty>, options: {
         waitForReady: false;
         schemaName?: string;
-        /** @internal false for the SDK's own loads (a model's properties): no hold is taken */
-        hold?: false;
+        /** Take a cache hold, released with `unload()`. Default false: a property stays cached without one. */
+        hold?: boolean;
     }): ModelProperty;
     static create(property: Static<typeof TProperty>, options?: {
         waitForReady?: true;
         readyTimeout?: number;
         schemaName?: string;
-        /** @internal false for the SDK's own loads (a model's properties): no hold is taken */
-        hold?: false;
+        /** Take a cache hold, released with `unload()`. Default false: a property stays cached without one. */
+        hold?: boolean;
     }): Promise<ModelProperty>;
+    /** The property once ready; a call that took a hold gives it back when it isn't ready in time. */
+    private static readyOrRelease;
     /**
      * Writes the row of a property ModelProperty.create made, under the model row its modelId (row id
      * or file id) or modelName names. Resolves without writing once the instance is stopped; rejects
@@ -105,13 +107,23 @@ export declare class ModelProperty {
      * @internal Used by the model's property loading.
      */
     static holdForModel(instance: ModelProperty, model?: Model): void;
-    /** The cached ModelProperty with this propertyFileId, without taking a hold. */
-    static getById(propertyFileId: string): ModelProperty | undefined;
+    /** The cached ModelProperty with this propertyFileId. Takes no hold unless `hold: true`. */
+    static getById(propertyFileId: string, options?: {
+        hold?: boolean;
+    }): ModelProperty | undefined;
+    /**
+     * Takes one more hold on a cached, running instance, released with `unload()`. False (and no
+     * hold) when the instance isn't cached or was stopped.
+     */
+    static retain(instance: ModelProperty): boolean;
     /**
      * Create or get ModelProperty instance by propertyFileId
-     * Queries the database to find the property if not cached
+     * Queries the database to find the property if not cached. Takes no hold unless `hold: true`
+     * (its model holds it either way).
      */
     static createById(propertyFileId: string, options?: {
+        /** Take a cache hold, released with `unload()`. Default false. */
+        hold?: boolean;
         /**
          * evictionLog.now() from when the caller's work started. An eviction of the property's model
          * or schema since then makes this return undefined instead of re-creating it. Defaults to now.
@@ -128,22 +140,26 @@ export declare class ModelProperty {
     static refreshFromDb(propertyFileIds: string[]): Promise<void>;
     /**
      * Find ModelProperty instance by propertyFileId
-     * Waits for the property to be fully loaded (idle state) by default
+     * Waits for the property to be fully loaded (idle state) by default. Takes no hold unless
+     * `hold: true`; a call that throws keeps none.
      * @param options - Find options including propertyFileId and wait configuration
      * @returns ModelProperty instance if found, undefined otherwise
      */
-    static find({ propertyFileId, waitForReady, readyTimeout, }: {
+    static find({ propertyFileId, waitForReady, readyTimeout, hold, }: {
         propertyFileId: string;
         waitForReady?: boolean;
         readyTimeout?: number;
+        hold?: boolean;
     }): Promise<ModelProperty | undefined>;
     /**
      * Get all ModelProperty instances for a model.
      * Loads property rows from DB for the given modelFileId, creates instances via createById, optionally waits for idle.
+     * Takes no holds unless `hold: true`.
      */
     static all(modelFileId: string, options?: {
         waitForReady?: boolean;
         readyTimeout?: number;
+        hold?: boolean;
     }): Promise<ModelProperty[]>;
     /**
      * Track a pending write for a property
@@ -168,6 +184,8 @@ export declare class ModelProperty {
      * Used to resolve modelName when validating a just-created property rename.
      */
     static getPendingModelId(propertyFileId: string): number | undefined;
+    /** Throws EntityUnloadedError, naming the property, when this instance was destroyed or evicted. */
+    private _assertLoaded;
     getService(): ModelPropertyService;
     private _getSnapshot;
     _getSnapshotContext(): ModelPropertyMachineContext;
@@ -213,8 +231,8 @@ export declare class ModelProperty {
         modelId?: number;
     }): void;
     /**
-     * Releases this caller's hold. The instance is shared: it keeps running while other callers hold
-     * it, or while its model holds it. An instance nobody else holds is stopped and leaves the cache.
+     * Releases this caller's hold, if it took one. The property stays cached (see
+     * `ModelProperty.cache`); only `destroy`, eviction or client stop stop it.
      */
     unload(): void;
     /**

package/dist/src/ModelProperty/ModelProperty.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ModelProperty.d.ts","sourceRoot":"","sources":["../../../src/ModelProperty/ModelProperty.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"ModelProperty.d.ts","sourceRoot":"","sources":["../../../src/ModelProperty/ModelProperty.ts"],"names":[],"mappings":"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"}

package/dist/src/Schema/Schema.d.ts

@@ -3,10 +3,18 @@ import { schemaMachine } from './service/schemaMachine';
 import { Model } from '../Model/Model';
 import { EntityCache } from '../helpers/entity/entityCache';
 type SchemaService = ActorRefFrom<typeof schemaMachine>;
+/**
+ * `hold` for Schema lookups. A schema stays cached whether or not anyone holds it (see
+ * `Schema.cache`), so a hold only counts this caller; `unload()` gives it back.
+ */
+export type SchemaHoldOption = {
+    /** Take a cache hold, released with `unload()`. Default false. */
+    hold?: boolean;
+};
 /**
  * Options for Schema.all() method
  */
-export interface SchemaAllOptions {
+export interface SchemaAllOptions extends SchemaHoldOption {
     /**
      * If true, returns all versions of each schema. If false (default), returns only the latest version of each schema.
      * @default false
@@ -29,7 +37,11 @@ export interface SchemaAllOptions {
     readyTimeout?: number;
 }
 export declare class Schema {
-    /** Cached under its file id and its name (ADR 0014). */
+    /**
+     * Cached under its file id and its name (ADR 0014). A schema stays cached with no holds until it
+     * is destroyed or evicted, or the client stops (`unloadUnheld: false`): sync and name matching
+     * read the cached definitions synchronously.
+     */
     static readonly cache: EntityCache<Schema>;
     protected readonly _service: SchemaService;
     $schema?: string;
@@ -59,55 +71,50 @@ export declare class Schema {
     private static load;
     /**
      * Returns the cached schema for `schemaName`, or loads it (creating a draft for an unknown name).
-     * Each call takes a hold on the instance; release it with `unload()`.
+     * Takes no hold unless `hold: true`: a schema stays cached without one (see `cache`).
      */
     static create(schemaName: string, options: {
         waitForReady: false;
-        /** @internal SDK lookups pass false: see the implementation signature */
-        hold?: false;
-    }): Schema;
+    } & SchemaHoldOption): Schema;
     static create(schemaName: string, options?: {
         waitForReady?: true;
         readyTimeout?: number;
-        /** @internal SDK lookups pass false: see the implementation signature */
-        hold?: false;
-    }): Promise<Schema>;
+    } & SchemaHoldOption): Promise<Schema>;
+    /** The schema once ready; a call that took a hold gives it back when the schema isn't ready in time. */
+    private static readyOrRelease;
     /**
-     * Get schema instance by schemaFileId (preferred method)
-     * Returns null if not found in cache
+     * The cached schema with this file id, or null. Takes no hold unless `hold: true`.
      */
-    static getById(schemaFileId: string): Schema | null;
+    static getById(schemaFileId: string, options?: SchemaHoldOption): Schema | null;
     /**
-     * The cached schema with this file id or name, without taking a hold. For SDK code that reads
-     * the schema and doesn't hand it to a caller; callers that keep it use `create` or `find`.
+     * The cached schema with this file id or name, without taking a hold.
      */
     static peek(schemaFileIdOrName: string): Schema | undefined;
+    /**
+     * Takes one more hold on a cached, running instance, released with `unload()`. False (and no
+     * hold) when the instance isn't cached or was stopped.
+     */
+    static retain(instance: Schema): boolean;
     /** Stop and drop every cached Schema, whoever holds it (test cleanup). */
     static clearCache(): void;
     /**
      * Create or get schema instance by schemaFileId
      * Queries the database to find the schema name if not cached
      * @param schemaFileId - The schema file ID
-     * @returns Schema instance, with a hold taken (unless `hold: false`)
+     * @returns Schema instance, with no hold unless `hold: true`
      */
-    static createById(schemaFileId: string, 
-    /** @internal `hold: false` as for `create` */
-    options?: {
-        hold?: false;
-    }): Promise<Schema>;
+    static createById(schemaFileId: string, options?: SchemaHoldOption): Promise<Schema>;
     /**
      * Find a schema by schemaFileId or by name. Read-only: a name with no schema row gives undefined
      * and creates nothing (`Schema.create` creates a draft for an unknown name). By name, the cached
      * instance is used, else the stored schema is loaded. Waits for the schema to be fully loaded
-     * (idle state) by default. Takes a hold unless `hold: false`.
+     * (idle state) by default. Takes no hold unless `hold: true`.
      * @returns Schema instance if found, undefined otherwise
      */
     static find({ schemaFileId, schemaName, waitForReady, readyTimeout, hold, }: {
         waitForReady?: boolean;
         readyTimeout?: number;
-        /** @internal `hold: false` as for `create` */
-        hold?: false;
-    } & ({
+    } & SchemaHoldOption & ({
         schemaFileId: string;
         schemaName?: undefined;
     } | {
@@ -119,7 +126,7 @@ export declare class Schema {
      * Get instantiated Schema objects for all schemas (from database and files)
      * By default, returns only the latest version of each schema and excludes the internal Seed Protocol schema.
      * Uses loadAllSchemasFromDb() as the single source of truth, which intelligently merges database and file data.
-     * Takes no holds on the instances it returns: a caller that keeps one uses `Schema.create` or `Schema.find`.
+     * Takes no holds unless `hold: true`.
      *
      * @param options - Configuration options
      * @param options.includeAllVersions - If true, returns all versions of each schema. Default: false
@@ -127,6 +134,8 @@ export declare class Schema {
      * @returns Array of Schema instances
      */
     static all(options?: SchemaAllOptions): Promise<Schema[]>;
+    /** Throws EntityUnloadedError, naming the schema, when this instance was destroyed or evicted. */
+    private _assertLoaded;
     getService(): SchemaService;
     private _getSnapshot;
     private _getSnapshotContext;
@@ -200,8 +209,8 @@ export declare class Schema {
      */
     static evict(schemaName: string): void;
     /**
-     * Release this caller's hold. With the last one the schema is stopped, leaves the cache, and
-     * releases its hold on each of its models.
+     * Release this caller's hold, if it took one. The schema stays cached (see `Schema.cache`); only
+     * `destroy`, eviction or client stop stop it.
      */
     unload(): void;
     /**

package/dist/src/Schema/Schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../../src/Schema/Schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Schema.d.ts","sourceRoot":"","sources":["../../../src/Schema/Schema.ts"],"names":[],"mappings":"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"}

package/dist/src/archive/exportArchive.d.ts

@@ -0,0 +1,57 @@
+import { type Bag } from '@seedprotocol/archive';
+/**
+ * Exports a published item as a BagIt bag (RFC 8493) that an archive can ingest without Seed
+ * code: its Html, its files and its attested values, with SHA-256/SHA-512 manifests, Dublin Core
+ * and PREMIS metadata. See docs/ARCHIVE.md for the bag's layout.
+ */
+export type ExportArchiveOptions = {
+    /** Download Images, Files and Html bodies that aren't on this device. Default true. */
+    fetch?: boolean;
+    /** bag-info.txt Source-Organization, e.g. the publication. Left out when not given. */
+    sourceOrganization?: string;
+    /** Bagging-Date and the time of the bag's own PREMIS events. Defaults to now. */
+    baggingDate?: Date;
+};
+/** Something the item has that the bag doesn't carry, and why. Also listed in data/item.json. */
+export type ArchiveOmission = {
+    property: string;
+    reason: string;
+};
+export type ExportArchiveResult = {
+    bag: Bag;
+    omitted: ArchiveOmission[];
+};
+export type ArchiveExportErrorCode = 'not_published' | 'unpublished_changes';
+/** The item can't be exported as it is. `code` says why. */
+export declare class ArchiveExportError extends Error {
+    readonly code: ArchiveExportErrorCode;
+    constructor(code: ArchiveExportErrorCode, message: string);
+}
+type ExportableItem = {
+    seedLocalId: string;
+    modelName?: string;
+    getService?: () => {
+        getSnapshot: () => {
+            context: {
+                schemaName?: string;
+            };
+        };
+    };
+};
+/**
+ * Builds the bag for `item`'s current published state:
+ *
+ * - `data/index.html` (or `data/<property>.html` when the model has several Html properties): the
+ *   Html with references to files in the bag rewritten to relative paths.
+ * - `data/source/<property>.html`: each Html exactly as published.
+ * - `data/assets/<sha256>.<ext>`: Images, Files and images the Html references.
+ * - `data/item.json`: every property's value, attestation uid and Arweave transaction.
+ * - `metadata/dc.xml` and `metadata/premis.xml`.
+ *
+ * Throws {@link ArchiveExportError} `not_published` for an item without a live published version,
+ * and `unpublished_changes` when a property holds a saved value that isn't published yet.
+ * A file that can't be read or downloaded is left out and reported in `omitted`, not thrown.
+ */
+export declare function exportArchive(item: ExportableItem, options?: ExportArchiveOptions): Promise<ExportArchiveResult>;
+export {};
+//# sourceMappingURL=exportArchive.d.ts.map

package/dist/src/archive/exportArchive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportArchive.d.ts","sourceRoot":"","sources":["../../../src/archive/exportArchive.ts"],"names":[],"mappings":"AAAA,OAAO,EAOL,KAAK,GAAG,EAKT,MAAM,uBAAuB,CAAA;AA0B9B;;;;GAIG;AAEH,MAAM,MAAM,oBAAoB,GAAG;IACjC,uFAAuF;IACvF,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,uFAAuF;IACvF,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,iFAAiF;IACjF,WAAW,CAAC,EAAE,IAAI,CAAA;CACnB,CAAA;AAED,iGAAiG;AACjG,MAAM,MAAM,eAAe,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAA;AAElE,MAAM,MAAM,mBAAmB,GAAG;IAAE,GAAG,EAAE,GAAG,CAAC;IAAC,OAAO,EAAE,eAAe,EAAE,CAAA;CAAE,CAAA;AAE1E,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,qBAAqB,CAAA;AAE5E,4DAA4D;AAC5D,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;gBAEzB,IAAI,EAAE,sBAAsB,EAAE,OAAO,EAAE,MAAM;CAK1D;AAED,KAAK,cAAc,GAAG;IACpB,WAAW,EAAE,MAAM,CAAA;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM;QAAE,WAAW,EAAE,MAAM;YAAE,OAAO,EAAE;gBAAE,UAAU,CAAC,EAAE,MAAM,CAAA;aAAE,CAAA;SAAE,CAAA;KAAE,CAAA;CAC/E,CAAA;AA6CD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAgP1H"}

package/dist/src/browser/db/Db.d.ts

@@ -8,6 +8,8 @@ export declare class BrowserDb implements IDb {
     sqlocalInstance: SQLocalDrizzle | undefined;
     /** Live queries by SQL + params while they have subscribers; see liveQuery. */
     private sharedLiveQueries;
+    /** Bumped by close(), so a prepareDb that was running closes what it opened instead of keeping it. */
+    private openGeneration;
     getAppDb(): SqliteRemoteDatabase<Record<string, unknown>> | undefined;
     isAppDbReady(): boolean;
     prepareDb(filesDir: string): Promise<SqliteRemoteDatabase<Record<string, unknown>> | undefined>;
@@ -20,6 +22,9 @@ export declare class BrowserDb implements IDb {
      */
     private openPersistentSqlocal;
     private prepareDbLocked;
+    close(): Promise<void>;
+    /** Destroys the SQLocal instance (its worker releases seed.db) and forgets the database. */
+    private closeOpenDb;
     connectToDb(_filesDir: string): Promise<string | undefined>;
     copyDrizzleFiles(filesDir: string): Promise<void>;
     /** Internal migration runner. Used by prepareDb before appDb is set. */

package/dist/src/browser/db/Db.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../../../src/browser/db/Db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAW,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AASzE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAOhD,OAAO,EAAE,UAAU,EAAoE,MAAM,MAAM,CAAA;AAInG,qBAAa,SAAU,YAAW,GAAG;IAEnC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;IAChE,eAAe,EAAE,cAAc,GAAG,SAAS,CAAA;IAC3C,+EAA+E;IAC/E,OAAO,CAAC,iBAAiB,CAA2C;IAGpE,QAAQ;IAIR,YAAY;IAIN,SAAS,CAAC,QAAQ,EAAE,MAAM;IAWhC;;;;;;OAMG;YACW,qBAAqB;YA4BrB,eAAe;IAuEvB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEvD,wEAAwE;YAC1D,aAAa;IAiB3B,+GAA+G;YACjG,mBAAmB;IAoBjC;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBjG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,CAAC,CAAC,EACT,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,GAC/B,UAAU,CAAC,CAAC,EAAE,CAAC;CAwEnB"}
+{"version":3,"file":"Db.d.ts","sourceRoot":"","sources":["../../../../src/browser/db/Db.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,kBAAkB,CAAC;AAEvC,OAAO,EAAW,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AASzE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAOhD,OAAO,EAAE,UAAU,EAAoE,MAAM,MAAM,CAAA;AAInG,qBAAa,SAAU,YAAW,GAAG;IAEnC,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAA;IAC5B,KAAK,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,SAAS,CAAA;IAChE,eAAe,EAAE,cAAc,GAAG,SAAS,CAAA;IAC3C,+EAA+E;IAC/E,OAAO,CAAC,iBAAiB,CAA2C;IACpE,sGAAsG;IACtG,OAAO,CAAC,cAAc,CAAI;IAG1B,QAAQ;IAIR,YAAY;IAIN,SAAS,CAAC,QAAQ,EAAE,MAAM;IAWhC;;;;;;OAMG;YACW,qBAAqB;YA4BrB,eAAe;IAoFvB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5B,4FAA4F;YAC9E,WAAW;IASnB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IAI3D,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmEvD,wEAAwE;YAC1D,aAAa;IAiB3B,+GAA+G;YACjG,mBAAmB;IAoBjC;;;;;OAKG;IACG,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,oBAAoB,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBjG,OAAO,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQjF;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,SAAS,CAAC,CAAC,EACT,KAAK,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,KAAK,GAAG,CAAC,GAAG,GAAG,GAC/B,UAAU,CAAC,CAAC,EAAE,CAAC;CAwEnB"}

package/dist/src/browser/helpers/FileManager.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FileManager.d.ts","sourceRoot":"","sources":["../../../../src/browser/helpers/FileManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oCAAoC,CAAA;AAgI3C,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,UAAU,CAAY;IAExB,KAAK;IAOX,SAAS;IAOH,qBAAqB,CAAE,IAAI,EAAE,MAAM,GAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IASlE,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyCzD,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAKjF,WAAW,CAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAI,OAAO,CAAC,IAAI,CAAC;IAK5E,eAAe,CAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAI,OAAO,CAAC,IAAI,CAAC;IAK1E,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAInC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW/C,8FAA8F;IAC9F,OAAO,CAAC,aAAa,CAAmC;IAElD,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAMjD,aAAa;IAerB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe9C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUrD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA4FvG;;;;;;;OAOG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAgE1G,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DrF,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI;IAsBpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C/C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS9B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI1C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C,aAAa,IAAI,GAAG;CAGrB;AAqDD,4CAA4C;AAC5C,eAAO,MAAM,WAAW,2BAAqB,CAAA"}
+{"version":3,"file":"FileManager.d.ts","sourceRoot":"","sources":["../../../../src/browser/helpers/FileManager.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,sBAAsB,EACtB,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EAClB,MAAM,oCAAoC,CAAA;AAiI3C,qBAAa,kBAAmB,YAAW,YAAY;IACrD,OAAO,CAAC,UAAU,CAAY;IAExB,KAAK;IAOX,SAAS;IAOH,qBAAqB,CAAE,IAAI,EAAE,MAAM,GAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC;IASlE,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CzD,gBAAgB,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,sBAAsB,CAAC;IAKjF,WAAW,CAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,iBAAiB,GAAI,OAAO,CAAC,IAAI,CAAC;IAK5E,eAAe,CAAE,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE,qBAAqB,GAAI,OAAO,CAAC,IAAI,CAAC;IAK1E,cAAc,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;IAInC,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAW/C,8FAA8F;IAC9F,OAAO,CAAC,aAAa,CAAmC;IAElD,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAMjD,aAAa;IAerB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe9C,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAUrD,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAY3D;;;;;;OAMG;IACG,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAa,EAAE,OAAO,GAAE,MAAc,GAAG,OAAO,CAAC,OAAO,CAAC;IA4FvG;;;;;;;OAOG;IACG,sBAAsB,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,GAAE,MAAY,EAAE,OAAO,GAAE,MAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAgE1G,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DrF,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,WAAW,GAAG,IAAI;IAsBpE,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4C/C,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAS9B,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAejD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAKzD,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI1C,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAI7C,aAAa,IAAI,GAAG;CAGrB;AAqDD,4CAA4C;AAC5C,eAAO,MAAM,WAAW,2BAAqB,CAAA"}

package/dist/src/browser/helpers/tolerantWebAccess.d.ts

@@ -12,7 +12,7 @@ import type { WebAccessOptions } from '@zenfs/dom';
  * file this mount had indexed at a smaller size: OPFS only shrinks for a truncate made through this
  * mount, and stat() re-reads a file's size when OPFS changed since this mount last looked.
  *
- * Overrides @zenfs/dom 1.2.9 / @zenfs/core 2.5.6 internals (`_loadHandles`, `_loadMetadata`,
+ * Overrides @zenfs/dom 1.2.14 / @zenfs/core 2.7.7 internals (`_loadHandles`, `_loadMetadata`,
  * `crossCopy`, `stat`, `write`, `touch`, `remove`, `get`, `_handles`, `_sync`, `_isInitialized`,
  * `index`, and `vfs.Handle#truncate`/`truncateSync`, see `trackTruncates`); both packages are pinned
  * to exact versions, and tolerantWebAccess.test.ts / opfsOverwrite.test.ts cover the coupling.
@@ -58,6 +58,13 @@ export declare class TolerantWebAccessFS extends WebAccessFS {
      * the file changed.
      */
     stat(path: string): Promise<Inode>;
+    /**
+     * Adds an entry WebAccessFS.stat() just indexed from OPFS (made by another context after this
+     * mount loaded: a tab, SQLocal's worker creating `db/`) to the in-memory copy behind the sync API.
+     * ZenFS mirrors every write and create into that copy and fails the call when the entry or its
+     * directory is missing there.
+     */
+    private _cacheIndexed;
     /** Replaces the sync API's in-memory copy of `path` with `file`, if it holds one. */
     private _recache;
     /**
@@ -117,6 +124,10 @@ export declare const TolerantWebAccess: {
             readonly type: "boolean";
             readonly required: false;
         };
+        readonly maxOpenFilesForCopy: {
+            readonly type: "number";
+            readonly required: false;
+        };
     };
 };
 //# sourceMappingURL=tolerantWebAccess.d.ts.map