@seedprotocol/sdk 0.7.9-next.1177.ga3e08ed → 0.7.9-next.1306.g4ff6582

package/dist/src/helpers/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAG9C,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,EAChC,MAAM,uBAAuB,CAAA;AAC9B,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAElE,OAAO,EACL,iBAAiB,EACjB,yBAAyB,EACzB,yBAAyB,EACzB,6BAA6B,EAC7B,wBAAwB,EACxB,wBAAwB,EACxB,wBAAwB,EACxB,uBAAuB,EACvB,2BAA2B,EAC3B,4BAA4B,EAC5B,+BAA+B,EAC/B,+BAA+B,EAC/B,+BAA+B,EAC/B,aAAa,EACb,eAAe,GAChB,CAAA;AAKD,eAAO,MAAM,6BAA6B;;;;;;;;;;;;;;;;CAgBhC,CAAA;AAEV,cAAc,+BAA+B,CAAA;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AACvD,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,qCAAqC,GACtC,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAGzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,kBAWzC,CAAA;AAED,eAAO,MAAM,YAAY,EAAE,YAe1B,CAAA;AAED,eAAO,MAAM,qBAAqB,GAChC,MAAM,MAAM,KACX,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,IA6BrC,CAAA;AAED,eAAO,MAAM,kBAAkB,GAC7B,MAAM,MAAM,KACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAgC5B,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,sBAAsB,MAAM,KAAG,MAE1E,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/helpers/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAI9C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,iBAAiB,CAAA;AAC/B,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA;AACjC,cAAc,YAAY,CAAA;AAC1B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,6BAA6B,EAC7B,qCAAqC,GACtC,MAAM,oBAAoB,CAAA;AAC3B,YAAY,EACV,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAC3B,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAEzC,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAA;AAG3C,eAAO,MAAM,YAAY,EAAE,YAe1B,CAAA;AAED,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,WAAW,CAAA;AAE9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAA;AAExD;;;;;GAKG;AACH,eAAO,MAAM,2BAA2B,GAAI,sBAAsB,MAAM,KAAG,MAE1E,CAAA"}

package/dist/src/helpers/localImageBlobUrl.d.ts

@@ -0,0 +1,7 @@
+/**
+ * A new blob: URL for `images/<txId>` in the files directory, or undefined when the file isn't
+ * there. Each call creates a URL; the caller owns it and revokes it with `URL.revokeObjectURL`
+ * once nothing displays it.
+ */
+export declare const convertTxIdToImage: (txId: string) => Promise<string | undefined>;
+//# sourceMappingURL=localImageBlobUrl.d.ts.map

package/dist/src/helpers/localImageBlobUrl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localImageBlobUrl.d.ts","sourceRoot":"","sources":["../../../src/helpers/localImageBlobUrl.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAU,MAAM,MAAM,KAAG,OAAO,CAAC,MAAM,GAAG,SAAS,CA4BjF,CAAA"}

package/dist/src/helpers/mediaRef.d.ts

@@ -1,75 +1,8 @@
-/** Roles for feed/XML field manifests (shared with @seedprotocol/feed and @seedprotocol/react). */
-export type FeedFieldRole = 'image' | 'audio' | 'video' | 'file' | 'html' | 'text';
-export type FeedFieldDescriptor = {
-    role: FeedFieldRole;
-    /** When heuristics are wrong, force how `classifyMediaRef` interprets the raw string. */
-    treatAs?: 'arweaveTx' | 'seedUid' | 'url';
-};
-export type FeedFieldManifest = Record<string, FeedFieldDescriptor>;
-export type ClassifyMediaRefOptions = {
-    treatAs?: FeedFieldDescriptor['treatAs'];
-};
-export type MediaRefClassification = {
-    kind: 'empty';
-} | {
-    kind: 'url';
-    href: string;
-} | {
-    kind: 'nonMediaUrl';
-    href: string;
-} | {
-    kind: 'seedUid';
-    uid: string;
-} | {
-    kind: 'seedLocalId';
-    localId: string;
-} | {
-    kind: 'arweaveTxId';
-    txId: string;
-} | {
-    kind: 'unknown';
-    raw: string;
-};
-export type ResolveMediaRefResult = {
-    status: 'ready';
-    href: string;
-    source: 'direct' | 'gateway' | 'localBlob';
-} | {
-    status: 'empty';
-} | {
-    status: 'unresolved';
-    reason: string;
-    classification: MediaRefClassification;
-};
-export type ResolveMediaRefOptions = ClassifyMediaRefOptions;
-/**
- * Pure, sync classification of a media-related string from feeds or XML.
- */
-export declare function classifyMediaRef(raw: string, options?: ClassifyMediaRefOptions): MediaRefClassification;
+import { type ResolveMediaRefOptions, type ResolveMediaRefResult } from '@seedprotocol/arweave';
 /**
  * Resolve a classified media reference to a display URL (https/blob/data), using local files when present.
+ * A `localBlob` result's href is a new blob: URL per call: the caller revokes it
+ * (`URL.revokeObjectURL`) when it stops displaying it, as `useResolvedMediaRef` does.
  */
 export declare function resolveMediaRef(raw: string, options?: ResolveMediaRefOptions): Promise<ResolveMediaRefResult>;
-export type NormalizedMediaField = {
-    role: 'image' | 'audio' | 'video' | 'file';
-    raw: string;
-    classification: MediaRefClassification;
-};
-export type NormalizedHtmlField = {
-    role: 'html';
-    raw: string;
-};
-export type NormalizedTextField = {
-    role: 'text';
-    raw: string;
-};
-export type NormalizedFeedFieldValue = NormalizedMediaField | NormalizedHtmlField | NormalizedTextField;
-/**
- * Read a string field from a parsed item, trying camelCase and snake_case keys.
- */
-export declare function getFeedItemStringField(item: Record<string, unknown>, key: string): string;
-/**
- * Apply a field manifest to a plain feed item: classify media/file fields; pass through html/text.
- */
-export declare function normalizeFeedItemFields(item: Record<string, unknown>, manifest: FeedFieldManifest): Record<string, NormalizedFeedFieldValue | undefined>;
 //# sourceMappingURL=mediaRef.d.ts.map

package/dist/src/helpers/mediaRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mediaRef.d.ts","sourceRoot":"","sources":["../../../src/helpers/mediaRef.ts"],"names":[],"mappings":"AAcA,mGAAmG;AACnG,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAA;AAElF,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,aAAa,CAAA;IACnB,yFAAyF;IACzF,OAAO,CAAC,EAAE,WAAW,GAAG,SAAS,GAAG,KAAK,CAAA;CAC1C,CAAA;AAED,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAA;AAEnE,MAAM,MAAM,uBAAuB,GAAG;IACpC,OAAO,CAAC,EAAE,mBAAmB,CAAC,SAAS,CAAC,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,sBAAsB,GAC9B;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpC,MAAM,MAAM,qBAAqB,GAC7B;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAA;CAAE,GAC7E;IAAE,MAAM,EAAE,OAAO,CAAA;CAAE,GACnB;IACE,MAAM,EAAE,YAAY,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,sBAAsB,CAAA;CACvC,CAAA;AAEL,MAAM,MAAM,sBAAsB,GAAG,uBAAuB,CAAA;AAkC5D;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,uBAAuB,GAChC,sBAAsB,CA6CxB;AA8CD;;GAEG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA0DhC;AAED,MAAM,MAAM,oBAAoB,GAAG;IACjC,IAAI,EAAE,OAAO,GAAG,OAAO,GAAG,OAAO,GAAG,MAAM,CAAA;IAC1C,GAAG,EAAE,MAAM,CAAA;IACX,cAAc,EAAE,sBAAsB,CAAA;CACvC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;CACZ,CAAA;AAED,MAAM,MAAM,wBAAwB,GAChC,oBAAoB,GACpB,mBAAmB,GACnB,mBAAmB,CAAA;AAEvB;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,CAezF;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC,CAwBtD"}
+{"version":3,"file":"mediaRef.d.ts","sourceRoot":"","sources":["../../../src/helpers/mediaRef.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,uBAAuB,CAAA;AAmB9B;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,qBAAqB,CAAC,CA0DhC"}

package/dist/src/helpers/metadataPropertyNames.d.ts

@@ -14,14 +14,16 @@ export declare function listRelationRef(propDef: PropertySchemaEntry | undefined
  */
 export declare function listRelationEasPropertyName(propertyName: string, propDef: PropertySchemaEntry | undefined): string | undefined;
 /**
- * For a schema property key like `authors` (List of Relation to Identity), returns the
- * internal storage/EAS name: `authorIdentityIds` (singular + ref + Ids).
+ * The key an item exposes a metadata row's property under. `propertyKey` (the properties row's
+ * name, through property_id) when the row has one. Otherwise from the stored name: the key it is a
+ * stored form of among `defs`, else the name without a trailing `Id`/`Ids` when `defs` has that
+ * key or the row is a ref (refSeedType), else the stored name.
  */
-export declare function listRelationStoragePropertyName(propertySchemas: Record<string, PropertySchemaEntry>, schemaPropertyKey: string): string | undefined;
-/**
- * Reverse of listRelationStoragePropertyName: maps DB/EAS name `authorIdentityIds` to schema key `authors`.
- */
-export declare function resolveStorageNameToSchemaName(propertySchemas: Record<string, PropertySchemaEntry>, storagePropertyName: string): string | undefined;
+export declare function metadataRowPropertyKey(row: {
+    propertyKey?: string | null;
+    propertyName?: string | null;
+    refSeedType?: string | null;
+}, defs?: Record<string, MetadataPropertyDef | undefined>): string | undefined;
 /**
  * Whether this type uses Id suffix in metadata table.
  */
@@ -31,9 +33,32 @@ export declare function needsMetadataIdSuffix(dataType?: string, refValueType?:
  * Use when creating/updating metadata.
  */
 export declare function toMetadataPropertyName(propertyName: string, dataType?: string, refValueType?: string): string;
+/** Minimal property def shape for the storage-name codec. */
+export type MetadataPropertyDef = PropertySchemaEntry & {
+    refValueType?: string;
+};
 /**
- * For READS: property names to include in OR query (both variants).
- * When dataType is undefined, includes all variants for safety (backwards compat with getPropertyData).
+ * The name new metadata rows of a property are written under (decision D4): a List of Relation's
+ * `<singular key><Ref>Ids` (`authors` → `authorIdentityIds`), a single Image, File, Html or
+ * Relation's `<key>Id`, anything else its key. Readers match rows by `property_id`; this name only
+ * matters for rows that have none.
+ */
+export declare function metadataStorageName(key: string, def: MetadataPropertyDef | undefined): string;
+/**
+ * Every name a row of this property may be stored under: its storage name, its key, and for an
+ * Image, File, Html or Relation (single or List) `<key>Id`, which older writers and sync used.
+ */
+export declare function metadataStoredNameForms(key: string, def: MetadataPropertyDef | undefined): string[];
+/**
+ * The schema key a stored metadata name belongs to among `defs` (keyed by schema key): an exact key
+ * first, then any of a key's stored forms. Undefined when no property matches. For rows without
+ * `property_id`; rows with one take the key from their properties row.
+ */
+export declare function propertyKeyFromStoredName(defs: Record<string, MetadataPropertyDef | undefined>, storedName: string): string | undefined;
+/**
+ * The names a property's rows may be stored under, for matching rows that have no property_id and
+ * outbox ops (which name a property, not its id): the name with and without its `Id` for an Image,
+ * File, Html or Relation, or when `dataType` is unknown.
  */
 export declare function getMetadataPropertyNamesForQuery(propertyName: string, dataType?: string, refValueType?: string): string[];
 /**
@@ -50,17 +75,6 @@ export declare function toSchemaPropertyName(propertyName: string): string | und
  * Alternate property name for instance lookup (base <-> Id variant).
  */
 export declare function getAlternatePropertyNameForInstanceLookup(propertyName: string): string | undefined;
-/** Minimal shape for resolveMetadataRecord; MetadataType from DB has propertyName as string | null */
-type RecordWithRef = {
-    propertyName: string | null;
-    refResolvedValue?: string | null;
-    refSeedType?: string;
-};
-/**
- * Resolve the best metadata record when multiple variants exist (base + Id).
- * For Image/File/Html: prefer the record with refResolvedValue (Id variant has filename).
- */
-export declare function resolveMetadataRecord<T extends RecordWithRef>(records: T[], preferredPropertyName: string, dataType?: string, refValueType?: string): T;
 /**
  * The EAS property name publish writes for an item property (ADR 0008 §3), already in EAS form:
  *
@@ -83,5 +97,4 @@ export declare function easSchemaDefinitionForProperty(propertyName: string, pro
     name?: string;
     refValueType?: string;
 }) | null): string | undefined;
-export {};
 //# sourceMappingURL=metadataPropertyNames.d.ts.map

package/dist/src/helpers/metadataPropertyNames.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"metadataPropertyNames.d.ts","sourceRoot":"","sources":["../../../src/helpers/metadataPropertyNames.ts"],"names":[],"mappings":"AAKA,8EAA8E;AAC9E,MAAM,MAAM,mBAAmB,GAAG;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB,CAAA;AAED,yEAAyE;AACzE,wBAAgB,eAAe,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAI5F;AAED;;;;;GAKG;AACH,wBAAgB,2BAA2B,CACzC,YAAY,EAAE,MAAM,EACpB,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,MAAM,GAAG,SAAS,CAKpB;AAED;;;GAGG;AACH,wBAAgB,+BAA+B,CAC7C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACpD,iBAAiB,EAAE,MAAM,GACxB,MAAM,GAAG,SAAS,CAEpB;AAED;;GAEG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,EACpD,mBAAmB,EAAE,MAAM,GAC1B,MAAM,GAAG,SAAS,CAWpB;AAQD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAOT;AAED;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,CAQR;AAED;;;GAGG;AACH,wBAAgB,gCAAgC,CAC9C,YAAY,EAAE,MAAM,EACpB,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,MAAM,EAAE,CAcV;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,MAAM,CAO5E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAI7E;AAED;;GAEG;AACH,wBAAgB,yCAAyC,CACvD,YAAY,EAAE,MAAM,GACnB,MAAM,GAAG,SAAS,CAIpB;AAED,sGAAsG;AACtG,KAAK,aAAa,GAAG;IACnB,YAAY,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAChC,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,CAAA;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,CAAC,SAAS,aAAa,EAC3D,OAAO,EAAE,CAAC,EAAE,EACZ,qBAAqB,EAAE,MAAM,EAC7B,QAAQ,CAAC,EAAE,MAAM,EACjB,YAAY,CAAC,EAAE,MAAM,GACpB,CAAC,CA6BH;AAED;;;;;;;GAOG;AACH,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,CAAC,mBAAmB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,GACpF,MAAM,CAaR;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,MAAM,EACpB,WAAW,CAAC,EAAE,CAAC,mBAAmB,GAAG;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,GACpF,MAAM,GAAG,SAAS,CAMpB"}
+{"version":3,"file":"metadataPropertyNames.d.ts","sourceRoot":"","sources":["../../../src/helpers/metadataPropertyNames.ts"],"names":[],"mappings":"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"}

package/dist/src/helpers/mimeTypes.d.ts

@@ -28,7 +28,8 @@ export declare const getMimeTypeFromPath: (filePathOrName: string) => string | u
 export declare const getExtensionForMimeType: (mimeType: string | null | undefined) => string | undefined;
 /**
  * MIME type from the leading bytes, for formats with an unambiguous signature. Used when a local
- * file has no (known) extension, e.g. a file seed named after its id.
+ * file has no (known) extension, e.g. a file seed named after its id. Self-contained: the download
+ * and resize workers get it as source text.
  */
 export declare const sniffMimeType: (bytes: Uint8Array) => string | undefined;
 /**

package/dist/src/helpers/mimeTypes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mimeTypes.d.ts","sourceRoot":"","sources":["../../../src/helpers/mimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwE9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiC3D,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAI/C,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAIhF,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,GAAI,gBAAgB,MAAM,KAAG,MAAM,GAAG,SAKrE,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAGtF,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,UAAU,KAAG,MAAM,GAAG,SA4B1D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,KAAG,MAAM,GAAG,SAG6C,CAAA"}
+{"version":3,"file":"mimeTypes.d.ts","sourceRoot":"","sources":["../../../src/helpers/mimeTypes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwE9D,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAiC3D,CAAA;AAEJ;;;GAGG;AACH,eAAO,MAAM,kBAAkB,EAAE,SAAS,MAAM,EAI/C,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAIhF,CAAA;AAED,iFAAiF;AACjF,eAAO,MAAM,mBAAmB,GAAI,gBAAgB,MAAM,KAAG,MAAM,GAAG,SAKrE,CAAA;AAED,sEAAsE;AACtE,eAAO,MAAM,uBAAuB,GAAI,UAAU,MAAM,GAAG,IAAI,GAAG,SAAS,KAAG,MAAM,GAAG,SAGtF,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,GAAI,OAAO,UAAU,KAAG,MAAM,GAAG,SA6B1D,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,GAAI,QAAQ;IAC5C,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC1B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,KAAK,CAAC,EAAE,UAAU,CAAA;CACnB,KAAG,MAAM,GAAG,SAG6C,CAAA"}

package/dist/src/helpers/model.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/helpers/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG;IAAE,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAuBpG"}
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../src/helpers/model.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAA;AAE7D;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,aAAa,EAAE,GAAG;IAAE,CAAC,YAAY,EAAE,MAAM,GAAG,GAAG,CAAA;CAAE,CAyBpG"}

package/dist/src/helpers/ownership.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../src/helpers/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE/C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAqC,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AAQzE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,SAAkB;CAKtC;AAED,KAAK,QAAQ,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AA6BD,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAWhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAMnE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,KAAK,CAAC,SAAS,EAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,GAAG,CAML;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAExE;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,GAAG,GAAG,CAO/D;AAKD,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,GAAG,CAM3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAWpE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/E;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF"}
+{"version":3,"file":"ownership.d.ts","sourceRoot":"","sources":["../../../src/helpers/ownership.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC/C,OAAO,EAAE,KAAK,EAAE,MAAM,cAAc,CAAA;AACpC,OAAO,EAAqC,KAAK,GAAG,EAAE,MAAM,aAAa,CAAA;AASzE;;;GAGG;AACH,qBAAa,cAAe,SAAQ,KAAK;gBAC3B,OAAO,SAAkB;CAKtC;AAED,KAAK,QAAQ,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAE1D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC9B,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CACpB,CAAA;AAMD,2FAA2F;AAC3F,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,gBAAgB,GAAG,MAAM,GAAG,IAAI,CAWhF;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAMnE;AAED,8DAA8D;AAC9D,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EACpC,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAIT;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,cAAc,EAAE,SAAS,MAAM,EAAE,GAChC,OAAO,CAIT;AAED;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,OAAO,KAAK,CAAC,SAAS,EAC9B,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,GAAG,CAML;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAExE;AAED,uGAAuG;AACvG,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,KAAK,CAAC,GAAG,GAAG,GAAG,CAO/D;AAKD,2DAA2D;AAC3D,wBAAgB,qBAAqB,IAAI,GAAG,CAM3C;AAED;;;;;;GAMG;AACH,wBAAgB,aAAa,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,GAAG,GAAG,CAWpE;AAED;;;;;;;;GAQG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAK/E;AAED;;;GAGG;AACH,wBAAsB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhF"}

package/dist/src/helpers/property.d.ts

@@ -1,36 +1,31 @@
 import { Static } from '@sinclair/typebox';
 import { TProperty } from '../Schema';
+import type { ModelScope } from '../db/read/resolveModelRecord';
+import type { PropertyDefinition } from './propertyDefinition';
 export * from './property/index';
 /**
- * Gets the propertyRecordSchema object for a given model and property name.
- *
- * The propertyRecordSchema is the property definition object that contains
- * information about the property's data type, storage configuration, and
- * relationship details (for Relation and List types).
- *
- * This function first checks the database for property definitions (which may
- * have been edited), then falls back to schema files. This ensures that
- * edited properties persist across page reloads.
- *
- * This function handles property names that end with 'Id' or 'Ids' by automatically
- * looking up the base property name in the schema (e.g., 'authorId' -> 'author',
- * 'tagIds' -> 'tags').
- *
- * @param modelName - The name of the model (e.g., 'Article', 'Author')
- * @param propertyName - The name of the property (e.g., 'title', 'author', 'authorId', 'tags', 'tagIds')
- * @returns The propertyRecordSchema object (TProperty with optional _propertyFileId) or undefined if not found
+ * The key in `defs` a property name refers to: the key itself, a stored metadata name
+ * (`authorId` → `author`, `authorIdentityIds` → `authors`), or the name minus `Id` / `Ids`
+ * (pluralized).
+ */
+export declare function resolvePropertyKey(defs: Record<string, any>, propertyName: string): string | undefined;
+/**
+ * Every property definition of one model ({@link getPropertyDefinitions}), with the model row
+ * resolved from its name and scope. Empty when the model has no row. Throws AmbiguousModelError
+ * for a bare name two schemas define.
+ */
+export declare function getModelPropertyDefinitions(modelName: string | undefined, scope?: ModelScope, db?: any): Promise<Map<string, PropertyDefinition>>;
+/**
+ * A property's definition, from its row ({@link getPropertyDefinition}), by model name and
+ * property name. The name may be a stored metadata name (`authorId`, `tagIds`); the result's
+ * `name` is the property's key. Undefined when the model or the property has no row.
  *
  * @example
  * ```typescript
  * const schema = await getPropertySchema('Article', 'title')
- * // Returns: { dataType: 'Text', ... }
- *
- * const relationSchema = await getPropertySchema('Article', 'author')
- * // Returns: { dataType: 'Relation', ref: 'Author', ... }
- *
- * // Also works with Id/Ids suffixes
- * const relationSchemaById = await getPropertySchema('Article', 'authorId')
- * // Returns: { dataType: 'Relation', ref: 'Author', ... }
+ * // { dataType: 'Text', name: 'title', id: '<schema file id>', validation: ..., ... }
+ * const relation = await getPropertySchema('Article', 'authorId')
+ * // { dataType: 'Relation', ref: 'Author', name: 'author', ... }
  * ```
  */
 export declare const getPropertySchema: (modelName: string, propertyName: string, 
@@ -38,7 +33,7 @@ export declare const getPropertySchema: (modelName: string, propertyName: string
 scope?: {
     modelFileId?: string | null;
     schemaName?: string | null;
-}) => Promise<(Static<typeof TProperty> & {
+}) => Promise<(Static<typeof TProperty> & PropertyDefinition & {
     _propertyFileId?: string;
 }) | undefined>;
 //# sourceMappingURL=property.d.ts.map

package/dist/src/helpers/property.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../../src/helpers/property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAWpC,cAAc,kBAAkB,CAAA;AAEhC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,cAAc,MAAM;AACpB,qGAAqG;AACrG,QAAO;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,KACtE,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,SAAS,CAAC,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAiR/E,CAAA"}
+{"version":3,"file":"property.d.ts","sourceRoot":"","sources":["../../../src/helpers/property.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AAIpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAC9D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAA;AAGtE,cAAc,kBAAkB,CAAA;AAEhC;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAUtG;AAED;;;;GAIG;AACH,wBAAsB,2BAA2B,CAC/C,SAAS,EAAE,MAAM,GAAG,SAAS,EAC7B,KAAK,GAAE,UAAe,EACtB,EAAE,MAAoB,GACrB,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAO1C;AAED;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iBAAiB,GAC5B,WAAW,MAAM,EACjB,cAAc,MAAM;AACpB,qGAAqG;AACrG,QAAO;IAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAO,KACtE,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,SAAS,CAAC,GAAG,kBAAkB,GAAG;IAAE,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAWpG,CAAA"}

package/dist/src/helpers/propertyDefinition.d.ts

@@ -0,0 +1,59 @@
+import type { Static } from '@sinclair/typebox';
+import { BaseDb } from '../db/Db/BaseDb';
+import { type PropertyType } from '../seedSchema';
+import { type TProperty } from './property/index';
+type Db = NonNullable<ReturnType<typeof BaseDb.getAppDb>>;
+/**
+ * A property's definition as its row stores it (ADR 0016, audit decision D7): the `definition`
+ * column read in the internal shape (`dataType`, `ref`, `storageType`, ...), with the row's columns
+ * winning for the fields they hold. `id` is the schema file id, `_dbId` the row id, `modelId` the
+ * model row id.
+ */
+export type PropertyDefinition = Omit<Static<typeof TProperty>, 'modelId' | 'name' | 'id'> & {
+    id?: string;
+    name: string;
+    _dbId: number;
+    modelId: number;
+    refModelId?: number;
+    refModelName?: string;
+    description?: string;
+    [key: string]: unknown;
+};
+/**
+ * The `definition` column value for a definition in any accepted shape (schema file property,
+ * Model.create property, ModelProperty context). With `previous` (the row's current value), fields
+ * the new definition doesn't have are kept: a write that only knows the columns (a creation
+ * payload, a row-built instance) must not drop the validation a schema file or code stored.
+ */
+export declare function propertyDefinitionColumn(def: Record<string, any>, previous?: string | null): string;
+/**
+ * A row as a {@link PropertyDefinition}. `refModelName` is the name of the row's `ref_model_id`
+ * model; without one, a Relation or List keeps the definition's `ref` (a target not stored yet).
+ */
+export declare function propertyDefinitionFromRow(row: PropertyType, refModelName?: string | null): PropertyDefinition;
+/**
+ * The complete definition of one property, from its row: by row id (`metadata.property_id`), or by
+ * model row id and property name. Undefined when there's no such row.
+ */
+export declare function getPropertyDefinition(target: number | {
+    modelId: number;
+    name: string;
+}, db?: Db | undefined): Promise<PropertyDefinition | undefined>;
+/** {@link getPropertyDefinition} for every property of one model, by property name, in one read. */
+export declare function getPropertyDefinitions(modelId: number, db?: Db | undefined): Promise<Map<string, PropertyDefinition>>;
+/** Fields only a definition holds (no column), which code-defined properties can set. */
+export declare const DEFINITION_ONLY_FIELDS: readonly ["validation", "htmlEmbeddedDataUriPolicy", "description"];
+/** The {@link DEFINITION_ONLY_FIELDS} a definition sets. */
+export declare const definitionOnlyFields: (def: Record<string, any>) => Record<string, unknown>;
+/**
+ * Stores code-defined fields ({@link definitionOnlyFields}) in the row's definition, when the row
+ * exists and its definition differs. For properties whose row was written before the code that
+ * defines them ran (a schema file's row, an earlier run), so their rules persist at create time.
+ */
+export declare function persistDefinitionFields(where: {
+    schemaFileId: string;
+} | {
+    id: number;
+}, fields: Record<string, unknown>, db?: Db | undefined): Promise<void>;
+export {};
+//# sourceMappingURL=propertyDefinition.d.ts.map

package/dist/src/helpers/propertyDefinition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"propertyDefinition.d.ts","sourceRoot":"","sources":["../../../src/helpers/propertyDefinition.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAA;AAC/C,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AACvC,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAA;AACpE,OAAO,EAA4E,KAAK,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAEnI,KAAK,EAAE,GAAG,WAAW,CAAC,UAAU,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAA;AAEzD;;;;;GAKG;AACH,MAAM,MAAM,kBAAkB,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,GAAG,IAAI,CAAC,GAAG;IAC3F,EAAE,CAAC,EAAE,MAAM,CAAA;IACX,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,OAAO,EAAE,MAAM,CAAA;IACf,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;CACvB,CAAA;AA8CD;;;;;GAKG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAGnG;AAED;;;GAGG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,kBAAkB,CAuB7G;AAUD;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAClD,EAAE,GAAE,EAAE,GAAG,SAA6B,GACrC,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC,CAQzC;AAED,oGAAoG;AACpG,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,MAAM,EACf,EAAE,GAAE,EAAE,GAAG,SAA6B,GACrC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC,CAS1C;AAED,yFAAyF;AACzF,eAAO,MAAM,sBAAsB,qEAAsE,CAAA;AAEzG,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,GAAI,KAAK,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAC8B,CAAA;AAEpH;;;;GAIG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE;IAAE,YAAY,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,EAAE,GAAE,EAAE,GAAG,SAA6B,GACrC,OAAO,CAAC,IAAI,CAAC,CAQf"}

package/dist/src/helpers/readHtmlBodyForStorageSeed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"readHtmlBodyForStorageSeed.d.ts","sourceRoot":"","sources":["../../../src/helpers/readHtmlBodyForStorageSeed.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAwED,6GAA6G;AAC7G,wBAAsB,uCAAuC,CAC3D,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAmB7B"}
+{"version":3,"file":"readHtmlBodyForStorageSeed.d.ts","sourceRoot":"","sources":["../../../src/helpers/readHtmlBodyForStorageSeed.ts"],"names":[],"mappings":"AA6BA;;;GAGG;AACH,wBAAsB,6BAA6B,CACjD,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAQ7B;AAqCD,6GAA6G;AAC7G,wBAAsB,uCAAuC,CAC3D,aAAa,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAkB7B"}

package/dist/src/helpers/relationSeedRef.d.ts

@@ -1,10 +1,3 @@
-/** Relation/image refs may be string ids or `{ seedLocalId?, seedUid? }`. */
-export declare function normalizeRelationPropertyValue(value: unknown): string | undefined;
-/** Resolve seed ids from a single string (context propertyValue or DB row). */
-export declare function resolveSeedIdsFromRefString(s: string): {
-    seedLocalId?: string;
-    seedUid?: string;
-};
 /**
  * True when a relation ref is an attested seed uid (0x…) rather than a local id. A uid only exists once
  * the seed is on EAS, so publish can attest the uid as-is when no local copy exists (e.g. a server

package/dist/src/helpers/relationSeedRef.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"relationSeedRef.d.ts","sourceRoot":"","sources":["../../../src/helpers/relationSeedRef.ts"],"names":[],"mappings":"AAaA,6EAA6E;AAC7E,wBAAgB,8BAA8B,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAgBjF;AAKD,+EAA+E;AAC/E,wBAAgB,2BAA2B,CAAC,CAAC,EAAE,MAAM,GAAG;IAAE,WAAW,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CASjG;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAQD,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAExD"}
+{"version":3,"file":"relationSeedRef.d.ts","sourceRoot":"","sources":["../../../src/helpers/relationSeedRef.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAK1D;AAQD,qGAAqG;AACrG,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAExD"}

package/dist/src/helpers/schema.d.ts

@@ -1,62 +1,48 @@
 import { SchemaFileFormat } from '../types/import';
 /**
- * List all schema files in the working directory
- * Only returns files that are NOT already complete schema files (i.e., files without $schema field)
- * This allows processing of minimal import files while skipping already-processed schema files
- * @returns Array of objects containing name, version, and file path for each schema
+ * A schema version file's name: `<schemaFileId>_<name>_v<version>.json` (ADR 0016). The id comes
+ * first, so a schema's versions sort together and a rename keeps them under one id.
  */
-export declare function listSchemaFiles(): Promise<Array<{
-    name: string;
-    version: number;
-    filePath: string;
-}>>;
+export declare const getSchemaFileName: (schemaFileId: string, name: string, version: number) => string;
+/** The path of a schema version file in the working directory. */
+export declare const getSchemaFilePath: (schemaFileId: string, name: string, version: number) => string;
 /**
- * List all complete schema files in the working directory
- * Only returns files that are complete schema files (i.e., files with $schema field)
- * These are already-processed schema files that need to be loaded into the model store
- * @returns Array of objects containing name, version, and file path for each complete schema
+ * Some tools write `models` and each model's `properties` as arrays. Returns them as objects keyed
+ * by name (or id, or index).
  */
+export declare function normalizeSchemaModels(models: SchemaFileFormat['models'] | unknown): SchemaFileFormat['models'];
+/** The complete schema file at filePath, or undefined when it can't be read or has no `$schema`. */
+export declare function readSchemaFile(filePath: string): Promise<SchemaFileFormat | undefined>;
 type CompleteSchemaFileInfo = {
     name: string;
     version: number;
     filePath: string;
     schemaFileId?: string;
 };
-export declare function listCompleteSchemaFiles(): Promise<CompleteSchemaFileInfo[]>;
-/**
- * Get the latest version number for a schema by name
- * Only considers complete schema files (with $schema field)
- * @param name - The name of the schema
- * @returns The latest version number, or 0 if no schema found
- */
-export declare function getLatestSchemaVersion(name: string): Promise<number>;
 /**
- * Get only the latest version of each schema
- * @returns Array of objects containing name, version, and file path for the latest version of each schema
+ * Every complete schema file (`<id>_<name>_v<n>.json` with `$schema` and `metadata.name`) in the
+ * working directory. The id is taken from the file name.
  */
-export declare function listLatestSchemaFiles(): Promise<Array<{
-    name: string;
-    version: number;
-    filePath: string;
-}>>;
+export declare function listCompleteSchemaFiles(): Promise<CompleteSchemaFileInfo[]>;
+/** The newest file of each schema, by schema file id (a schema's name can change between versions). */
+export declare function listLatestSchemaFiles(): Promise<CompleteSchemaFileInfo[]>;
+/** The newest version file of the schema with this file id, if any. */
+export declare function findLatestSchemaFile(schemaFileId: string): Promise<CompleteSchemaFileInfo | undefined>;
 /**
- * Unified schema loading function that queries database first, then merges with files
- * Returns all schemas with their draft status and source information
- * @returns Array of schema objects with metadata about their state
+ * One loaded schema: its definition from {@link resolveSchemaRow}, and the row it came from.
  */
 export type LoadedSchema = {
     schema: SchemaFileFormat;
     isDraft: boolean;
-    source: 'db' | 'file' | 'db+file';
+    source: 'db' | 'db+file';
     schemaRecordId?: number;
-    /** The schema file the entry was read from (source 'file' or 'db+file'). */
+    /** The version file the definition was read from (source 'db+file'). */
     filePath?: string;
-    /**
-     * Source 'db+file' only: the DB row already matched the file before this call (same schema file
-     * id and version, file not updated since). The file's models were applied by an earlier load.
-     */
-    dbMatchesFile?: boolean;
 };
+/**
+ * Every schema row in the database, each resolved to its definition by {@link resolveSchemaRow}.
+ * Reads only: schema files without a row are applied at init (processSchemaFiles), not here.
+ */
 export declare function loadAllSchemasFromDb(): Promise<LoadedSchema[]>;
 /**
  * Extract the schema name from a schemaId string

package/dist/src/helpers/schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/helpers/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAUjD;;;;;GAKG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAkD3G;AAED;;;;;GAKG;AACH,KAAK,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExG,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CA4DjF;AAED;;;;;GAKG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC,MAAM,CAAC,CAcjB;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAcjH;AAED;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,IAAI,GAAG,MAAM,GAAG,SAAS,CAAA;IACjC,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB,CAAA;AAED,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CA2OpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOtF"}
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/helpers/schema.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AAejD;;;GAGG;AACH,eAAO,MAAM,iBAAiB,GAAI,cAAc,MAAM,EAAE,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MACxB,CAAA;AAEhE,kEAAkE;AAClE,eAAO,MAAM,iBAAiB,GAAI,cAAc,MAAM,EAAE,MAAM,MAAM,EAAE,SAAS,MAAM,KAAG,MAIrF,CAAA;AAKH;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,OAAO,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAqB9G;AAED,oGAAoG;AACpG,wBAAsB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAU5F;AAED,KAAK,sBAAsB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAExG;;;GAGG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAiCjF;AAED,uGAAuG;AACvG,wBAAsB,qBAAqB,IAAI,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAQ/E;AAED,uEAAuE;AACvE,wBAAsB,oBAAoB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,sBAAsB,GAAG,SAAS,CAAC,CAE5G;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,MAAM,EAAE,gBAAgB,CAAA;IACxB,OAAO,EAAE,OAAO,CAAA;IAChB,MAAM,EAAE,IAAI,GAAG,SAAS,CAAA;IACxB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB,CAAA;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAwBpE;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAOtF"}