@honua/app-platform 0.1.12 → 0.1.13

package/offline/index.d.ts.map

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

package/offline/index.js

@@ -0,0 +1,34 @@
+/**
+ * Storage-neutral contracts for bounded, downloadable offline regions.
+ *
+ * This experimental entrypoint provides an IndexedDB adapter for browser
+ * persistence and a storage-backed fetch handler for service-worker or fetch
+ * integrations. Applications inject request matching, resource loading, and
+ * network policy; the SDK owns deterministic manifest identity, credential
+ * projection, cache diagnostics, quota admission against the origin's real
+ * storage estimate, integrity checks, cancellation, progress semantics, durable
+ * edit-queue state, and the composed local-first status that names one honest
+ * state across cached reads and undelivered writes. Applications still own
+ * connectivity policy, persistence requests, and edit replay transport binding.
+ *
+ * @experimental
+ */
+export { createOfflineRegionDiagnostic, createOfflineRegionManifest, downloadOfflineRegion, planOfflineRegionAdmission, verifyOfflineRegionManifest, } from "./region.js";
+export { canonicalizeOfflineRegionQuery, compareOfflineRegionBounds, isWgs84LonLatCrs, normalizeOfflineRegionTileKey, OFFLINE_REGION_DEFAULT_TILE_MATRIX_SET, OFFLINE_REGION_MAX_TILE_ZOOM, OFFLINE_REGION_PROTOCOL, offlineRegionAssetSelector, offlineRegionAuthorizationScopeDigest, offlineRegionMetadataSelector, offlineRegionQueryFingerprint, offlineRegionResourceId, offlineRegionTileEnvelope, offlineRegionTileSelector, } from "./selection.js";
+export { createOfflineRegionFeatureBatch, createOfflineRegionSnapshotLoader, decodeOfflineRegionFeatureBatch, DEFAULT_OFFLINE_REGION_SNAPSHOT_MAX_CONTENTS, encodeOfflineRegionFeatureBatch, HONUA_OFFLINE_FEATURE_BATCH_KIND, HONUA_OFFLINE_FEATURE_BATCH_VERSION, HONUA_OFFLINE_REGION_SNAPSHOT_KIND, HONUA_OFFLINE_REGION_SNAPSHOT_VERSION, planOfflineRegionSnapshot, } from "./snapshot.js";
+export { createOfflineRegionQueryPlanCache, DEFAULT_OFFLINE_REGION_READ_STALE_AFTER_MS, HONUA_OFFLINE_REGION_READ_KIND, HONUA_OFFLINE_REGION_READ_VERSION, } from "./read-gate.js";
+export { readOfflineRegionQuery } from "./read.js";
+export { readOfflineRegionAsset, readOfflineRegionMetadata, readOfflineRegionResource, readOfflineRegionTile, resolveOfflineRegionResourceId, } from "./read-resource.js";
+export { buildOfflineRegionTileUrlTemplate, createOfflineRegionTileProtocol, OFFLINE_REGION_TILE_SCHEME, parseOfflineRegionTileUrl, registerOfflineRegionTileProtocol, } from "./tile-protocol.js";
+export { createMemoryOfflineRegionStore, MemoryOfflineRegionStore } from "./memory-store.js";
+export { HONUA_OFFLINE_REGION_STORE_CONFORMANCE_KIND, HONUA_OFFLINE_REGION_STORE_CONFORMANCE_VERSION, OFFLINE_REGION_STORE_CONFORMANCE_CASES, runOfflineRegionStoreConformance, } from "./store-conformance.js";
+export { applyOfflineRegionSchemaMigration, createIndexedDbOfflineRegionStore, HONUA_OFFLINE_REGION_SCHEMA_VERSION, HONUA_OFFLINE_REGION_STORE_RECOVERY_KIND, HONUA_OFFLINE_REGION_STORE_RECOVERY_VERSION, IndexedDbOfflineRegionStore, OFFLINE_REGION_SCHEMA_MIGRATIONS, planOfflineRegionSchemaMigration, readableOfflineRegionSchemaVersions, } from "./indexeddb.js";
+export { DEFAULT_OFFLINE_STORAGE_HEADROOM_RATIO, DEFAULT_OFFLINE_STORAGE_MIN_RESERVE_BYTES, HONUA_OFFLINE_STORAGE_BUDGET_KIND, HONUA_OFFLINE_STORAGE_BUDGET_VERSION, HONUA_OFFLINE_STORAGE_PERSISTENCE_KIND, HONUA_OFFLINE_STORAGE_PERSISTENCE_VERSION, isStorageQuotaPressureError, probeOfflineStorageBudget, requestOfflinePersistentStorage, } from "./quota.js";
+export { createOfflineRegionFetchHandler } from "./fetch-handler.js";
+export { createIndexedDbOfflineEditQueue, createMemoryOfflineEditQueue, IndexedDbOfflineEditQueue, MemoryOfflineEditQueue, } from "./edit-queue.js";
+export { HONUA_OFFLINE_EDIT_REPLAY_VERSION, replayOfflineEditPass } from "./edit-replay.js";
+export { classifyOfflineReplayConflictPolicy, HONUA_OFFLINE_CONFLICT_RESOLUTION_KIND, HONUA_OFFLINE_CONFLICT_RESOLUTION_VERSION, HonuaOfflineConflictAdjudicationError, isHonuaOfflineConflictAdjudicationError, OFFLINE_REPLAY_CONFLICT_POLICIES, recordOfflineConflictResolution, } from "./conflict-resolution.js";
+export { HONUA_OFFLINE_REPLAY_SYNC_CONFLICT_KIND, HONUA_OFFLINE_REPLAY_SYNC_CONFLICT_VERSION, OFFLINE_REPLAY_SYNC_CONFLICT_FIELD_MAP, projectOfflineReplaySyncConflict, } from "./replay-conflict.js";
+export { createLocalFirstStatus, DEFAULT_LOCAL_FIRST_MAX_EDITS, DEFAULT_LOCAL_FIRST_MAX_LISTED_EDIT_IDS, DEFAULT_LOCAL_FIRST_MAX_REGIONS, HONUA_LOCAL_FIRST_STATUS_KIND, HONUA_LOCAL_FIRST_STATUS_VERSION, } from "./status.js";
+export { DEFAULT_OFFLINE_EDIT_QUEUE_MAX_AUDIT_EVENTS, DEFAULT_OFFLINE_EDIT_QUEUE_MAX_DEPENDENCIES, DEFAULT_OFFLINE_EDIT_QUEUE_MAX_EDITS, DEFAULT_OFFLINE_EDIT_QUEUE_MAX_PAYLOAD_BYTES, DEFAULT_OFFLINE_EDIT_QUEUE_MAX_RECOVERY_BYTES, DEFAULT_OFFLINE_EDIT_QUEUE_MAX_RECOVERY_RECORDS, HONUA_OFFLINE_EDIT_QUEUE_RECOVERY_KIND, HONUA_OFFLINE_EDIT_QUEUE_RECOVERY_VERSION, HONUA_OFFLINE_EDIT_QUEUE_VERSION, HonuaOfflineEditQueueError, inspectStoredOfflineEdit, inspectStoredOfflineEditMetadata, inspectStoredOfflineEditTombstone, MAX_OFFLINE_EDIT_LEASE_DURATION_MS, planOfflineEditQueueRecovery, } from "./edit-queue.js";
+export { DEFAULT_OFFLINE_REGION_MAX_ATTRIBUTIONS, DEFAULT_OFFLINE_REGION_MAX_LOGICAL_BYTES, DEFAULT_OFFLINE_REGION_MAX_METADATA_ENTRIES, DEFAULT_OFFLINE_REGION_MAX_RESOURCES, DEFAULT_OFFLINE_REGION_MAX_STRING_BYTES, HONUA_OFFLINE_REGION_DIAGNOSTIC_KIND, HONUA_OFFLINE_REGION_DIAGNOSTIC_VERSION, HONUA_OFFLINE_REGION_KIND, HONUA_OFFLINE_REGION_VERSION, HonuaOfflineRegionError, } from "./types.js";

package/offline/indexeddb.d.ts

@@ -0,0 +1,135 @@
+import { HonuaOfflineRegionError, type OfflineRegionCacheAdmin, type OfflineRegionCacheInventory, type OfflineRegionResourceRead, type OfflineRegionStore, type OfflineRegionWriteTransaction } from "./types.js";
+/**
+ * Persisted record-layout version written into {@link SCHEMA_STORE} and, since
+ * issue #1046, read back on every open.
+ *
+ * It is not the IndexedDB database version. The database version governs object
+ * stores and indexes; this one governs the shape of the values inside them, and
+ * it is the input to the forward migration ladder below.
+ */
+export declare const HONUA_OFFLINE_REGION_SCHEMA_VERSION: 3;
+/**
+ * One ordered step of the persisted region-record ladder.
+ *
+ * A step is a pure structural rewrite of one stored record. It receives only
+ * the record — never a caller's options, never the store — so a migration can
+ * neither widen a bound nor reach the network, and it must return a record
+ * carrying `toVersion`'s layout.
+ */
+export interface OfflineRegionSchemaMigrationV1 {
+    readonly fromVersion: number;
+    readonly toVersion: number;
+    readonly migrate: (record: Readonly<Record<string, unknown>>) => Record<string, unknown>;
+}
+/** Why a stored schema version cannot be carried to this build's layout. */
+export type OfflineRegionSchemaMigrationRefusal = "unknown-version" | "future-version" | "unreachable-version";
+export type OfflineRegionSchemaMigrationPlanV1 = {
+    readonly applicable: true;
+    /** `from->to` labels, oldest first; empty when the store is already current. */
+    readonly steps: readonly string[];
+    readonly migrations: readonly OfflineRegionSchemaMigrationV1[];
+} | {
+    readonly applicable: false;
+    readonly reason: OfflineRegionSchemaMigrationRefusal;
+    readonly detail: string;
+};
+/** Stable discriminator and version for region-store recovery reports. */
+export declare const HONUA_OFFLINE_REGION_STORE_RECOVERY_KIND: "honua.offline-region-store-recovery";
+export declare const HONUA_OFFLINE_REGION_STORE_RECOVERY_VERSION: 1;
+/**
+ * Payload-free account of one store open.
+ *
+ * Corrupt-record discards and schema-version refusals are separate counts on
+ * purpose: the first is damage this build can prove and repair, the second is a
+ * layout it declines to guess at. Conflating them is how an application learns
+ * its expensive cached bytes are gone only by noticing they are missing.
+ */
+export interface OfflineRegionStoreRecoveryV1 {
+    readonly kind: typeof HONUA_OFFLINE_REGION_STORE_RECOVERY_KIND;
+    readonly version: typeof HONUA_OFFLINE_REGION_STORE_RECOVERY_VERSION;
+    readonly outcome: "ready" | "unreadable";
+    readonly storedSchemaVersion: number;
+    readonly expectedSchemaVersion: number;
+    readonly appliedMigrations: readonly string[];
+    readonly migratedRegions: number;
+    /** Records this build proved unusable and removed. */
+    readonly discardedCorruptRecords: number;
+    /** Regions left untouched because their schema version has no migration path. */
+    readonly unsupportedRegions: number;
+    /** Present only when `outcome` is `unreadable`. */
+    readonly error?: HonuaOfflineRegionError;
+}
+/**
+ * Ordered forward migration ladder for persisted region records, oldest first.
+ *
+ * Schema 2 and schema 3 describe the same `RegionRecord` layout — database
+ * version 3 changed only the staging rows, which
+ * {@link migrateLegacyStaging} already backfills — so this step is deliberately
+ * the identity on region records. It exists because the machinery has to be
+ * real and exercised before the first layout change, not written under the
+ * pressure of one: the ladder, its bounds, its identity invariants, and its
+ * fail-closed refusal are all proven by a step that provably changes nothing.
+ */
+export declare const OFFLINE_REGION_SCHEMA_MIGRATIONS: readonly OfflineRegionSchemaMigrationV1[];
+export interface IndexedDbOfflineRegionStoreOptions {
+    /** Defaults to `honua-offline-regions`. Names are origin-scoped by IndexedDB. */
+    readonly name?: string;
+    /** Injectable for browser tests and hosts with an alternate IndexedDB factory. */
+    readonly indexedDB?: IDBFactory;
+    /** Maximum age of abandoned staged resources before a new store reclaims them. */
+    readonly stagingMaxAgeMs?: number;
+    /** Ladder applied to persisted region records on open. Defaults to {@link OFFLINE_REGION_SCHEMA_MIGRATIONS}. */
+    readonly migrations?: readonly OfflineRegionSchemaMigrationV1[];
+    /** Receives the schema and recovery outcome of every open. Must not throw. */
+    readonly onRecovery?: (report: OfflineRegionStoreRecoveryV1) => void;
+}
+/**
+ * Persistent browser store for the storage-neutral downloadable-region contract.
+ *
+ * Each commit uses one read/write IndexedDB transaction over inventory, region
+ * metadata, and resource bytes. The inventory revision is checked inside that
+ * transaction, so two concurrent downloads cannot both commit an admission plan
+ * calculated from the same inventory. Credentials and request URLs are never
+ * introduced by this adapter; callers provide only the already-normalized
+ * manifest and resource bytes.
+ *
+ * That is enforced rather than assumed. `beginWrite`, `write`, and `commit` are
+ * public exports, so each re-screens the identities it is about to persist and
+ * `commit` re-checks the whole manifest. A caller that bypasses
+ * `downloadOfflineRegion` cannot persist a credential-bearing endpoint, region
+ * id, or resource id.
+ */
+export declare class IndexedDbOfflineRegionStore implements OfflineRegionStore, OfflineRegionCacheAdmin {
+    #private;
+    constructor(options?: IndexedDbOfflineRegionStoreOptions);
+    inventory(): Promise<OfflineRegionCacheInventory>;
+    readResource(regionId: string, resourceId: string): Promise<OfflineRegionResourceRead | undefined>;
+    removeRegion(regionId: string): Promise<boolean>;
+    setRegionPinned(regionId: string, pinned: boolean): Promise<boolean>;
+    pruneExpired(now?: Date): Promise<readonly string[]>;
+    beginWrite(regionId: string): Promise<OfflineRegionWriteTransaction>;
+}
+export declare function createIndexedDbOfflineRegionStore(options?: IndexedDbOfflineRegionStoreOptions): IndexedDbOfflineRegionStore;
+/**
+ * Resolve the ordered steps that carry `version` forward to `targetVersion`.
+ *
+ * Exported because a host needs to answer "can this store still be read?"
+ * without opening it, and because the unreachable case — a ladder whose chain
+ * dead-ends before the target — has to be provable rather than assumed. The
+ * walk is bounded and cycle-safe: at most {@link MAX_SCHEMA_MIGRATION_STEPS}
+ * steps, and no version is visited twice.
+ */
+export declare function planOfflineRegionSchemaMigration(version: unknown, migrations?: readonly OfflineRegionSchemaMigrationV1[], targetVersion?: number): OfflineRegionSchemaMigrationPlanV1;
+/** Report which persisted schema versions this build can still read. */
+export declare function readableOfflineRegionSchemaVersions(migrations?: readonly OfflineRegionSchemaMigrationV1[]): readonly number[];
+/**
+ * Carry one persisted region record through an ordered chain of steps.
+ *
+ * Each step sees only a frozen copy of the record — never the store, never a
+ * caller's options — and its output is checked before the next step runs, so a
+ * migration that rewrites an identity fails the record instead of quietly
+ * repartitioning it. Exported so a host can rehearse a ladder against a record
+ * without an IndexedDB transaction.
+ */
+export declare function applyOfflineRegionSchemaMigration(record: Readonly<Record<string, unknown>>, steps: readonly OfflineRegionSchemaMigrationV1[]): Record<string, unknown>;
+//# sourceMappingURL=indexeddb.d.ts.map

package/offline/indexeddb.d.ts.map

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