@happyvertical/smrt-education 0.57.37 → 0.57.39

package/AGENTS.md

@@ -37,3 +37,11 @@ never create learning evidence, and blank exercises need explicit work intent.
 Source import: [host boundary and transaction contract](agents/source-import.md).
 `SourceImportService` requires host opt-in, matching active actor/tenant and
 explicit licensing authorization; never add a system/global write bypass.
+
+Family-owned unassigned originals and audited learner adoption use
+[FamilyIntakeService](agents/family-intake.md). Keep family source scope immutable;
+assignment alone never creates learning history or grants learner inbox access.
+
+Publisher catalog previews use [the preview contract](agents/catalog-previews.md).
+Keep independent image rights and source revisions; serve via `CatalogPreviewService`
+with live actor/tenant authorization, never direct provider image URLs.

package/agents/catalog-previews.md

@@ -0,0 +1,98 @@
+# Publisher catalog previews
+
+`CatalogSourceRecord.preview` and `CatalogResourceView.preview` are optional
+`CatalogPreview` metadata. They describe a publisher image, not an acquired
+original, cover guarantee, download permission, or learner access grant. The
+public root exports `CatalogPreviewService`, `CatalogPreviewStore`,
+`CatalogPreviewLoader`, `catalogPreviewFor`, and `normalizeCatalogPreview`.
+`CatalogResource.getPreview()` reads the guarded persisted JSON. Deploy the normal
+additive manifest migration for its nullable `preview` column before sync; legacy
+rows have no preview. Sync retains the first retrieval timestamp on identical
+revision retries and rejects changing an existing preview within that revision.
+New revisions replace the current reference; old revision requests become 404.
+PNG verification resolves its Node host capability only when invoked; importing
+catalog metadata/models remains browser-safe. Serving/verification requires a
+Node host and fails closed without it.
+The image hash participates in the IM page record's revision, so changed bytes
+cannot silently reuse a preview revision.
+
+The public IM first-edition adapter automatically selects at most one embedded
+instructional diagram on a K–5 family-materials page. It requires that exact
+page's CC BY 4.0 footer and attribution, an official ImageFile figure with an
+empty caption, no separate credits or image-license notice in the instructional
+content, a descriptive chart/diagram alt, and an exact official asset identifier.
+Branding, photographs, credited or ambiguous images, other providers, unsupported
+formats and missing metadata remain absent. This narrow page-scoped policy does
+not grant a provider-wide image license. The source footer explicitly excludes
+the name/logo and preserves third-party image licenses; never remove those
+exclusions or apply this rule to arbitrary images. Existing teacher visibility
+is retained, including family hierarchy records currently classified teacher.
+
+Concrete publisher evidence, retrieved 2026-10-28:
+[Grade 1 Unit 1 Family Materials](https://im.kendallhunt.com/k5/families/grade-1/unit-1/family-materials.html)
+embeds ImageFile 38531, “Tally Chart. Turtle, tallies, 6. Dog, tallies, 2.
+Rabbit, tallies, 12.” Its
+[official PNG](https://cms-assets.illustrativemathematics.org/fd1cykl2wl4zyfc6vzfkl3x09pvr)
+is 93,072 bytes, 1350 × 674. The licensed instructional fragment and PNG are
+fixtures in `src/__tests__/fixtures/im-family-*`, attributed to © 2021
+Illustrative Mathematics, CC BY 4.0. The image is unmodified. Captions or separate
+attribution appearing in a future sync make the preview unavailable.
+
+Enumeration performs metadata reads and at most one **preview image** GET per
+page; it never GETs original PDFs/ZIPs. It accepts only official HTTPS origin and
+opaque path, refuses redirects, and bounds the complete network/body operation
+by the adapter deadline (20 seconds default, 60 maximum). Required HTML/HEAD
+work completes before optional sync previews, which get an independent deadline
+of one quarter of that budget, capped at two seconds and the remaining total
+enumeration budget. A hung preview cannot pause
+metadata enumeration or its cursor. PNG previews have a
+2 MiB byte cap and 4096-pixel width/height cap. SVG, HTML, JPEG and other formats
+are currently unavailable. Only non-interlaced, static 8-bit RGB/RGBA PNGs are
+verified: complete chunks/CRCs/IEND and bounded inflated scanlines must be valid;
+truncated or corrupt data never becomes a verified preview. This uses existing provider request bounds rather
+than a general URL proxy. A preview failure leaves catalog metadata readable.
+`CatalogReadService.search()` performs no image or content fetches.
+
+Wire a host endpoint using only the published root API:
+
+```ts
+import {
+  CatalogPreviewService,
+  createPublicIllustrativeMathematicsFirstEditionAdapter,
+} from '@happyvertical/smrt-education';
+
+const previews = new CatalogPreviewService({
+  // Both functions use your trusted active-session/tenant executor. Adapt your
+  // persisted resource to CatalogSourceRecord, including row.getPreview().
+  getResource: (id, actor) => catalogStore.getReadableResource(id, actor),
+  authorize: (actor, resource) => catalogPolicy.canReadNow(actor, resource.id),
+}, createPublicIllustrativeMathematicsFirstEditionAdapter());
+
+// Inside GET /catalog/preview; actor is derived from the server session.
+return previews.serve({ actor, resourceId, revision });
+```
+
+Render your own endpoint URL only when `view.preview` is present, using `alt`,
+width/height and rights attribution. Never place `reference` or `sourceUrl` into
+an image URL. The endpoint re-reads the current resource and checks active
+host authorization, tenant/actor identity, teacher visibility, withdrawal,
+revision and optional rights expiry on **every request**, including cache hits.
+The host must check actor membership/active tenant, not merely trust strings in a
+request. Do not expose an unscoped collection read as this adapter.
+
+Rights expiry is checked again after awaited loading/verification and before
+serving or inserting cached bytes. The per-service cache holds at most 16 MiB of verified public image bytes for at
+most 60 seconds; reuse a service instance to benefit from it. Cache lookup occurs
+after authorization. Changed length, dimensions or SHA-256, expiry, missing or
+invalid metadata, upstream failures and access denial yield uniform 404 with
+`Cache-Control: no-store`; successful responses are PNG, `nosniff`, sandboxed,
+and `private, no-store`, so browsers cannot serve a revoked preview from cache.
+No credential, upstream image URL, redirect or raw provider error reaches the
+browser. Synchronize regularly to observe publisher withdrawal/license changes;
+server byte caching never bypasses the durable current-resource decision.
+
+Private asset previews and derivatives of acquired originals are unavailable in
+this publisher-only contract. Use the asset authority and the separate acquired
+original derivative capability (#4470), with authorization on every private
+asset read. Possessing an asset, granting full-resource download/print, or being
+able to view a publisher page never supplies preview permission here.

package/agents/family-intake.md

@@ -0,0 +1,97 @@
+# Family intake
+
+`FamilyIntakeService` retains guardian-only originals before a learner is known.
+The host supplies a trusted actor/tenant and a current family authorizer; each
+read, original download, assignment and adoption revalidates this authority on
+the service's exact executor. Learners cannot browse the family inbox. Generated
+CRUD, CLI, MCP and AI surfaces remain closed.
+
+Retain the whole document with its source identity, delivery key, immutable hash
+and original private assets. Source delivery retries must preserve identical
+content and provenance. Email and scanner adapters are separate host configuration;
+this service does not configure or select them. Trusted candidate DTOs and their
+quoted evidence are advisory. A guardian's active learner preference, visible
+marks, uncertain names or a first-page guess never establish ownership. Mixed
+learner PDFs stay unresolved until an explicit whole-document assignment is safe.
+
+Assignment records an immutable guardian decision with a revision and request
+key. It does not create learner work. Adoption freezes that assignment and borrows
+the exact original assets through learner photo ownership joins; it never rewrites
+source confidentiality or creates grades. The existing photo resolution and
+completed-work capture preconditions still apply. Existing derived capture copies
+are permitted. Once adopted, a receipt cannot silently change learners; recovery
+requires a separate explicit policy. An unadopted attribution can be corrected by
+another audited decision with the current revision.
+
+Family ownership retains originals beyond generic receipt expiry. Adoption does
+not transfer or delete that ownership. Cleanup and rollback must preserve shared
+retained bytes and compensate only newly created files. Every access checks the
+original hash before adoption or download.
+
+Validation uses shared family workflows on real SQLite and isolated PostgreSQL;
+no AI providers, scanner/email services or containers are required.
+
+Import `FamilyIntakeService`, `receiveFamilyIntake` and
+`retainFamilyIntakeReceipt` from `@happyvertical/smrt-education/ingestion`.
+The bridge uses the fixed `familyIntakeScopeId(tenantId)` namespace and public
+`getReceiptSource` to retain authoritative delivery identity. This namespace is
+never an authorization grant. The host's `IngestionService.authorize` callback
+must call the same current family authorizer on every operation, including direct
+`getEvidence`, `readEvidence` and `getReceiptSource` calls. For example, await
+`family.authorizeFamilyIntake({ tenantId: scope.tenantId, actorUserId: scope.actorId })`
+then return true; propagate denial. Actor equality or tenant membership alone is
+insufficient. This protects raw envelopes and rejected/unretained originals as
+well as adopted receipts. Adoption permits only normal authorized learner work
+reads; it never grants the learner generic family ingestion access. A receive that
+succeeds before education retention fails is repaired by retrying the same
+receipt, never by inventing another delivery identity.
+
+Deploy manifest migrations for all three FamilyIntake models and the nullable
+`WorkbookPhotoIntake.familyIntakeId` FK before use. There is no runtime DDL.
+Adoption commits its immutable audit and exact photo/original joins atomically;
+the family asset remains the sole original owner. Existing derived submission
+copies use normal capture compensation. The exact adoption audit is required
+when validating borrowing joins, reads and immutable family-scope analysis.
+`countFamilyIntakes` counts unadopted receipts across the full inbox, while
+`listFamilyIntakes` pages the complete receipt history.
+
+After adoption, use the returned `photoIntakeId` with ordinary photo
+resolution/capture methods. Family-scope photo analysis checks the exact adopted
+item/learner binding; learner-scoped uploads retain their existing strict scope.
+The existing submission/assessment ingestion handlers still revalidate the
+captured learner/attempt. Temporary ingestion expiry does not prevent manual
+resolution/capture from retained education originals; re-analysis of an expired
+receipt needs a separately authorized retained-input orchestration.
+
+This initial contract assigns a whole receipt/document. It does not split a
+mixed-child PDF, automatically infer a child or configure a source adapter.
+Future range adoption must preserve original hashes and page provenance; the
+retained immutable originals remain available for such an explicit workflow.
+
+Source-tree retention includes image/PDF attachments beneath metadata envelopes.
+A supported-media descendant of another supported original (for example a PDF's
+page thumbnail) stays in the evidence graph but is not duplicated as learner
+work. Photo identification and captured-work analysis preservation use this same
+original-selection convention, so retained attachment hashes remain authoritative
+after adoption and retries. The immutable graph retains only IDs, parent IDs, media types and hashes;
+it does not copy email bodies, arbitrary headers or credentials into public
+source metadata. A source image such as an email logo is not automatically
+classified as completed work. Whole-document attribution/classification remains
+an explicit guardian decision; ambiguous mixed contents need resolution.
+
+Custom source adapters must follow this supported convention: metadata parents
+contain independent original attachments; descendants of supported media are
+renditions of that media. Extraction outputs already live separately from source
+evidence. An adapter that uses media-child relationships for independently
+authored attachments is unsupported by this bridge until its role is explicitly
+established; do not claim complete attachment fidelity for that shape or infer
+roles from first-page content. Full immutable evidence lineage is retained even
+when a rendition is excluded from capture pages.
+
+The bridge rejects an entire receipt containing an unsupported independent
+original, including a mixed PDF/TIFF bundle, before family retention. Generic
+source originals remain available for recovery; no partial family receipt or
+adoption is created. Hosts must acknowledge successful family import only after
+family retention succeeds and surface failed source imports. Known JSON
+metadata wrappers and media descendants under the supported rendition convention
+are not independent originals.

package/dist/catalog-contracts.d.ts

@@ -1,3 +1,4 @@
+import type { CatalogPreview } from './catalog-preview.js';
 /** Metadata-only resource visibility. Teacher material is never learner-visible. */
 export type CatalogVisibility = 'catalog' | 'teacher';
 export type CatalogLicenseState = 'verified' | 'unknown' | 'conflicting' | 'restricted';
@@ -71,6 +72,7 @@ export interface CatalogSourceRecord {
     parentStableId?: string;
     availableFormats?: string[];
     representation?: CatalogResourceRepresentation;
+    preview?: CatalogPreview;
     licenseEvidence: CatalogLicenseEvidence;
     visibility: CatalogVisibility;
 }

package/dist/catalog-contracts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-contracts.d.ts","sourceRoot":"","sources":["../src/catalog-contracts.ts"],"names":[],"mappings":"AAAA,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GAAG,SAAS,GAAG,SAAS,CAAC;AACtD,MAAM,MAAM,mBAAmB,GAC3B,UAAU,GACV,SAAS,GACT,aAAa,GACb,YAAY,CAAC;AACjB,MAAM,MAAM,gBAAgB,GACxB,MAAM,GACN,UAAU,GACV,OAAO,GACP,OAAO,GACP,cAAc,GACd,gBAAgB,CAAC;AAErB,8EAA8E;AAC9E,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,mBAAmB,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8DAA8D;IAC9D,mBAAmB,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAC1C;AAED,oFAAoF;AACpF,UAAU,6BAA6B;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,CAAA;KAAE,CAAC;CACpD;AACD,MAAM,MAAM,6BAA6B,GAAG,6BAA6B,GACvE,CACI;IACE,MAAM,EAAE,KAAK,GAAG,KAAK,GAAG,MAAM,CAAC;IAC/B,SAAS,EACL,iBAAiB,GACjB,iBAAiB,GACjB,yEAAyE,CAAC;IAC9E,WAAW,EACP;QAAE,MAAM,EAAE,WAAW,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,GACzC;QAAE,MAAM,EAAE,oBAAoB,CAAA;KAAE,GAChC;QAAE,MAAM,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAChD,GACD;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,kFAAkF;IAClF,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,WAAW,EAAE;QACX,MAAM,EAAE,gBAAgB,CAAC;QACzB,MAAM,EAAE,sBAAsB,GAAG,2BAA2B,CAAC;KAC9D,CAAC;CACH,CACJ,CAAC;AACJ,MAAM,MAAM,oCAAoC,GAC5C;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,YAAY,EAAE,UAAU,GAAG,QAAQ,CAAA;CAAE,GACtD;IACE,OAAO,EAAE,KAAK,CAAC;IACf,MAAM,EACF,oBAAoB,GACpB,oBAAoB,GACpB,gBAAgB,GAChB,YAAY,GACZ,iCAAiC,CAAC;IACtC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEN,mFAAmF;AACnF,MAAM,WAAW,mBAAmB;IAClC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,eAAe,EAAE,sBAAsB,CAAC;IACxC,UAAU,EAAE,iBAAiB,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uEAAuE;IACvE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iFAAiF;IACjF,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,yFAAyF;AACzF,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,mBAAmB,EAAE,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,OAAO,CAAC;IAClB,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,mFAAmF;IACnF,UAAU,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAClC,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACzC;AAED,MAAM,WAAW,qBAAqB;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,qFAAqF;IACrF,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,kBAAkB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,KAAK,EAAE;QACf,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,UAAU,EAAE,qBAAqB,CAAC;KACnC,GAAG,OAAO,CAAC,eAAe,CAAC,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,CAAC,KAAK,EAAE;QACb,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,MAAM,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1B"}
+{"version":3,"file":"catalog-contracts.d.ts","sourceRoot":"","sources":["../src/catalog-contracts.ts"],"names":[],"mappings":"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"}

package/dist/catalog-database-sync-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-database-sync-store.d.ts","sourceRoot":"","sources":["../src/catalog-database-sync-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA2ClE,wEAAwE;AACxE,qBAAa,wBAAyB,YAAW,gBAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,iBAAiB;IAE5C,aAAa,CACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAQvC,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3D,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAazE"}
+{"version":3,"file":"catalog-database-sync-store.d.ts","sourceRoot":"","sources":["../src/catalog-database-sync-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAM5D,OAAO,KAAK,EACV,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,wBAAwB,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AA2ClE,wEAAwE;AACxE,qBAAa,wBAAyB,YAAW,gBAAgB;IACnD,OAAO,CAAC,QAAQ,CAAC,EAAE;gBAAF,EAAE,EAAE,iBAAiB;IAE5C,aAAa,CACjB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC;IAQvC,cAAc,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB3D,MAAM,CAAC,MAAM,EAAE,mBAAmB,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2DjE,cAAc,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAazE"}

package/dist/catalog-models.d.ts

@@ -1,5 +1,6 @@
 import { SmrtObject } from '@happyvertical/smrt-core';
 import type { CatalogLicenseState, CatalogResourceRepresentation, CatalogVisibility } from './catalog-contracts.js';
+import { type CatalogPreview } from './catalog-preview.js';
 /** Globally visible provider registration. Hosts configure adapters and credentials out of band. */
 export declare class CatalogProvider extends SmrtObject {
     providerId: string;
@@ -23,6 +24,10 @@ export declare class CatalogResource extends SmrtObject {
     availableFormats: string;
     /** Serialized observed representation; JSON null is legacy absence. */
     representation: string;
+    /** Exact revision-bound publisher preview, not an original or private asset grant. */
+    preview: string;
+    getPreview(): CatalogPreview | undefined;
+    setPreview(value: CatalogPreview | undefined): void;
     getRepresentation(): CatalogResourceRepresentation | undefined;
     setRepresentation(value: CatalogResourceRepresentation | undefined): void;
     licenseEvidence: string;

package/dist/catalog-models.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-models.d.ts","sourceRoot":"","sources":["../src/catalog-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAG/E,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAIhC,oGAAoG;AACpG,qBACa,eAAgB,SAAQ,UAAU;IAClB,UAAU,SAAM;IAChB,IAAI,SAAM;IACrC,MAAM,UAAQ;CACf;AAED,oFAAoF;AACpF,qBACa,eAAgB,SAAQ,UAAU;IAClB,UAAU,SAAM;IAChB,QAAQ,SAAM;IACd,QAAQ,SAAM;IACzC,YAAY,SAAM;IACS,KAAK,SAAM;IACtC,mBAAmB,SAAM;IACzB,MAAM,SAAM;IACZ,QAAQ,SAAQ;IAChB,MAAM,SAAQ;IACd,QAAQ,SAAM;IACd,YAAY,SAAM;IAClB,cAAc,SAAM;IACpB,gBAAgB,SAAQ;IACxB,uEAAuE;IACvE,cAAc,SAAU;IAExB,iBAAiB,IAAI,6BAA6B,GAAG,SAAS;IAG9D,iBAAiB,CAAC,KAAK,EAAE,6BAA6B,GAAG,SAAS,GAAG,IAAI;IAKzE,eAAe,SAAQ;IACvB,YAAY,EAAE,mBAAmB,CAAa;IAC9C,UAAU,EAAE,iBAAiB,CAAa;IAC1C,8EAA8E;IAC9E,aAAa,SAAM;IACnB,WAAW,SAAM;CAClB;AAED,0FAA0F;AAC1F,qBACa,gBAAiB,SAAQ,UAAU;IAC9C,kEAAkE;IACvC,UAAU,SAAM;IAC3C,MAAM,SAAM;IACZ,kFAAkF;IAClF,KAAK,SAAM;IACX,QAAQ,UAAS;IACjB,MAAM,UAAS;IACf,WAAW,SAAM;IACjB,aAAa,SAAK;IAClB,QAAQ,SAAQ;IAChB,gBAAgB,SAAM;CACvB;AAED,mFAAmF;AACnF,qBAEa,gBAAiB,SAAQ,UAAU;IAClC,QAAQ,SAAM;IACyB,UAAU,SAAM;IACxC,gBAAgB,SAAM;IACtB,gBAAgB,SAAM;CAClD;AAED,yFAAyF;AACzF,qBAEa,kBAAmB,SAAQ,UAAU;IACpC,QAAQ,SAAM;IACyB,UAAU,SAAM;IACf,WAAW,SAAM;IAC1C,QAAQ,SAAM;IACd,MAAM,SAAM;IACZ,MAAM,SAAM;IACvC,WAAW,SAAM;IACjB,OAAO,SAAM;CACd"}
+{"version":3,"file":"catalog-models.d.ts","sourceRoot":"","sources":["../src/catalog-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,UAAU,EAAQ,MAAM,0BAA0B,CAAC;AAG/E,OAAO,KAAK,EACV,mBAAmB,EACnB,6BAA6B,EAC7B,iBAAiB,EAClB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,KAAK,cAAc,EAEpB,MAAM,sBAAsB,CAAC;AAI9B,oGAAoG;AACpG,qBACa,eAAgB,SAAQ,UAAU;IAClB,UAAU,SAAM;IAChB,IAAI,SAAM;IACrC,MAAM,UAAQ;CACf;AAED,oFAAoF;AACpF,qBACa,eAAgB,SAAQ,UAAU;IAClB,UAAU,SAAM;IAChB,QAAQ,SAAM;IACd,QAAQ,SAAM;IACzC,YAAY,SAAM;IACS,KAAK,SAAM;IACtC,mBAAmB,SAAM;IACzB,MAAM,SAAM;IACZ,QAAQ,SAAQ;IAChB,MAAM,SAAQ;IACd,QAAQ,SAAM;IACd,YAAY,SAAM;IAClB,cAAc,SAAM;IACpB,gBAAgB,SAAQ;IACxB,uEAAuE;IACvE,cAAc,SAAU;IACxB,sFAAsF;IACtF,OAAO,SAAU;IAEjB,UAAU,IAAI,cAAc,GAAG,SAAS;IAGxC,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,SAAS,GAAG,IAAI;IAMnD,iBAAiB,IAAI,6BAA6B,GAAG,SAAS;IAG9D,iBAAiB,CAAC,KAAK,EAAE,6BAA6B,GAAG,SAAS,GAAG,IAAI;IAKzE,eAAe,SAAQ;IACvB,YAAY,EAAE,mBAAmB,CAAa;IAC9C,UAAU,EAAE,iBAAiB,CAAa;IAC1C,8EAA8E;IAC9E,aAAa,SAAM;IACnB,WAAW,SAAM;CAClB;AAED,0FAA0F;AAC1F,qBACa,gBAAiB,SAAQ,UAAU;IAC9C,kEAAkE;IACvC,UAAU,SAAM;IAC3C,MAAM,SAAM;IACZ,kFAAkF;IAClF,KAAK,SAAM;IACX,QAAQ,UAAS;IACjB,MAAM,UAAS;IACf,WAAW,SAAM;IACjB,aAAa,SAAK;IAClB,QAAQ,SAAQ;IAChB,gBAAgB,SAAM;CACvB;AAED,mFAAmF;AACnF,qBAEa,gBAAiB,SAAQ,UAAU;IAClC,QAAQ,SAAM;IACyB,UAAU,SAAM;IACxC,gBAAgB,SAAM;IACtB,gBAAgB,SAAM;CAClD;AAED,yFAAyF;AACzF,qBAEa,kBAAmB,SAAQ,UAAU;IACpC,QAAQ,SAAM;IACyB,UAAU,SAAM;IACf,WAAW,SAAM;IAC1C,QAAQ,SAAM;IACd,MAAM,SAAM;IACZ,MAAM,SAAM;IACvC,WAAW,SAAM;IACjB,OAAO,SAAM;CACd"}

package/dist/catalog-preview.d.ts

@@ -0,0 +1,63 @@
+import type { CatalogActor, CatalogSourceRecord } from './catalog-contracts.js';
+/** Publisher preview permission is independent of original-resource permissions. */
+export interface CatalogPreview {
+    providerId: 'illustrative-mathematics';
+    stableId: string;
+    revision: string;
+    /** Official publisher ImageFile identifier, never a caller-supplied URL. */
+    reference: string;
+    mediaType: 'image/png';
+    width: number;
+    height: number;
+    byteLength: number;
+    sha256: string;
+    alt: string;
+    rights: {
+        state: 'verified';
+        identifier: 'CC-BY-4.0';
+        sourceUrl: string;
+        attribution: string;
+        retrievedAt: string;
+        expiresAt?: string;
+    };
+}
+export declare const CATALOG_PREVIEW_MAX_BYTES: number;
+export declare const CATALOG_PREVIEW_MAX_DIMENSION = 4096;
+/** Parse persisted/untrusted optional metadata. Invalid metadata is unavailable. */
+export declare function normalizeCatalogPreview(value: unknown): CatalogPreview | undefined;
+/** Exact source/revision binding; expired or corrupt references are unavailable. */
+export declare function catalogPreviewFor(record: Pick<CatalogSourceRecord, 'providerId' | 'stableId' | 'revision' | 'preview'>, now?: number): CatalogPreview | undefined;
+/** Verify complete bounded static 8-bit RGB/RGBA PNG data; never transform originals. */
+export declare function catalogPreviewPngDimensions(bytes: Uint8Array): {
+    width: number;
+    height: number;
+};
+export interface CatalogPreviewStore {
+    /** Must read through the active actor/tenant-bound executor, never a global write bypass. */
+    getResource(id: string, actor: CatalogActor): Promise<(CatalogSourceRecord & {
+        id: string;
+        withdrawnAt?: string | null;
+    }) | undefined>;
+    /** Recheck live session, tenant membership and resource access on EVERY read, including cache hits. */
+    authorize(actor: CatalogActor, resource: CatalogSourceRecord & {
+        id: string;
+    }): Promise<boolean>;
+}
+export interface CatalogPreviewLoader {
+    /** Preview-only bytes, bounded by CATALOG_PREVIEW_MAX_BYTES; never acquire the original. */
+    loadPreview(preview: CatalogPreview): Promise<Uint8Array>;
+}
+/** Authorized serving of public publisher previews with a bounded, short-lived verified-byte cache. */
+export declare class CatalogPreviewService {
+    private readonly store;
+    private readonly loader;
+    private readonly cache;
+    private cacheBytes;
+    constructor(store: CatalogPreviewStore, loader: CatalogPreviewLoader);
+    serve(input: {
+        actor: CatalogActor;
+        resourceId: string;
+        revision: string;
+    }): Promise<Response>;
+}
+//# sourceMappingURL=catalog-preview.d.ts.map

package/dist/catalog-preview.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog-preview.d.ts","sourceRoot":"","sources":["../src/catalog-preview.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAGhF,oFAAoF;AACpF,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,0BAA0B,CAAC;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,4EAA4E;IAC5E,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,WAAW,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE;QACN,KAAK,EAAE,UAAU,CAAC;QAClB,UAAU,EAAE,WAAW,CAAC;QACxB,SAAS,EAAE,MAAM,CAAC;QAClB,WAAW,EAAE,MAAM,CAAC;QACpB,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC;CACH;AAED,eAAO,MAAM,yBAAyB,QAAkB,CAAC;AACzD,eAAO,MAAM,6BAA6B,OAAO,CAAC;AAElD,oFAAoF;AACpF,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,OAAO,GACb,cAAc,GAAG,SAAS,CAgF5B;AAED,oFAAoF;AACpF,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,IAAI,CACV,mBAAmB,EACnB,YAAY,GAAG,UAAU,GAAG,UAAU,GAAG,SAAS,CACnD,EACD,GAAG,SAAa,GACf,cAAc,GAAG,SAAS,CAS5B;AAED,yFAAyF;AACzF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,UAAU,GAAG;IAC9D,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB,CAqFA;AAED,MAAM,WAAW,mBAAmB;IAClC,6FAA6F;IAC7F,WAAW,CACT,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,YAAY,GAClB,OAAO,CACN,CAAC,mBAAmB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC,GACnE,SAAS,CACZ,CAAC;IACF,uGAAuG;IACvG,SAAS,CACP,KAAK,EAAE,YAAY,EACnB,QAAQ,EAAE,mBAAmB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CAAC,OAAO,CAAC,CAAC;CACrB;AACD,MAAM,WAAW,oBAAoB;IACnC,4FAA4F;IAC5F,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;CAC3D;AAED,uGAAuG;AACvG,qBAAa,qBAAqB;IAO9B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPzB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAGlB;IACJ,OAAO,CAAC,UAAU,CAAK;gBAEJ,KAAK,EAAE,mBAAmB,EAC1B,MAAM,EAAE,oBAAoB;IAGzC,KAAK,CAAC,KAAK,EAAE;QACjB,KAAK,EAAE,YAAY,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB,GAAG,OAAO,CAAC,QAAQ,CAAC;CA8FtB"}

package/dist/catalog-read-service.d.ts

@@ -1,5 +1,6 @@
 import type { CatalogActor, CatalogLicenseEvidence, CatalogResourceRepresentation, CatalogSourceRecord } from './catalog-contracts.js';
 import { CatalogPolicy } from './catalog-policy.js';
+import { type CatalogPreview } from './catalog-preview.js';
 export interface CatalogReadStore {
     search(input: {
         query?: string;
@@ -7,6 +8,7 @@ export interface CatalogReadStore {
         grade?: string;
     }): Promise<readonly (CatalogSourceRecord & {
         id: string;
+        withdrawnAt?: string | null;
     })[]>;
 }
 /** Deliberately metadata-only DTO: credentials, byte locations, and teacher records stay server-side. */
@@ -29,6 +31,7 @@ export interface CatalogResourceView {
     parentStableId?: string;
     availableFormats?: string[];
     representation?: CatalogResourceRepresentation;
+    preview?: CatalogPreview;
     license: Pick<CatalogLicenseEvidence, 'state' | 'identifier' | 'version' | 'attribution' | 'exceptions' | 'retrievedAt'>;
 }
 export declare class CatalogReadService {

package/dist/catalog-read-service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog-read-service.d.ts","sourceRoot":"","sources":["../src/catalog-read-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,KAAK,EAAE;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,GAAG,OAAO,CAAC,SAAS,CAAC,mBAAmB,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC,CAAC;CAChE;AAED,yGAAyG;AACzG,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,OAAO,EAAE,IAAI,CACX,sBAAsB,EACpB,OAAO,GACP,YAAY,GACZ,SAAS,GACT,aAAa,GACb,YAAY,GACZ,aAAa,CAChB,CAAC;CACH;AAED,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,gBAAgB,EACvB,MAAM,gBAAsB;IAGzC,MAAM,CACV,KAAK,EAAE,YAAY,EACnB,MAAM,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAChE,OAAO,CAAC,mBAAmB,EAAE,CAAC;IASjC,OAAO,CAAC,IAAI;CAiDb"}
+{"version":3,"file":"catalog-read-service.d.ts","sourceRoot":"","sources":["../src/catalog-read-service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,KAAK,cAAc,EAAqB,MAAM,sBAAsB,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,KAAK,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAC1E,SAAS,CAAC,mBAAmB,GAAG;QAC9B,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAC7B,CAAC,EAAE,CACL,CAAC;CACH;AAED,yGAAyG;AACzG,MAAM,WAAW,mBAAmB;IAClC,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,UAAU,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,cAAc,CAAC,EAAE,6BAA6B,CAAC;IAC/C,OAAO,CAAC,EAAE,cAAc,CAAC;IACzB,OAAO,EAAE,IAAI,CACX,sBAAsB,EACpB,OAAO,GACP,YAAY,GACZ,SAAS,GACT,aAAa,GACb,YAAY,GACZ,aAAa,CAChB,CAAC;CACH;AAED,qBAAa,kBAAkB;IAE3B,OAAO,CAAC,QAAQ,CAAC,KAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBADN,KAAK,EAAE,gBAAgB,EACvB,MAAM,gBAAsB;IAGzC,MAAM,CACV,KAAK,EAAE,YAAY,EACnB,MAAM,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAChE,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAWjC,OAAO,CAAC,IAAI;CAmDb"}

package/dist/catalog.d.ts

@@ -1,4 +1,4 @@
-import { SmrtObject } from '@happyvertical/smrt-core';
+import { SmrtObject, type SmrtSaveOptions } from '@happyvertical/smrt-core';
 export type CourseLicenseKind = 'own-work' | 'open-license' | 'personal-use-copy' | 'licensed-for-sharing';
 export type CourseModality = 'online' | 'printable' | 'kit' | 'video' | 'game' | 'mixed';
 export type CourseStatus = 'draft' | 'published' | 'archived';
@@ -25,7 +25,7 @@ export declare class Course extends SmrtObject {
     status: CourseStatus;
     constructor(options?: Record<string, unknown>);
     /** A personal copy remains pinned to its original family and license. */
-    save(): Promise<this>;
+    save(options?: SmrtSaveOptions): Promise<this>;
 }
 export declare class ExternalCourse extends Course {
 }
@@ -37,7 +37,7 @@ export declare class CourseSection extends SmrtObject {
     title: string;
     sortOrder: number;
     constructor(options?: Record<string, unknown>);
-    save(): Promise<this>;
+    save(options?: SmrtSaveOptions): Promise<this>;
 }
 export declare class Lesson extends SmrtObject {
     tenantId: string | null;
@@ -52,7 +52,7 @@ export declare class Lesson extends SmrtObject {
     externalRef: string;
     externalUrl: string;
     constructor(options?: Record<string, unknown>);
-    save(): Promise<this>;
+    save(options?: SmrtSaveOptions): Promise<this>;
 }
 export declare class Reading extends Lesson {
 }

package/dist/catalog.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,UAAU,EAEX,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,cAAc,GACd,mBAAmB,GACnB,sBAAsB,CAAC;AAC3B,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,KAAK,GACL,OAAO,GACP,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAwB9E,qBAEa,MAAO,SAAQ,UAAU;IACN,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,KAAK,SAAM;IACtC,OAAO,SAAM;IACb,WAAW,SAAM;IACjB,SAAS,SAAY;IACrB,SAAS,SAAM;IACf,SAAS,SAAM;IACf,OAAO,SAAM;IACb,WAAW,EAAE,iBAAiB,CAAc;IAC5C,WAAW,SAAM;IACjB,UAAU,SAAM;IAChB,OAAO,SAAM;IACb,IAAI,SAAM;IACV,QAAQ,SAAK;IACb,QAAQ,SAAK;IACb,UAAU,SAAO;IACjB,gBAAgB,SAAK;IACrB,QAAQ,EAAE,cAAc,CAAY;IACpC,MAAM,EAAE,YAAY,CAAW;gBACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKjD,yEAAyE;IAC1D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAyCrC;AAED,qBACa,cAAe,SAAQ,MAAM;CAAG;AAE7C,qBACa,cAAe,SAAQ,MAAM;CAAG;AAE7C,qBAEa,aAAc,SAAQ,UAAU;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACnB,QAAQ,SAAM;IAC7B,KAAK,SAAM;IACtC,SAAS,SAAK;gBACF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBrC;AAED,qBAEa,MAAO,SAAQ,UAAU;IACN,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACZ,SAAS,SAAM;IACrC,KAAK,SAAM;IACtC,IAAI,SAAM;IACV,SAAS,SAAK;IACd,gBAAgB,SAAK;IACrB,UAAU,SAAO;IACjB,QAAQ,EAAE,cAAc,CAAY;IACpC,cAAc,EAAE,oBAAoB,CAAY;IAChD,WAAW,SAAM;IACjB,WAAW,SAAM;gBACL,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAmBrC;AAED,qBACa,OAAQ,SAAQ,MAAM;CAAG;AACtC,qBACa,KAAM,SAAQ,MAAM;IAC/B,QAAQ,SAAM;gBACF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIlD;AACD,qBACa,SAAU,SAAQ,MAAM;IACnC,YAAY,SAAM;IAClB,SAAS,SAAM;IACf,KAAK,SAAK;IACD,cAAc,EAAE,oBAAoB,CAAY;gBAC7C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIlD;AACD,qBACa,QAAS,SAAQ,MAAM;CAAG"}
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../src/catalog.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,UAAU,EACV,KAAK,eAAe,EAErB,MAAM,0BAA0B,CAAC;AAGlC,MAAM,MAAM,iBAAiB,GACzB,UAAU,GACV,cAAc,GACd,mBAAmB,GACnB,sBAAsB,CAAC;AAC3B,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,KAAK,GACL,OAAO,GACP,MAAM,GACN,OAAO,CAAC;AACZ,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,WAAW,GAAG,UAAU,CAAC;AAC9D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,GAAG,UAAU,CAAC;AAwB9E,qBAEa,MAAO,SAAQ,UAAU;IACN,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IAClC,KAAK,SAAM;IACtC,OAAO,SAAM;IACb,WAAW,SAAM;IACjB,SAAS,SAAY;IACrB,SAAS,SAAM;IACf,SAAS,SAAM;IACf,OAAO,SAAM;IACb,WAAW,EAAE,iBAAiB,CAAc;IAC5C,WAAW,SAAM;IACjB,UAAU,SAAM;IAChB,OAAO,SAAM;IACb,IAAI,SAAM;IACV,QAAQ,SAAK;IACb,QAAQ,SAAK;IACb,UAAU,SAAO;IACjB,gBAAgB,SAAK;IACrB,QAAQ,EAAE,cAAc,CAAY;IACpC,MAAM,EAAE,YAAY,CAAW;gBACnB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAKjD,yEAAyE;IAC1D,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAyC9D;AAED,qBACa,cAAe,SAAQ,MAAM;CAAG;AAE7C,qBACa,cAAe,SAAQ,MAAM;CAAG;AAE7C,qBAEa,aAAc,SAAQ,UAAU;IACb,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACnB,QAAQ,SAAM;IAC7B,KAAK,SAAM;IACtC,SAAS,SAAK;gBACF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIlC,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB9D;AAED,qBAEa,MAAO,SAAQ,UAAU;IACN,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAQ;IACZ,SAAS,SAAM;IACrC,KAAK,SAAM;IACtC,IAAI,SAAM;IACV,SAAS,SAAK;IACd,gBAAgB,SAAK;IACrB,UAAU,SAAO;IACjB,QAAQ,EAAE,cAAc,CAAY;IACpC,cAAc,EAAE,oBAAoB,CAAY;IAChD,WAAW,SAAM;IACjB,WAAW,SAAM;gBACL,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIlC,IAAI,CAAC,OAAO,CAAC,EAAE,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAmB9D;AAED,qBACa,OAAQ,SAAQ,MAAM;CAAG;AACtC,qBACa,KAAM,SAAQ,MAAM;IAC/B,QAAQ,SAAM;gBACF,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIlD;AACD,qBACa,SAAU,SAAQ,MAAM;IACnC,YAAY,SAAM;IAClB,SAAS,SAAM;IACf,KAAK,SAAK;IACD,cAAc,EAAE,oBAAoB,CAAY;gBAC7C,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;CAIlD;AACD,qBACa,QAAS,SAAQ,MAAM;CAAG"}