@arcadiasystems/morse-sdk 0.1.0

package/dist/read/index.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Public barrel for the read layer.
+ */
+export { type EntryListPage, type ListEntriesOptions, type ListPublicationsOptions, type ListPublisherCapsOptions, type OwnedPublication, type PublicationListPage, type PublicationReader, type PublisherCapListPage, RpcPublicationReader, type ScanEntriesOptions, } from "./reader.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/read/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACN,KAAK,aAAa,EAClB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,EAC5B,KAAK,wBAAwB,EAC7B,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,oBAAoB,EACpB,KAAK,kBAAkB,GACvB,MAAM,aAAa,CAAC"}

package/dist/read/index.js

@@ -0,0 +1,5 @@
+/**
+ * Public barrel for the read layer.
+ */
+export { RpcPublicationReader, } from "./reader.js";
+//# sourceMappingURL=index.js.map

package/dist/read/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/read/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EASN,oBAAoB,GAEpB,MAAM,aAAa,CAAC"}

package/dist/read/reader.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Read layer for publications: a swappable interface plus an RPC-backed
+ * implementation. Future indexer implementations satisfy the same interface.
+ */
+import type { ObjectReader } from "../clients.js";
+import type { Entry, OwnerCapId, PackageId, Publication, PublicationId, PublisherCap, PublisherCapId, Revision, SuiAddress } from "../types.js";
+/** Lightweight handle returned by `listPublicationsOwnedBy`. */
+export interface OwnedPublication {
+    readonly ownerCapId: OwnerCapId;
+    readonly publicationId: PublicationId;
+}
+/** Result of a single page of `listPublicationsOwnedBy`. */
+export interface PublicationListPage {
+    readonly results: readonly OwnedPublication[];
+    readonly nextCursor: string | null;
+}
+/** Options for `listPublicationsOwnedBy`. */
+export interface ListPublicationsOptions {
+    readonly limit?: number;
+    readonly cursor?: string;
+    readonly signal?: AbortSignal;
+}
+/** Result of a single page of `listPublisherCapsOwnedBy`. */
+export interface PublisherCapListPage {
+    readonly results: readonly PublisherCap[];
+    readonly nextCursor: string | null;
+}
+/** Options for `listPublisherCapsOwnedBy`. */
+export interface ListPublisherCapsOptions {
+    readonly limit?: number;
+    readonly cursor?: string;
+    readonly signal?: AbortSignal;
+}
+/** Result of a single page of `listEntries`. */
+export interface EntryListPage {
+    readonly results: readonly Entry[];
+    readonly nextCursor: string | null;
+}
+/**
+ * Options for `listEntries`. Order is the dynamic-field object-store order, not
+ * insertion order; sort by `entry.id` for chronological order. By default
+ * `limit` is `DEFAULT_PAGE_LIMIT` and the cursor is opaque to consumers.
+ */
+export interface ListEntriesOptions {
+    readonly limit?: number;
+    readonly cursor?: string;
+    readonly signal?: AbortSignal;
+}
+/** Options for `scanEntries`. `pageSize` controls the per-RPC page size. */
+export interface ScanEntriesOptions {
+    readonly pageSize?: number;
+    readonly signal?: AbortSignal;
+}
+/**
+ * Read-only access to the publication domain: publications and the
+ * PublisherCaps that grant write access to them.
+ */
+export interface PublicationReader {
+    /**
+     * Fetch a publication by ID.
+     * @throws {NotFoundError} If no object exists at the given ID.
+     * @throws {ValidationError} If the on-chain JSON does not match the expected shape.
+     * @throws {TransportError} On RPC failure.
+     */
+    getPublication(id: PublicationId, signal?: AbortSignal): Promise<Publication>;
+    /**
+     * Page through publications owned (via OwnerCap) by an address.
+     * @throws {TransportError} On RPC failure.
+     */
+    listPublicationsOwnedBy(address: SuiAddress, options?: ListPublicationsOptions): Promise<PublicationListPage>;
+    /**
+     * Fetch a PublisherCap by ID.
+     * @throws {NotFoundError} If no object exists at the given ID.
+     * @throws {ValidationError} If the on-chain JSON does not match the expected shape.
+     * @throws {TransportError} On RPC failure.
+     */
+    getPublisherCap(id: PublisherCapId, signal?: AbortSignal): Promise<PublisherCap>;
+    /**
+     * Page through PublisherCaps owned by an address.
+     * @throws {TransportError} On RPC failure.
+     */
+    listPublisherCapsOwnedBy(address: SuiAddress, options?: ListPublisherCapsOptions): Promise<PublisherCapListPage>;
+    /**
+     * Fetch a single entry by collection name and entry id.
+     * @throws {NotFoundError} If the collection or entry does not exist.
+     * @throws {ValidationError} If the on-chain bytes do not match the BCS schema.
+     * @throws {TransportError} On RPC failure.
+     */
+    getEntry(publicationId: PublicationId, collectionName: string, entryId: number, signal?: AbortSignal): Promise<Entry>;
+    /**
+     * Fetch a single revision by collection name, entry id, and revision id.
+     * @throws {NotFoundError} If the collection, entry, or revision does not exist.
+     * @throws {ValidationError} If the on-chain bytes do not match the BCS schema.
+     * @throws {TransportError} On RPC failure.
+     */
+    getRevision(publicationId: PublicationId, collectionName: string, entryId: number, revisionId: number, signal?: AbortSignal): Promise<Revision>;
+    /**
+     * Page through entries in a collection. See `ListEntriesOptions` for
+     * ordering and pagination semantics.
+     *
+     * @throws {NotFoundError} If the collection does not exist.
+     * @throws {ValidationError} If the on-chain bytes do not match the BCS schema.
+     * @throws {TransportError} On RPC failure.
+     */
+    listEntries(publicationId: PublicationId, collectionName: string, options?: ListEntriesOptions): Promise<EntryListPage>;
+    /**
+     * Iterate every entry in a collection. Auto-paginates `listEntries` until
+     * the cursor is exhausted; consumers can `for await` and break early. Same
+     * ordering caveat as `listEntries` (object-store, not chronological).
+     *
+     * @throws {NotFoundError} If the collection does not exist.
+     * @throws {ValidationError} If the on-chain bytes do not match the BCS schema.
+     * @throws {TransportError} On RPC failure.
+     */
+    scanEntries(publicationId: PublicationId, collectionName: string, options?: ScanEntriesOptions): AsyncIterable<Entry>;
+}
+/** RPC-backed `PublicationReader` using a Sui client. */
+export declare class RpcPublicationReader implements PublicationReader {
+    private readonly client;
+    private readonly originalPackageId;
+    /**
+     * @param originalPackageId The canonical (`original-id`) package address.
+     *   Required by Sui type filters, which always use the original-id form
+     *   regardless of the package's current upgrade version.
+     */
+    constructor(client: ObjectReader, originalPackageId: PackageId);
+    /**
+     * Build a reader from a morse package config (typically the value returned
+     * by `morseConfig({network})`). Picks `originalPackageId ?? packageId`
+     * internally; passing the post-upgrade `packageId` to the constructor
+     * directly would silently empty type-filtered list results.
+     */
+    static fromMorseConfig(config: {
+        packageId: PackageId;
+        originalPackageId?: PackageId;
+    }, client: ObjectReader): RpcPublicationReader;
+    getPublication(id: PublicationId, signal?: AbortSignal): Promise<Publication>;
+    listPublicationsOwnedBy(address: SuiAddress, options?: ListPublicationsOptions): Promise<PublicationListPage>;
+    getPublisherCap(id: PublisherCapId, signal?: AbortSignal): Promise<PublisherCap>;
+    listPublisherCapsOwnedBy(address: SuiAddress, options?: ListPublisherCapsOptions): Promise<PublisherCapListPage>;
+    getEntry(publicationId: PublicationId, collectionName: string, entryId: number, signal?: AbortSignal): Promise<Entry>;
+    getRevision(publicationId: PublicationId, collectionName: string, entryId: number, revisionId: number, signal?: AbortSignal): Promise<Revision>;
+    listEntries(publicationId: PublicationId, collectionName: string, options?: ListEntriesOptions): Promise<EntryListPage>;
+    scanEntries(publicationId: PublicationId, collectionName: string, options?: ScanEntriesOptions): AsyncIterable<Entry>;
+    private entriesTableId;
+    private callClient;
+}
+//# sourceMappingURL=reader.d.ts.map

package/dist/read/reader.d.ts.map

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

package/dist/read/reader.js

@@ -0,0 +1,403 @@
+/**
+ * Read layer for publications: a swappable interface plus an RPC-backed
+ * implementation. Future indexer implementations satisfy the same interface.
+ */
+import { accessPolicyFromU8, storageModeFromU8, toBlobObjectId, toOwnerCapId, toPublicationId, toPublisherCapId, toQuiltPatchId, toSuiAddress, toSuiObjectId, } from "../codecs.js";
+import { NotFoundError, TransportError, ValidationError } from "../errors.js";
+import { EntryBcs, EntryIdBcs } from "./entry-bcs.js";
+const DEFAULT_PAGE_LIMIT = 50;
+/** RPC-backed `PublicationReader` using a Sui client. */
+export class RpcPublicationReader {
+    client;
+    originalPackageId;
+    /**
+     * @param originalPackageId The canonical (`original-id`) package address.
+     *   Required by Sui type filters, which always use the original-id form
+     *   regardless of the package's current upgrade version.
+     */
+    constructor(client, originalPackageId) {
+        this.client = client;
+        this.originalPackageId = originalPackageId;
+    }
+    /**
+     * Build a reader from a morse package config (typically the value returned
+     * by `morseConfig({network})`). Picks `originalPackageId ?? packageId`
+     * internally; passing the post-upgrade `packageId` to the constructor
+     * directly would silently empty type-filtered list results.
+     */
+    static fromMorseConfig(config, client) {
+        return new RpcPublicationReader(client, config.originalPackageId ?? config.packageId);
+    }
+    async getPublication(id, signal) {
+        let response;
+        try {
+            response = await this.callClient("getObject", () => this.client.getObject({
+                objectId: id,
+                include: { json: true },
+                ...(signal === undefined ? {} : { signal }),
+            }));
+        }
+        catch (error) {
+            if (error instanceof TransportError &&
+                isObjectNotFoundError(error.cause, id)) {
+                throw new NotFoundError("publication", id, { cause: error.cause });
+            }
+            throw error;
+        }
+        const object = response.object;
+        if (!object) {
+            throw new NotFoundError("publication", id);
+        }
+        return parsePublication(object);
+    }
+    async listPublicationsOwnedBy(address, options = {}) {
+        const { limit = DEFAULT_PAGE_LIMIT, cursor, signal } = options;
+        const ownerCapType = `${this.originalPackageId}::publication::OwnerCap`;
+        const response = await this.callClient("listOwnedObjects", () => this.client.listOwnedObjects({
+            owner: address,
+            type: ownerCapType,
+            limit,
+            cursor: cursor ?? null,
+            include: { json: true },
+            ...(signal === undefined ? {} : { signal }),
+        }));
+        const results = response.objects.map((object) => parseOwnedPublication(object));
+        return { results, nextCursor: response.cursor };
+    }
+    async getPublisherCap(id, signal) {
+        let response;
+        try {
+            response = await this.callClient("getObject", () => this.client.getObject({
+                objectId: id,
+                include: { json: true },
+                ...(signal === undefined ? {} : { signal }),
+            }));
+        }
+        catch (error) {
+            if (error instanceof TransportError &&
+                isObjectNotFoundError(error.cause, id)) {
+                throw new NotFoundError("publisher-cap", id, { cause: error.cause });
+            }
+            throw error;
+        }
+        const object = response.object;
+        if (!object) {
+            throw new NotFoundError("publisher-cap", id);
+        }
+        return parsePublisherCap(object);
+    }
+    async listPublisherCapsOwnedBy(address, options = {}) {
+        const { limit = DEFAULT_PAGE_LIMIT, cursor, signal } = options;
+        const publisherCapType = `${this.originalPackageId}::publication::PublisherCap`;
+        const response = await this.callClient("listOwnedObjects", () => this.client.listOwnedObjects({
+            owner: address,
+            type: publisherCapType,
+            limit,
+            cursor: cursor ?? null,
+            include: { json: true },
+            ...(signal === undefined ? {} : { signal }),
+        }));
+        const results = response.objects.map((object) => parsePublisherCap(object));
+        return { results, nextCursor: response.cursor };
+    }
+    async getEntry(publicationId, collectionName, entryId, signal) {
+        const tableId = await this.entriesTableId(publicationId, collectionName, signal);
+        const nameBcs = EntryIdBcs.serialize(entryId).toBytes();
+        let response;
+        try {
+            response = await this.callClient("getDynamicField", () => this.client.getDynamicField({
+                parentId: tableId,
+                name: { type: "u64", bcs: nameBcs },
+                ...(signal === undefined ? {} : { signal }),
+            }));
+        }
+        catch (error) {
+            if (error instanceof TransportError &&
+                isDynamicFieldNotFoundError(error.cause)) {
+                throw new NotFoundError("entry", `${collectionName}:${entryId}`, {
+                    cause: error.cause,
+                });
+            }
+            throw error;
+        }
+        return parseEntry(response.dynamicField.value.bcs, entryId);
+    }
+    async getRevision(publicationId, collectionName, entryId, revisionId, signal) {
+        const entry = await this.getEntry(publicationId, collectionName, entryId, signal);
+        const revision = entry.revisions[revisionId];
+        if (!revision) {
+            throw new NotFoundError("revision", `${collectionName}:${entryId}:${revisionId}`);
+        }
+        return revision;
+    }
+    async listEntries(publicationId, collectionName, options = {}) {
+        const { limit = DEFAULT_PAGE_LIMIT, cursor, signal } = options;
+        const tableId = await this.entriesTableId(publicationId, collectionName, signal);
+        const response = await this.callClient("listDynamicFields", () => this.client.listDynamicFields({
+            parentId: tableId,
+            limit,
+            cursor: cursor ?? null,
+            include: { value: true },
+            ...(signal === undefined ? {} : { signal }),
+        }));
+        const results = response.dynamicFields.map((field) => parseDynamicEntry(field));
+        return { results, nextCursor: response.cursor };
+    }
+    async *scanEntries(publicationId, collectionName, options = {}) {
+        const { pageSize = DEFAULT_PAGE_LIMIT, signal } = options;
+        let cursor;
+        while (true) {
+            const page = await this.listEntries(publicationId, collectionName, {
+                limit: pageSize,
+                ...(cursor === undefined ? {} : { cursor }),
+                ...(signal === undefined ? {} : { signal }),
+            });
+            for (const entry of page.results) {
+                yield entry;
+            }
+            if (page.nextCursor === null) {
+                return;
+            }
+            cursor = page.nextCursor;
+        }
+    }
+    async entriesTableId(publicationId, collectionName, signal) {
+        const publication = await this.getPublication(publicationId, signal);
+        const collection = publication.collections.find((c) => c.name === collectionName);
+        if (!collection) {
+            throw new NotFoundError("collection", `${publicationId}:${collectionName}`);
+        }
+        return collection.entriesTableId;
+    }
+    async callClient(operation, call) {
+        try {
+            return await call();
+        }
+        catch (cause) {
+            throw new TransportError(`${operation} failed`, { cause });
+        }
+    }
+}
+function parsePublication(object) {
+    const json = object.json;
+    if (!json) {
+        throw new ValidationError(`Publication ${object.objectId} has no parsed JSON content`, "publication.json");
+    }
+    const id = toPublicationId(object.objectId);
+    const name = readString(json, "name", "publication.name");
+    const slug = readString(json, "slug", "publication.slug");
+    const collections = parseCollections(json.collections);
+    const revokedPublisherCapsTableId = parseTableId(json.revoked_publisher_caps, "publication.revoked_publisher_caps");
+    return {
+        id,
+        name,
+        slug,
+        collections,
+        revokedPublisherCapsTableId,
+    };
+}
+function parseCollections(value) {
+    if (value === null || typeof value !== "object") {
+        throw new ValidationError("Publication collections field is missing or not an object", "publication.collections");
+    }
+    const contents = value.contents;
+    if (!Array.isArray(contents)) {
+        throw new ValidationError("Publication collections.contents is not an array", "publication.collections.contents");
+    }
+    return contents.map((entry, index) => parseCollection(entry, index));
+}
+function parseCollection(value, index) {
+    const path = `publication.collections[${index}]`;
+    if (value === null || typeof value !== "object") {
+        throw new ValidationError(`${path} is not an object`, path);
+    }
+    const inner = value.value;
+    if (inner === null || typeof inner !== "object") {
+        throw new ValidationError(`${path}.value is not an object`, `${path}.value`);
+    }
+    const collection = inner;
+    return {
+        name: readString(collection, "name", `${path}.name`),
+        storageMode: storageModeFromU8(readU8(collection, "storage_mode", `${path}.storage_mode`)),
+        nextEntryId: readSafeInteger(collection, "next_entry_id", `${path}.next_entry_id`),
+        entriesTableId: parseTableId(collection.entries, `${path}.entries`),
+    };
+}
+function parsePublisherCap(object) {
+    const json = object.json;
+    if (!json || typeof json !== "object") {
+        throw new ValidationError(`PublisherCap ${object.objectId} has no parsed JSON content`, "publisherCap.json");
+    }
+    // Move `ID` and `address` fields serialize as bare hex strings.
+    // Move `UID` (e.g. the struct's own `id` field) serializes as `{ id: "0x..." }`;
+    // we use `object.objectId` from the SDK metadata wrapper for the cap's ID instead.
+    const fields = json;
+    if (typeof fields.publication_id !== "string") {
+        throw new ValidationError("PublisherCap.publication_id is missing or not a string", "publisherCap.publication_id");
+    }
+    if (typeof fields.holder !== "string") {
+        throw new ValidationError("PublisherCap.holder is missing or not a string", "publisherCap.holder");
+    }
+    return {
+        id: toPublisherCapId(object.objectId),
+        publicationId: toPublicationId(fields.publication_id),
+        holder: toSuiAddress(fields.holder),
+    };
+}
+function parseOwnedPublication(object) {
+    const json = object.json;
+    if (!json || typeof json !== "object") {
+        throw new ValidationError(`OwnerCap ${object.objectId} has no parsed JSON content`, "ownerCap.json");
+    }
+    const publicationIdRaw = json
+        .publication_id;
+    if (typeof publicationIdRaw !== "string") {
+        throw new ValidationError("OwnerCap.publication_id is missing or not a string", "ownerCap.publication_id");
+    }
+    return {
+        ownerCapId: toOwnerCapId(object.objectId),
+        publicationId: toPublicationId(publicationIdRaw),
+    };
+}
+function readString(json, key, field) {
+    const value = json[key];
+    if (typeof value !== "string") {
+        throw new ValidationError(`Field ${field} is missing or not a string`, field);
+    }
+    return value;
+}
+function readU8(json, key, field) {
+    const raw = json[key];
+    const value = typeof raw === "string" ? Number(raw) : raw;
+    if (typeof value !== "number" ||
+        !Number.isInteger(value) ||
+        value < 0 ||
+        value > 255) {
+        throw new ValidationError(`Field ${field} is not a valid u8: ${JSON.stringify(raw)}`, field);
+    }
+    return value;
+}
+function readSafeInteger(json, key, field) {
+    const raw = json[key];
+    const value = typeof raw === "string" ? Number(raw) : raw;
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < 0) {
+        throw new ValidationError(`Field ${field} is not a non-negative safe integer: ${JSON.stringify(raw)}`, field);
+    }
+    return value;
+}
+/**
+ * Detect the specific Sui gRPC per-object "not found" error. Matches the
+ * `Object {id} not found` message format thrown by the batch object lookup
+ * so unrelated transport failures (timeouts, service unavailable) are not
+ * misclassified as missing objects.
+ *
+ * Uses the same anchored regex strategy as `isDynamicFieldNotFoundError`,
+ * not exact equality, so a future Sui gRPC release that adds a trailing
+ * detail (e.g. `Object 0x... not found at version N`) still matches without
+ * silently degrading to "transport failure". Anchoring with `^...$` keeps
+ * substring false positives out (e.g. "service unavailable: connection not
+ * found"). The `objectId` is matched literally for caller-side specificity.
+ */
+function isObjectNotFoundError(cause, objectId) {
+    if (!(cause instanceof Error)) {
+        return false;
+    }
+    const escaped = objectId.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+    return new RegExp(`^Object ${escaped} not found(\\b|$)`).test(cause.message);
+}
+function parseEntry(bcs, entryId) {
+    let parsed;
+    try {
+        parsed = EntryBcs.parse(bcs);
+    }
+    catch (cause) {
+        throw new ValidationError(`Failed to decode Entry BCS for id ${entryId}: ${cause instanceof Error ? cause.message : String(cause)}`, "entry.bcs", { cause });
+    }
+    return {
+        id: entryId,
+        name: parsed.name,
+        revisions: parsed.revisions.map((r, i) => convertRevision(r, i)),
+        draftHead: parsed.draft_head === null ? null : safeIntFromBig(parsed.draft_head),
+        publicHead: parsed.public_head === null ? null : safeIntFromBig(parsed.public_head),
+    };
+}
+function parseDynamicEntry(field) {
+    if (!field.value) {
+        throw new ValidationError(`Dynamic field ${field.fieldId} returned without value despite include.value=true`, "dynamicField.value");
+    }
+    let id;
+    try {
+        id = EntryIdBcs.parse(field.name.bcs);
+    }
+    catch (cause) {
+        throw new ValidationError(`Failed to decode entry id from dynamic-field name`, "dynamicField.name", { cause });
+    }
+    const numericId = safeIntFromString(id);
+    return parseEntry(field.value.bcs, numericId);
+}
+function convertRevision(parsed, index) {
+    return {
+        id: index,
+        blobRef: convertBlobRef(parsed.blob_ref),
+        contentType: parsed.content_type,
+        encrypted: parsed.encrypted,
+        accessPolicy: accessPolicyFromU8(parsed.access_policy),
+        // On-chain bytes have already passed Move's `assert_valid_publisher_seal_id`
+        // invariants (length, prefix, policy tag), so we brand them here without
+        // re-validating client-side. This lets `Revision.sealId` flow directly into
+        // `SealAdapter.decrypt` without a consumer-side cast.
+        sealId: parsed.seal_id === null
+            ? null
+            : new Uint8Array(parsed.seal_id),
+        author: toSuiAddress(parsed.author),
+    };
+}
+function convertBlobRef(parsed) {
+    if (parsed.$kind === "Blob") {
+        return { kind: "blob", blobObjectId: toBlobObjectId(parsed.Blob) };
+    }
+    return {
+        kind: "quilt",
+        patchId: toQuiltPatchId(new Uint8Array(parsed.QuiltPatch)),
+    };
+}
+function safeIntFromBig(value) {
+    const asNumber = Number(value);
+    if (!Number.isSafeInteger(asNumber) || asNumber < 0) {
+        throw new ValidationError(`u64 value ${value} exceeds Number.MAX_SAFE_INTEGER`, "u64");
+    }
+    return asNumber;
+}
+function safeIntFromString(value) {
+    return safeIntFromBig(value);
+}
+/**
+ * Match the Sui gRPC core's "Object 0x... not found" message format. The
+ * dynamic-field RPC routes through batch-getObjects under the hood and
+ * surfaces the same shape. Loose substring matches misclassify transport
+ * failures (e.g. "service unavailable: connection not found") as missing
+ * objects.
+ */
+function isDynamicFieldNotFoundError(cause) {
+    if (!(cause instanceof Error)) {
+        return false;
+    }
+    return /^Object 0x[0-9a-f]+ not found$/i.test(cause.message);
+}
+function parseTableId(value, field) {
+    if (value === null || typeof value !== "object") {
+        throw new ValidationError(`Field ${field} is not an object`, field);
+    }
+    const id = value.id;
+    if (typeof id === "string") {
+        return toSuiObjectId(id);
+    }
+    if (id !== null && typeof id === "object") {
+        const innerId = id.id;
+        if (typeof innerId === "string") {
+            return toSuiObjectId(innerId);
+        }
+    }
+    throw new ValidationError(`Field ${field}.id is not a string or { id: string }`, `${field}.id`);
+}
+//# sourceMappingURL=reader.js.map

package/dist/read/reader.js.map

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

package/dist/seal/adapter.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Seal adapter interface: encrypt content under a publisher Seal identity
+ * and decrypt with a consumer-supplied `SessionKey`. Configuration
+ * (key servers, threshold, package id) is bound at construction time.
+ */
+import type { SessionKey } from "@mysten/seal";
+import type { PublisherCapId, SealId } from "../types.js";
+export interface SealEncryptOptions {
+    readonly sealId: SealId;
+    /** Optional additional authenticated data bound into the ciphertext. */
+    readonly aad?: Uint8Array;
+}
+export interface SealEncryptResult {
+    readonly ciphertext: Uint8Array;
+}
+export interface SealDecryptOptions {
+    /**
+     * Session key constructed by the consumer's wallet (out-of-band: requires
+     * a signed personal message). The SDK never builds session keys silently.
+     */
+    readonly sessionKey: SessionKey;
+    readonly sealId: SealId;
+    readonly publisherCapId: PublisherCapId;
+}
+/**
+ * Combined Seal adapter. Implementations bundle a `SealClient`, the morse
+ * package id (Seal binds it into ciphertext envelopes), and a TSS threshold.
+ * Errors normalize to `SealError` (content/authorization failures) or
+ * `TransportError` (network).
+ */
+export interface SealAdapter {
+    /**
+     * Encrypt `plaintext` under the supplied Seal identity. The ciphertext
+     * envelope binds the morse package id and the TSS threshold; decrypting
+     * later requires the same key-server set and threshold the adapter was
+     * constructed with.
+     *
+     * @throws {SealError} On Seal-side encryption failure (rare).
+     * @throws {TransportError} On network failure.
+     */
+    encrypt(plaintext: Uint8Array, options: SealEncryptOptions): Promise<SealEncryptResult>;
+    /**
+     * Decrypt `ciphertext` produced by an earlier `encrypt` call. The Seal
+     * key servers verify that `publisherCapId` is active (not in the
+     * publication's revoked denylist) before issuing decryption material;
+     * a revoked cap surfaces as `SealError("no-access")`.
+     *
+     * @throws {SealError} On Seal authorization failure (`no-access`),
+     *   decryption failure (`decrypt-failed` — also raised when `sealId` is
+     *   malformed), session-key expiry (`session-expired`), or rate
+     *   limiting (`rate-limited`).
+     * @throws {TransportError} On network or PTB build failure.
+     */
+    decrypt(ciphertext: Uint8Array, options: SealDecryptOptions): Promise<Uint8Array>;
+}
+//# sourceMappingURL=adapter.d.ts.map