emdash 1.3.0 → 1.3.1

package/dist/client/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/client/index.ts"],"sourcesContent":["/**\n * EmDashClient — typed HTTP client for the EmDash REST API.\n *\n * Handles auth, CSRF, PT ↔ Markdown conversion, and optional `_rev`\n * concurrency tokens. Shared foundation for the CLI and future MCP server.\n *\n * @example\n * ```ts\n * import { EmDashClient } from \"emdash/client\";\n *\n * const client = new EmDashClient({\n *   baseUrl: \"http://localhost:4321\",\n *   devBypass: true,\n * });\n *\n * const posts = await client.list(\"posts\", { status: \"published\" });\n * ```\n */\n\nimport mime from \"mime/lite\";\n\nimport type { ContentFieldFilters } from \"../content-list-query.js\";\nimport type {\n\tBlockType,\n\tCreateBlockTypeInput,\n\tUpdateBlockTypeInput,\n} from \"../schema/block-types.js\";\nimport type { Sha256Digest } from \"../transfer/format/digest.js\";\nimport type { SiteImportDecisionsInput, SiteImportPlan } from \"../transfer/format/plan.js\";\nimport type { SiteImportReceipt } from \"../transfer/format/receipt.js\";\nimport type { PublicTransferOperation } from \"../transfer/ops/operations.js\";\nimport type { FieldSchema } from \"./portable-text.js\";\nimport { convertDataForRead, convertDataForWrite } from \"./portable-text.js\";\nimport type { Interceptor } from \"./transport.js\";\nimport {\n\tcreateTransport,\n\tcsrfInterceptor,\n\tdevBypassInterceptor,\n\trefreshInterceptor,\n\ttokenInterceptor,\n} from \"./transport.js\";\n\n// Regex patterns for client utilities\nconst TRAILING_SLASH_PATTERN = /\\/$/;\nconst DECIMAL_PATTERN = /^\\d+$/;\nconst SHA256_ETAG_PATTERN = /^\"([0-9a-f]{64})\"$/;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction mimeFromFilename(filename: string): string {\n\treturn mime.getType(filename) ?? \"application/octet-stream\";\n}\n\nfunction idempotencyHeader(request: { idempotencyKey?: string }): Record<string, string> {\n\treturn request.idempotencyKey === undefined ? {} : { \"Idempotency-Key\": request.idempotencyKey };\n}\n\nfunction pageQuery(options?: { limit?: number; cursor?: string }): string {\n\tconst params = new URLSearchParams();\n\tif (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n\tif (options?.cursor !== undefined) params.set(\"cursor\", options.cursor);\n\tconst qs = params.toString();\n\treturn qs ? `?${qs}` : \"\";\n}\n\n/** Encode a site package path (`records/post/000000.ndjson`) segment by segment */\nfunction encodePackagePath(path: string): string {\n\treturn path.split(\"/\").map(encodeURIComponent).join(\"/\");\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface EmDashClientOptions {\n\t/** Base URL of the EmDash instance */\n\tbaseUrl: string;\n\t/** API token (ec_pat_...) or OAuth token (ec_oat_...) */\n\ttoken?: string;\n\t/** OAuth refresh token for auto-refresh on 401 */\n\trefreshToken?: string;\n\t/** Called when a token is refreshed (for persisting new access token) */\n\tonTokenRefresh?: (accessToken: string, expiresIn: number) => void;\n\t/** Use dev-bypass authentication (localhost only) */\n\tdevBypass?: boolean;\n\t/** Additional request interceptors */\n\tinterceptors?: Interceptor[];\n}\n\n/** Standard API error shape */\nexport interface ApiError {\n\tcode: string;\n\tmessage: string;\n\tdetails?: Record<string, unknown>;\n}\n\n/** Standard API response wrapper */\nexport interface ClientResponse<T> {\n\tsuccess: true;\n\tdata: T;\n}\n\n/** Paginated list response */\nexport interface ListResult<T> {\n\titems: T[];\n\tnextCursor?: string;\n}\n\n/** Content item as returned by the API */\nexport interface ContentItem {\n\tid: string;\n\ttype: string;\n\tslug: string | null;\n\tstatus: string;\n\tdata: Record<string, unknown>;\n\tauthorId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tpublishedAt: string | null;\n\tscheduledAt: string | null;\n\tliveRevisionId: string | null;\n\tdraftRevisionId: string | null;\n\tlocale: string | null;\n\ttranslationGroup: string | null;\n\t_rev?: string;\n}\n\n/** Collection metadata */\nexport interface Collection {\n\tslug: string;\n\tlabel: string;\n\tlabelSingular: string;\n\tdescription?: string;\n\ticon?: string;\n\tsupports: string[];\n}\n\n/** Collection with fields */\nexport interface CollectionWithFields extends Collection {\n\tfields: Field[];\n}\n\n/** Field metadata */\nexport interface Field {\n\tslug: string;\n\tlabel: string;\n\ttype: string;\n\trequired: boolean;\n\tunique: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: unknown;\n\twidget?: string;\n\toptions?: unknown;\n\tsortOrder?: number;\n\tblockTypes?: BlockType[];\n\tblockTypeFingerprint?: string;\n}\n\n/** Aggregate trust state for media usage reads */\nexport type MediaUsageCoverageStatus =\n\t| \"complete\"\n\t| \"never\"\n\t| \"running\"\n\t| \"partial\"\n\t| \"failed\"\n\t| \"stale\"\n\t| \"unknown\";\n\n/** Aggregate media usage coverage across all content collections */\nexport interface MediaUsageCoverage {\n\tscope: \"all_content_collections\";\n\tstatus: MediaUsageCoverageStatus;\n}\n\n/** Coverage-aware usage count for a media item */\nexport interface MediaUsageSummary {\n\tcount: number | null;\n\tcoverage: MediaUsageCoverage;\n}\n\n/** One indexed media reference within a content source */\nexport interface MediaUsageOccurrenceDetail {\n\tfieldSlug: string;\n\tfieldPath: string;\n\toccurrenceIndex: number;\n\treferenceType:\n\t\t| \"image_field\"\n\t\t| \"file_field\"\n\t\t| \"portable_text_image\"\n\t\t| \"portable_text_video\"\n\t\t| \"unknown\";\n}\n\n/** Indexed references from one visible content source */\nexport interface MediaUsageSourceDetail {\n\tvariant: \"columns\" | \"draft_overlay\";\n\toccurrences: MediaUsageOccurrenceDetail[];\n}\n\n/** One content entry that references a media item */\nexport interface MediaUsageEntryDetail {\n\tcollection: string;\n\tcontentId: string;\n\ttitle: string | null;\n\tslug: string | null;\n\tlocale: string | null;\n\tstatus: string | null;\n\tscheduledAt: string | null;\n\tdeletedAt: string | null;\n\tsources: MediaUsageSourceDetail[];\n}\n\n/** A site setting that selects a media item */\nexport interface MediaUsageSiteSettingDetail {\n\tsetting: \"logo\" | \"favicon\" | \"seo.defaultOgImage\";\n}\n\n/** Entry-grouped media usage details */\nexport interface MediaUsageDetailsResponse {\n\titems: MediaUsageEntryDetail[];\n\tnextCursor?: string;\n\tsiteSettings: MediaUsageSiteSettingDetail[];\n\tcoverage: MediaUsageCoverage;\n}\n\n/** Media item */\nexport interface MediaItem {\n\tid: string;\n\tfilename: string;\n\tkey: string;\n\tmimeType: string;\n\tsize: number;\n\twidth?: number;\n\theight?: number;\n\tfocalX?: number | null;\n\tfocalY?: number | null;\n\talt?: string;\n\tcaption?: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tfolderId?: string | null;\n\tusage?: MediaUsageSummary;\n}\n\n/** Result of assigning local media to a folder or the Main library */\nexport interface MediaFolderAssignment {\n\tid: string;\n\tfolderId: string | null;\n}\n\n/** Flat media-library folder */\nexport interface MediaFolder {\n\tid: string;\n\tname: string;\n}\n\n/** Media usage repair request */\nexport type MediaUsageRepairInput = { scope: \"collection\"; collection: string } | { scope: \"all\" };\n\n/** Media usage repair status */\nexport type MediaUsageRepairStatus = \"complete\" | \"partial\" | \"failed\" | \"stale\";\n\n/** Per-collection media usage repair summary */\nexport interface MediaUsageRepairCollectionSummary {\n\tcollection: string;\n\tstatus: MediaUsageRepairStatus;\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tlastErrorCode: string | null;\n\tstartedAt: string;\n\tcompletedAt: string | null;\n}\n\n/** Media usage repair response */\nexport interface MediaUsageRepairResponse {\n\tstatus: MediaUsageRepairStatus;\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tcollections: MediaUsageRepairCollectionSummary[];\n}\n\nexport interface MediaUsageProgress {\n\tstatus: \"indexing\" | \"ready\" | \"needs_attention\";\n\treadyCollections: number;\n\ttotalCollections: number;\n}\n\nexport interface MediaUsageProgressAdvanceResponse {\n\tactivation: MediaUsageActivationStatus;\n\tprogress: MediaUsageProgress | null;\n\tnextRequestInMs: 0 | 30_000 | null;\n}\n\n/** Durable media usage entry-work state */\nexport type MediaUsageWorkState = \"pending\" | \"retry\" | \"leased\" | \"failed\";\n\n/** Redacted operator view of one durable media usage job */\nexport interface MediaUsageWorkItem {\n\tcollectionId: string;\n\tcollectionSlug: string;\n\tcontentId: string;\n\tstate: MediaUsageWorkState;\n\tattemptCount: number;\n\tnextAttemptAt: string;\n\tleaseExpiresAt: string | null;\n\tlastAttemptedAt: string | null;\n\tlastErrorCode: string | null;\n\tupdatedAt: string;\n}\n\n/** Filters and pagination for durable media usage work */\nexport interface MediaUsageWorkListOptions {\n\tcollection: string;\n\tstate?: MediaUsageWorkState;\n\tlimit?: number;\n\tcursor?: string;\n}\n\n/** One bounded page of durable media usage work */\nexport interface MediaUsageWorkListResponse {\n\titems: MediaUsageWorkItem[];\n\tnextCursor?: string;\n}\n\n/** Identity for explicitly retrying one durable media usage job */\nexport interface MediaUsageWorkRetryInput {\n\tcollectionId: string;\n\tcontentId: string;\n}\n\n/** Result of explicitly retrying one durable media usage job */\nexport interface MediaUsageWorkRetryResponse {\n\tchanged: boolean;\n\titem: MediaUsageWorkItem;\n}\n\nexport interface MediaUsageActivationStatus {\n\tstate: \"expanded\" | \"activating\" | \"active\";\n\tcollectionCursor: string | null;\n\tattemptCount: number;\n\tdrainConfirmedAt: string | null;\n\tlastAttemptedAt: string | null;\n\tlastErrorCode: \"MEDIA_USAGE_ACTIVATION_FAILED\" | null;\n\tleaseExpiresAt: string | null;\n\tactivatedAt: string | null;\n\tupdatedAt: string;\n}\n\nexport interface MediaUsageActivationAdvanceInput {\n\twritersDrained: true;\n}\n\nexport interface MediaUsageActivationAdvanceResponse {\n\toutcome: \"activating\" | \"active\";\n\tprocessedCollections: number;\n\tactivation: MediaUsageActivationStatus;\n}\n\nexport type MediaUsageCollectionDeletionState = \"pending\" | \"retry\" | \"leased\" | \"failed\";\nexport type MediaUsageCollectionDeletionPhase =\n\t| \"fence\"\n\t| \"registry\"\n\t| \"table\"\n\t| \"work\"\n\t| \"sources\"\n\t| \"status\"\n\t| \"finalize\";\nexport interface MediaUsageCollectionDeletionItem {\n\tcollectionId: string;\n\tcollectionSlug: string;\n\tstate: MediaUsageCollectionDeletionState;\n\tphase: MediaUsageCollectionDeletionPhase;\n\tattemptCount: number;\n\tnextAttemptAt: string;\n\tleaseExpiresAt: string | null;\n\tlastErrorCode: string | null;\n\tupdatedAt: string;\n}\nexport interface MediaUsageCollectionDeletionListResponse {\n\titems: MediaUsageCollectionDeletionItem[];\n\tnextCursor?: string;\n}\n\n/** Search result */\nexport interface SearchResult {\n\tid: string;\n\tcollection: string;\n\ttitle: string;\n\texcerpt?: string;\n\tscore: number;\n}\n\n/** Taxonomy */\nexport interface Taxonomy {\n\tname: string;\n\tlabel: string;\n\thierarchical: boolean;\n}\n\n/** Taxonomy term */\nexport interface Term {\n\tid: string;\n\tslug: string;\n\tlabel: string;\n\tparentId?: string | null;\n\tdescription?: string;\n\tcount?: number;\n}\n\n/** Menu */\nexport interface Menu {\n\tname: string;\n\tlabel: string;\n}\n\n/** Menu with items */\nexport interface MenuWithItems extends Menu {\n\titems: MenuItem[];\n}\n\n/** Menu item */\nexport interface MenuItem {\n\tid: string;\n\ttype: string;\n\tlabel: string;\n\tcustomUrl?: string;\n\treferenceCollection?: string;\n\treferenceId?: string;\n\ttarget?: string;\n\tparentId?: string | null;\n\tsortOrder: number;\n}\n\n/** Full schema export (returned by /api/schema) */\nexport interface SchemaExport {\n\tcollections: Array<{\n\t\tslug: string;\n\t\tlabel: string;\n\t\tlabelSingular: string;\n\t\tdescription?: string;\n\t\ticon?: string;\n\t\tsupports: string[];\n\t\tfields: Array<{\n\t\t\tslug: string;\n\t\t\tlabel: string;\n\t\t\ttype: string;\n\t\t\trequired: boolean;\n\t\t\tunique: boolean;\n\t\t\tdefaultValue?: unknown;\n\t\t\tvalidation?: unknown;\n\t\t\twidget?: string;\n\t\t\toptions?: unknown;\n\t\t}>;\n\t}>;\n\tversion: string;\n}\n\n/** Manifest — full schema + field descriptors */\nexport interface Manifest {\n\tversion: string;\n\thash: string;\n\tcollections: Record<\n\t\tstring,\n\t\t{\n\t\t\tlabel: string;\n\t\t\tlabelSingular: string;\n\t\t\tsupports: string[];\n\t\t\tfields: Record<string, { kind: string; label?: string; required?: boolean }>;\n\t\t}\n\t>;\n}\n\n/** User as listed by the admin users API */\nexport interface UserSummary {\n\tid: string;\n\temail: string;\n\tname: string | null;\n\trole: number;\n\tdisabled: boolean;\n}\n\n/** A site transfer operation (export or import) */\nexport type TransferOperation = PublicTransferOperation;\n\n/** Site transfer capabilities of an instance */\nexport interface TransferCapabilities {\n\tformatVersions: string[];\n\tfeatures: string[];\n\toptionalFeatures: string[];\n\tlimits: {\n\t\tmanifestBytes: number;\n\t\trecordLineBytes: number;\n\t\tchunkBytes: number;\n\t\tchunkRecords: number;\n\t\ttotalRecords: number;\n\t\ttotalFiles: number;\n\t\tindexChunks: number;\n\t\tjsonDepth: number;\n\t\tmaxBlobBytes: number;\n\t};\n\tportableDomain: {\n\t\tempty: boolean;\n\t\tblockers: Array<Record<string, string>>;\n\t\tseededScaffold: Array<Record<string, string>>;\n\t};\n}\n\n/** Result of one bounded `advance` step */\nexport interface TransferAdvanceResult {\n\toperation: TransferOperation;\n\t/** Milliseconds until the next step should be requested, or null once the operation has ended. */\n\tnextRequestInMs: number | null;\n}\n\n/** A package file the import has declared but not yet received */\nexport interface TransferPackageFile {\n\tpath: string;\n\tbytes: number;\n\tsha256: string;\n}\n\nexport interface TransferImportCreateResult {\n\toperation: TransferOperation;\n\tcreated: boolean;\n\tmissing: ListResult<TransferPackageFile>;\n}\n\nexport interface TransferFileUploadResult {\n\tpath: string;\n\tbytes: number;\n\t/** True when the file was already stored and the uploaded bytes matched it. */\n\talreadyVerified: boolean;\n\t/** Declared files still to upload. */\n\tremaining: number;\n}\n\nexport interface TransferImportAnalyzeResult {\n\toperation: TransferOperation;\n\tplan?: SiteImportPlan;\n\tplanDigest?: Sha256Digest;\n\t/** Milliseconds until the next step should be requested, or null once analysis has ended. */\n\tnextRequestInMs: number | null;\n}\n\nexport interface TransferImportStatus {\n\toperation: TransferOperation;\n\tfiles: { declared: number; verified: number };\n}\n\n/** A downloaded export file, streamed */\nexport interface TransferFileDownload {\n\tbody: ReadableStream<Uint8Array>;\n\t/** Size from `Content-Length`, when sent */\n\tbytes: number | null;\n\t/** Hex SHA-256 from the `ETag`, when sent */\n\tsha256: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Client errors\n// ---------------------------------------------------------------------------\n\nexport class EmDashApiError extends Error {\n\tconstructor(\n\t\tpublic readonly status: number,\n\t\tpublic readonly code: string,\n\t\tmessage: string,\n\t\tpublic readonly details?: Record<string, unknown>,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"EmDashApiError\";\n\t}\n}\n\nexport class EmDashClientError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"EmDashClientError\";\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\nexport class EmDashClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly transport: { fetch: (request: Request) => Promise<Response> };\n\n\t/** Cached field schemas per collection for PT conversion */\n\tprivate fieldSchemaCache = new Map<string, FieldSchema[]>();\n\n\tconstructor(options: EmDashClientOptions) {\n\t\tthis.baseUrl = options.baseUrl.replace(TRAILING_SLASH_PATTERN, \"\");\n\n\t\t// Build interceptor chain\n\t\tconst interceptors: Interceptor[] = [csrfInterceptor()];\n\n\t\tif (options.token) {\n\t\t\tinterceptors.push(tokenInterceptor(options.token));\n\t\t} else if (options.devBypass) {\n\t\t\tinterceptors.push(devBypassInterceptor(this.baseUrl));\n\t\t}\n\n\t\t// Auto-refresh expired OAuth tokens\n\t\tif (options.refreshToken) {\n\t\t\tinterceptors.push(\n\t\t\t\trefreshInterceptor({\n\t\t\t\t\trefreshToken: options.refreshToken,\n\t\t\t\t\ttokenEndpoint: `${this.baseUrl}/_emdash/api/oauth/token/refresh`,\n\t\t\t\t\tonTokenRefreshed: options.onTokenRefresh\n\t\t\t\t\t\t? (accessToken, _refreshToken, expiresAt) => {\n\t\t\t\t\t\t\t\tconst expiresIn = Math.floor((new Date(expiresAt).getTime() - Date.now()) / 1000);\n\t\t\t\t\t\t\t\toptions.onTokenRefresh!(accessToken, expiresIn);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: undefined,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tif (options.interceptors) {\n\t\t\tinterceptors.push(...options.interceptors);\n\t\t}\n\n\t\tthis.transport = createTransport({ interceptors });\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Schema\n\t// -----------------------------------------------------------------------\n\n\t/** List all collections */\n\tasync collections(): Promise<Collection[]> {\n\t\tconst data = await this.request<{ items: Collection[] }>(\"GET\", \"/schema/collections\");\n\t\treturn data.items;\n\t}\n\n\t/** Get a single collection with its fields */\n\tasync collection(slug: string): Promise<CollectionWithFields> {\n\t\tconst data = await this.request<{ item: CollectionWithFields }>(\n\t\t\t\"GET\",\n\t\t\t`/schema/collections/${encodeURIComponent(slug)}?includeFields=true`,\n\t\t);\n\t\tconst col = data.item;\n\t\t// Cache field schemas for PT conversion\n\t\tif (col.fields) {\n\t\t\tthis.fieldSchemaCache.set(\n\t\t\t\tslug,\n\t\t\t\tcol.fields.map((field) => ({\n\t\t\t\t\tslug: field.slug,\n\t\t\t\t\ttype: field.type,\n\t\t\t\t\tblockTypes: field.blockTypes,\n\t\t\t\t\tvalidation: field.validation,\n\t\t\t\t})),\n\t\t\t);\n\t\t}\n\t\treturn col;\n\t}\n\n\tasync blockTypes(): Promise<BlockType[]> {\n\t\tconst data = await this.request<{ items: BlockType[] }>(\"GET\", \"/schema/block-types\");\n\t\treturn data.items;\n\t}\n\n\tasync blockType(slug: string): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\n\t\t\t\"GET\",\n\t\t\t`/schema/block-types/${encodeURIComponent(slug)}`,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\tasync createBlockType(input: CreateBlockTypeInput): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\"POST\", \"/schema/block-types\", input);\n\t\treturn data.item;\n\t}\n\n\tasync updateBlockType(slug: string, input: UpdateBlockTypeInput): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\n\t\t\t\"PUT\",\n\t\t\t`/schema/block-types/${encodeURIComponent(slug)}`,\n\t\t\tinput,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\tasync activateBlockTypeVersion(\n\t\tslug: string,\n\t\tversion: number,\n\t\texpectedFingerprint: string,\n\t): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\n\t\t\t\"POST\",\n\t\t\t`/schema/block-types/${encodeURIComponent(slug)}/versions/${version}/activate`,\n\t\t\t{ expectedFingerprint },\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** Create a collection */\n\tasync createCollection(input: {\n\t\tslug: string;\n\t\tlabel: string;\n\t\tlabelSingular?: string;\n\t\tdescription?: string;\n\t\ticon?: string;\n\t\tsupports?: string[];\n\t}): Promise<Collection> {\n\t\tconst data = await this.request<{ item: Collection }>(\"POST\", \"/schema/collections\", input);\n\t\treturn data.item;\n\t}\n\n\t/** Delete a collection */\n\tasync deleteCollection(slug: string): Promise<void> {\n\t\tawait this.request<unknown>(\"DELETE\", `/schema/collections/${encodeURIComponent(slug)}`);\n\t}\n\n\t/** Create a field on a collection */\n\tasync createField(\n\t\tcollection: string,\n\t\tinput: {\n\t\t\tslug: string;\n\t\t\ttype: string;\n\t\t\tlabel: string;\n\t\t\trequired?: boolean;\n\t\t\tunique?: boolean;\n\t\t\tdefaultValue?: unknown;\n\t\t\tvalidation?: unknown;\n\t\t\twidget?: string;\n\t\t\toptions?: unknown;\n\t\t\tsortOrder?: number;\n\t\t},\n\t): Promise<Field> {\n\t\tconst data = await this.request<{ item: Field }>(\n\t\t\t\"POST\",\n\t\t\t`/schema/collections/${encodeURIComponent(collection)}/fields`,\n\t\t\tinput,\n\t\t);\n\t\t// Invalidate field cache\n\t\tthis.fieldSchemaCache.delete(collection);\n\t\treturn data.item;\n\t}\n\n\t/** Delete a field from a collection */\n\tasync deleteField(collection: string, fieldSlug: string): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"DELETE\",\n\t\t\t`/schema/collections/${encodeURIComponent(collection)}/fields/${encodeURIComponent(fieldSlug)}`,\n\t\t);\n\t\tthis.fieldSchemaCache.delete(collection);\n\t}\n\n\t/** Get full manifest (schema + field descriptors + features) */\n\tasync manifest(): Promise<Manifest> {\n\t\treturn this.request<Manifest>(\"GET\", \"/manifest\");\n\t}\n\n\t/** Export full schema as JSON (used by `emdash types`) */\n\tasync schemaExport(): Promise<SchemaExport> {\n\t\treturn this.request<SchemaExport>(\"GET\", \"/schema\");\n\t}\n\n\t/** Export schema as TypeScript type definitions (used by `emdash types`) */\n\tasync schemaTypes(): Promise<string> {\n\t\tconst response = await this.requestRaw(\"GET\", \"/schema?format=typescript\");\n\t\tawait this.assertOk(response);\n\t\treturn response.text();\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Content\n\t// -----------------------------------------------------------------------\n\n\t/** List content in a collection */\n\tasync list(\n\t\tcollection: string,\n\t\toptions?: {\n\t\t\tstatus?: string;\n\t\t\tlimit?: number;\n\t\t\tcursor?: string;\n\t\t\torderBy?: string;\n\t\t\torder?: \"asc\" | \"desc\";\n\t\t\tlocale?: string;\n\t\t\t/** AND-combined filters over custom fields explicitly marked as indexed. */\n\t\t\tfieldFilters?: ContentFieldFilters;\n\t\t},\n\t): Promise<ListResult<ContentItem>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.status) params.set(\"status\", options.status);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tif (options?.orderBy) params.set(\"orderBy\", options.orderBy);\n\t\tif (options?.order) params.set(\"order\", options.order);\n\t\tif (options?.locale) params.set(\"locale\", options.locale);\n\t\tif (options?.fieldFilters && Object.keys(options.fieldFilters).length > 0) {\n\t\t\tparams.set(\"fieldFilters\", JSON.stringify(options.fieldFilters));\n\t\t}\n\n\t\tconst qs = params.toString();\n\t\tconst path = `/content/${encodeURIComponent(collection)}${qs ? `?${qs}` : \"\"}`;\n\t\treturn this.request<ListResult<ContentItem>>(\"GET\", path);\n\t}\n\n\t/** Async iterator that auto-follows cursors */\n\tasync *listAll(\n\t\tcollection: string,\n\t\toptions?: {\n\t\t\tstatus?: string;\n\t\t\tlimit?: number;\n\t\t\torderBy?: string;\n\t\t\torder?: \"asc\" | \"desc\";\n\t\t\tlocale?: string;\n\t\t\t/** AND-combined filters over custom fields explicitly marked as indexed. */\n\t\t\tfieldFilters?: ContentFieldFilters;\n\t\t},\n\t): AsyncGenerator<ContentItem> {\n\t\tlet cursor: string | undefined;\n\t\tdo {\n\t\t\tconst result = await this.list(collection, { ...options, cursor });\n\t\t\tfor (const item of result.items) {\n\t\t\t\tyield item;\n\t\t\t}\n\t\t\tcursor = result.nextCursor;\n\t\t} while (cursor);\n\t}\n\n\t/**\n\t * Get a single content item. Returns the item with a `_rev` token\n\t * that can be passed to update() for optimistic concurrency.\n\t */\n\tasync get(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions?: { raw?: boolean; locale?: string },\n\t): Promise<ContentItem> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.locale) params.set(\"locale\", options.locale);\n\t\tconst qs = params.size > 0 ? `?${params}` : \"\";\n\t\tconst result = await this.requestRaw(\n\t\t\t\"GET\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}${qs}`,\n\t\t);\n\t\tif (!result.ok) {\n\t\t\tawait this.assertOk(result);\n\t\t}\n\n\t\tconst raw = (await result.json()) as { data: { item: ContentItem; _rev?: string } };\n\t\tconst json = raw.data;\n\t\tconst item = json.item;\n\n\t\t// Attach _rev to the item so callers can pass it back on update\n\t\tif (json._rev) {\n\t\t\titem._rev = json._rev;\n\t\t}\n\n\t\t// Convert PT fields to markdown unless raw is requested\n\t\tif (!options?.raw && item.data) {\n\t\t\tconst fields = await this.getFieldSchemas(collection);\n\t\t\titem.data = convertDataForRead(item.data, fields, false);\n\t\t}\n\n\t\treturn item;\n\t}\n\n\t/** Create a new content item */\n\tasync create(\n\t\tcollection: string,\n\t\tinput: {\n\t\t\tdata: Record<string, unknown>;\n\t\t\tslug?: string;\n\t\t\tstatus?: string;\n\t\t\tlocale?: string;\n\t\t\ttranslationOf?: string;\n\t\t\tmigrateBlocks?: boolean;\n\t\t\treplaceBlocks?: boolean;\n\t\t},\n\t): Promise<ContentItem> {\n\t\t// Convert markdown strings to PT for portableText fields\n\t\tconst fields = await this.getFieldSchemas(collection);\n\t\tconst data = convertDataForWrite(input.data, fields);\n\n\t\tconst result = await this.request<{ item: ContentItem }>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}`,\n\t\t\t{ ...input, data },\n\t\t);\n\t\treturn result.item;\n\t}\n\n\t/**\n\t * Update a content item. Pass `_rev` from a prior get() for optimistic\n\t * concurrency — the server returns 409 if the item has changed.\n\t * Omit `_rev` for a blind write (no conflict detection).\n\t */\n\tasync update(\n\t\tcollection: string,\n\t\tid: string,\n\t\tinput: {\n\t\t\tdata?: Record<string, unknown>;\n\t\t\tslug?: string;\n\t\t\tstatus?: string;\n\t\t\t_rev?: string;\n\t\t\tlocale?: string;\n\t\t\tmigrateBlocks?: boolean;\n\t\t\treplaceBlocks?: boolean;\n\t\t\t/** Write even though another editor holds this entry's edit lock. */\n\t\t\toverrideLock?: boolean;\n\t\t},\n\t): Promise<ContentItem> {\n\t\t// Convert markdown strings to PT\n\t\tlet data = input.data;\n\t\tif (data) {\n\t\t\tconst fields = await this.getFieldSchemas(collection);\n\t\t\tdata = convertDataForWrite(data, fields);\n\t\t}\n\n\t\tconst body = {\n\t\t\tdata,\n\t\t\tslug: input.slug,\n\t\t\tstatus: input.status,\n\t\t\tmigrateBlocks: input.migrateBlocks,\n\t\t\treplaceBlocks: input.replaceBlocks,\n\t\t\t...(input._rev ? { _rev: input._rev } : {}),\n\t\t\t...(input.overrideLock ? { overrideLock: true } : {}),\n\t\t};\n\t\tconst params = new URLSearchParams();\n\t\tif (input.locale) params.set(\"locale\", input.locale);\n\t\tconst result = await this.request<{ item: ContentItem; _rev?: string }>(\n\t\t\t\"PUT\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}${params.toString() ? `?${params}` : \"\"}`,\n\t\t\tbody,\n\t\t);\n\n\t\tconst item = result.item;\n\t\tif (result._rev) {\n\t\t\titem._rev = result._rev;\n\t\t}\n\t\treturn item;\n\t}\n\n\t/** Delete (soft) a content item */\n\tasync delete(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tconst query = options.overrideLock ? \"?overrideLock=true\" : \"\";\n\t\tawait this.request<unknown>(\n\t\t\t\"DELETE\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}${query}`,\n\t\t);\n\t}\n\n\t/** Publish a content item */\n\tasync publish(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/publish`,\n\t\t\toptions.overrideLock ? { overrideLock: true } : undefined,\n\t\t);\n\t}\n\n\t/** Unpublish a content item */\n\tasync unpublish(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/unpublish`,\n\t\t\toptions.overrideLock ? { overrideLock: true } : undefined,\n\t\t);\n\t}\n\n\t/** Schedule publishing */\n\tasync schedule(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { at: string; overrideLock?: boolean },\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/schedule`,\n\t\t\t{ scheduledAt: options.at, ...(options.overrideLock ? { overrideLock: true } : {}) },\n\t\t);\n\t}\n\n\t/** Restore a trashed content item */\n\tasync restore(collection: string, id: string): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/restore`,\n\t\t);\n\t}\n\n\t/** Compare live and draft revisions */\n\tasync compare(\n\t\tcollection: string,\n\t\tid: string,\n\t): Promise<{\n\t\thasChanges: boolean;\n\t\tlive: Record<string, unknown> | null;\n\t\tdraft: Record<string, unknown> | null;\n\t}> {\n\t\treturn this.request<{\n\t\t\thasChanges: boolean;\n\t\t\tlive: Record<string, unknown> | null;\n\t\t\tdraft: Record<string, unknown> | null;\n\t\t}>(\"GET\", `/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/compare`);\n\t}\n\n\t/** Discard draft revision, reverting to the published version */\n\tasync discardDraft(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/discard-draft`,\n\t\t\toptions.overrideLock ? { overrideLock: true } : undefined,\n\t\t);\n\t}\n\n\t/**\n\t * Get all translations of a content item.\n\t * Returns the translation group ID and a summary of each locale version.\n\t */\n\tasync translations(\n\t\tcollection: string,\n\t\tid: string,\n\t): Promise<{\n\t\ttranslationGroup: string;\n\t\ttranslations: Array<{\n\t\t\tid: string;\n\t\t\tlocale: string | null;\n\t\t\tslug: string | null;\n\t\t\tstatus: string;\n\t\t\tupdatedAt: string;\n\t\t}>;\n\t}> {\n\t\treturn this.request(\n\t\t\t\"GET\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/translations`,\n\t\t);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Media\n\t// -----------------------------------------------------------------------\n\n\t/** List media items */\n\tasync mediaList(options?: {\n\t\tmimeType?: string;\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t\tpage?: number;\n\t\tincludeUsage?: boolean;\n\t\tfolderId?: string | null;\n\t}): Promise<ListResult<MediaItem> & { totalCount?: number }> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.mimeType) params.set(\"mimeType\", options.mimeType);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tif (options?.page !== undefined) params.set(\"page\", String(options.page));\n\t\tif (options?.includeUsage === true) params.set(\"includeUsage\", \"1\");\n\t\tif (options?.folderId === null) {\n\t\t\tparams.set(\"folderId\", \"unfiled\");\n\t\t} else if (options?.folderId !== undefined) {\n\t\t\tparams.set(\"folderId\", options.folderId);\n\t\t}\n\n\t\tconst qs = params.toString();\n\t\treturn this.request<ListResult<MediaItem> & { totalCount?: number }>(\n\t\t\t\"GET\",\n\t\t\t`/media${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t}\n\n\t/** Get a single media item */\n\tasync mediaGet(id: string, options?: { includeUsage?: boolean }): Promise<MediaItem> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.includeUsage === true) params.set(\"includeUsage\", \"1\");\n\n\t\tconst qs = params.toString();\n\t\tconst data = await this.request<{ item: MediaItem }>(\n\t\t\t\"GET\",\n\t\t\t`/media/${encodeURIComponent(id)}${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** List media folders */\n\tasync mediaFolderList(\n\t\toptions: { limit?: number; cursor?: string; q?: string } = {},\n\t): Promise<ListResult<MediaFolder>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options.cursor !== undefined) params.set(\"cursor\", options.cursor);\n\t\tif (options.q !== undefined) params.set(\"q\", options.q);\n\t\tconst qs = params.toString();\n\t\treturn this.request<ListResult<MediaFolder>>(\"GET\", `/media/folders${qs ? `?${qs}` : \"\"}`);\n\t}\n\n\t/** Get one media folder */\n\tasync mediaFolderGet(id: string): Promise<MediaFolder> {\n\t\tconst data = await this.request<{ item: MediaFolder }>(\n\t\t\t\"GET\",\n\t\t\t`/media/folders/${encodeURIComponent(id)}`,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** Create a media folder */\n\tasync mediaFolderCreate(name: string): Promise<MediaFolder> {\n\t\tconst data = await this.request<{ item: MediaFolder }>(\"POST\", \"/media/folders\", { name });\n\t\treturn data.item;\n\t}\n\n\t/** Rename a media folder */\n\tasync mediaFolderUpdate(id: string, name: string): Promise<MediaFolder> {\n\t\tconst data = await this.request<{ item: MediaFolder }>(\n\t\t\t\"PUT\",\n\t\t\t`/media/folders/${encodeURIComponent(id)}`,\n\t\t\t{ name },\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** Delete a media folder */\n\tasync mediaFolderDelete(id: string): Promise<void> {\n\t\tawait this.request<unknown>(\"DELETE\", `/media/folders/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Assign media to a folder, or return it to the Main library */\n\tasync mediaSetFolder(id: string, folderId: string | null): Promise<MediaFolderAssignment> {\n\t\tconst data = await this.request<{ item: MediaFolderAssignment }>(\n\t\t\t\"PUT\",\n\t\t\t`/media/${encodeURIComponent(id)}`,\n\t\t\t{ folderId },\n\t\t);\n\t\treturn { id: data.item.id, folderId: data.item.folderId };\n\t}\n\n\t/** Get entry-grouped usage details for a media item */\n\tasync mediaGetUsage(\n\t\tid: string,\n\t\toptions?: { limit?: number; cursor?: string },\n\t): Promise<MediaUsageDetailsResponse> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor !== undefined) params.set(\"cursor\", options.cursor);\n\n\t\tconst qs = params.toString();\n\t\treturn this.request<MediaUsageDetailsResponse>(\n\t\t\t\"GET\",\n\t\t\t`/media/${encodeURIComponent(id)}/usage${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t}\n\n\t/** Upload a media file */\n\tasync mediaUpload(\n\t\tfile: Uint8Array | Blob,\n\t\tfilename: string,\n\t\toptions?: { alt?: string; caption?: string; contentType?: string },\n\t): Promise<MediaItem> {\n\t\tconst formData = new FormData();\n\n\t\t// Handle different file types\n\t\tif (file instanceof Blob) {\n\t\t\tformData.append(\"file\", file, filename);\n\t\t} else {\n\t\t\tconst mimeType = options?.contentType ?? mimeFromFilename(filename);\n\t\t\tformData.append(\"file\", new Blob([file as BlobPart], { type: mimeType }), filename);\n\t\t}\n\n\t\tif (options?.alt) formData.append(\"alt\", options.alt);\n\t\tif (options?.caption) formData.append(\"caption\", options.caption);\n\n\t\tconst url = `${this.baseUrl}/_emdash/api/media`;\n\t\tconst request = new Request(url, {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: formData,\n\t\t});\n\n\t\tconst response = await this.transport.fetch(request);\n\t\tawait this.assertOk(response);\n\n\t\tconst raw = (await response.json()) as { data: { item: MediaItem } };\n\t\treturn raw.data.item;\n\t}\n\n\t/** Delete a media item */\n\tasync mediaDelete(id: string): Promise<void> {\n\t\tawait this.request<unknown>(\"DELETE\", `/media/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Repair content media usage indexes for one collection or all collections */\n\tasync mediaRepairUsage(input: MediaUsageRepairInput): Promise<MediaUsageRepairResponse> {\n\t\treturn this.request<MediaUsageRepairResponse>(\"POST\", \"/admin/media-usage/repair\", input);\n\t}\n\n\t/** Read aggregate Media Usage indexing progress */\n\tasync mediaGetUsageProgress(): Promise<MediaUsageProgress> {\n\t\treturn this.request<MediaUsageProgress>(\"GET\", \"/admin/media-usage/progress\");\n\t}\n\n\t/** Advance exactly one Media Usage maintenance step */\n\tasync mediaAdvanceUsageProgress(): Promise<MediaUsageProgressAdvanceResponse> {\n\t\treturn this.request<MediaUsageProgressAdvanceResponse>(\"POST\", \"/admin/media-usage/progress\");\n\t}\n\n\t/** Read the redacted controlled-activation status */\n\tasync mediaGetUsageActivation(): Promise<MediaUsageActivationStatus> {\n\t\treturn this.request<MediaUsageActivationStatus>(\"GET\", \"/admin/media-usage/activation\");\n\t}\n\n\t/** Advance exactly one controlled-activation batch */\n\tasync mediaAdvanceUsageActivation(\n\t\tinput: MediaUsageActivationAdvanceInput,\n\t): Promise<MediaUsageActivationAdvanceResponse> {\n\t\treturn this.request<MediaUsageActivationAdvanceResponse>(\n\t\t\t\"POST\",\n\t\t\t\"/admin/media-usage/activation\",\n\t\t\tinput,\n\t\t);\n\t}\n\n\t/** List a bounded page of durable media usage entry work */\n\tasync mediaListUsageWork(\n\t\toptions: MediaUsageWorkListOptions,\n\t): Promise<MediaUsageWorkListResponse> {\n\t\tconst params = new URLSearchParams({ collection: options.collection });\n\t\tif (options.state) params.set(\"state\", options.state);\n\t\tif (options.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options.cursor) params.set(\"cursor\", options.cursor);\n\t\treturn this.request<MediaUsageWorkListResponse>(\"GET\", `/admin/media-usage/work?${params}`);\n\t}\n\n\t/** Explicitly retry one durable media usage entry job */\n\tasync mediaRetryUsageWork(input: MediaUsageWorkRetryInput): Promise<MediaUsageWorkRetryResponse> {\n\t\treturn this.request<MediaUsageWorkRetryResponse>(\n\t\t\t\"POST\",\n\t\t\t\"/admin/media-usage/work/retry\",\n\t\t\tinput,\n\t\t);\n\t}\n\n\tasync mediaListCollectionDeletions(\n\t\toptions: {\n\t\t\tstate?: MediaUsageCollectionDeletionState;\n\t\t\tlimit?: number;\n\t\t\tcursor?: string;\n\t\t} = {},\n\t): Promise<MediaUsageCollectionDeletionListResponse> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options.state) params.set(\"state\", options.state);\n\t\tif (options.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options.cursor) params.set(\"cursor\", options.cursor);\n\t\treturn this.request(\"GET\", `/admin/media-usage/collection-deletions?${params}`);\n\t}\n\n\tasync mediaRetryCollectionDeletion(collectionId: string): Promise<{\n\t\tchanged: boolean;\n\t\titem: MediaUsageCollectionDeletionItem;\n\t}> {\n\t\treturn this.request(\"POST\", \"/admin/media-usage/collection-deletions/retry\", {\n\t\t\tcollectionId,\n\t\t});\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Search\n\t// -----------------------------------------------------------------------\n\n\t/** Full-text search */\n\tasync search(\n\t\tquery: string,\n\t\toptions?: { collection?: string; locale?: string; limit?: number },\n\t): Promise<SearchResult[]> {\n\t\tconst params = new URLSearchParams({ q: query });\n\t\tif (options?.collection) params.set(\"collections\", options.collection);\n\t\tif (options?.locale) params.set(\"locale\", options.locale);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\n\t\tconst data = await this.request<{ items: SearchResult[] }>(\"GET\", `/search?${params}`);\n\t\treturn data.items;\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Taxonomies\n\t// -----------------------------------------------------------------------\n\n\t/** List taxonomies */\n\tasync taxonomies(): Promise<Taxonomy[]> {\n\t\tconst data = await this.request<{ taxonomies: Taxonomy[] }>(\"GET\", \"/taxonomies\");\n\t\treturn data.taxonomies;\n\t}\n\n\t/**\n\t * List terms in a taxonomy. Visible-usage counts are included by default.\n\t * Pass `includeCounts: false` to skip the aggregate; `count` is then omitted\n\t * from each term.\n\t */\n\tasync terms(\n\t\ttaxonomy: string,\n\t\toptions?: { limit?: number; cursor?: string; includeCounts?: boolean },\n\t): Promise<ListResult<Term>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tif (options?.includeCounts !== undefined)\n\t\t\tparams.set(\"includeCounts\", String(options.includeCounts));\n\n\t\tconst qs = params.toString();\n\t\tconst data = await this.request<{ terms: Term[] }>(\n\t\t\t\"GET\",\n\t\t\t`/taxonomies/${encodeURIComponent(taxonomy)}/terms${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t\treturn { items: data.terms };\n\t}\n\n\t/** Create a taxonomy term */\n\tasync createTerm(\n\t\ttaxonomy: string,\n\t\tinput: { slug: string; label: string; parentId?: string; description?: string },\n\t): Promise<Term> {\n\t\treturn this.request<Term>(\"POST\", `/taxonomies/${encodeURIComponent(taxonomy)}/terms`, input);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Menus\n\t// -----------------------------------------------------------------------\n\n\t/** List menus */\n\tasync menus(): Promise<Menu[]> {\n\t\t// Handler returns a bare array, not { items: [...] }\n\t\treturn this.request<Menu[]>(\"GET\", \"/menus\");\n\t}\n\n\t/** Get a menu with its items */\n\tasync menu(name: string): Promise<MenuWithItems> {\n\t\treturn this.request<MenuWithItems>(\"GET\", `/menus/${encodeURIComponent(name)}`);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Users\n\t// -----------------------------------------------------------------------\n\n\t/** List users (admin only) */\n\tasync users(options?: {\n\t\tsearch?: string;\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t}): Promise<ListResult<UserSummary>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.search) params.set(\"search\", options.search);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tconst qs = params.toString();\n\t\treturn this.request<ListResult<UserSummary>>(\"GET\", `/admin/users${qs ? `?${qs}` : \"\"}`);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Site transfer\n\t// -----------------------------------------------------------------------\n\n\t/** Formats, features, limits, and whether this site can receive an import */\n\tasync transferCapabilities(): Promise<TransferCapabilities> {\n\t\treturn this.request<TransferCapabilities>(\"GET\", \"/admin/transfer/capabilities\");\n\t}\n\n\t/**\n\t * Start a site export. With an idempotency key, repeating the call returns\n\t * the export first created with that key.\n\t */\n\tasync transferExportCreate(\n\t\toptions: { comments?: boolean } = {},\n\t\trequest: { idempotencyKey?: string } = {},\n\t): Promise<{ operation: TransferOperation; created: boolean }> {\n\t\treturn this.request(\"POST\", \"/admin/transfer/exports\", options, idempotencyHeader(request));\n\t}\n\n\t/** List exports, newest first */\n\tasync transferExportList(options?: {\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t}): Promise<ListResult<TransferOperation>> {\n\t\treturn this.request(\"GET\", `/admin/transfer/exports${pageQuery(options)}`);\n\t}\n\n\tasync transferExportGet(id: string): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"GET\", `/admin/transfer/exports/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Run one bounded export step */\n\tasync transferExportAdvance(id: string): Promise<TransferAdvanceResult> {\n\t\treturn this.request(\"POST\", `/admin/transfer/exports/${encodeURIComponent(id)}/advance`);\n\t}\n\n\t/** The complete export's `manifest.json`, byte for byte */\n\tasync transferExportManifest(id: string): Promise<Uint8Array> {\n\t\tconst response = await this.requestRaw(\n\t\t\t\"GET\",\n\t\t\t`/admin/transfer/exports/${encodeURIComponent(id)}/manifest`,\n\t\t);\n\t\tawait this.assertOk(response);\n\t\treturn new Uint8Array(await response.arrayBuffer());\n\t}\n\n\t/**\n\t * Stream one file of a complete export. The server ends the stream with an\n\t * error if the stored bytes no longer match the export, so callers must\n\t * still check the size and digest of what they receive.\n\t */\n\tasync transferExportFile(id: string, path: string): Promise<TransferFileDownload> {\n\t\tconst response = await this.requestRaw(\n\t\t\t\"GET\",\n\t\t\t`/admin/transfer/exports/${encodeURIComponent(id)}/files/${encodePackagePath(path)}`,\n\t\t);\n\t\tawait this.assertOk(response);\n\t\tif (!response.body) throw new EmDashClientError(`Empty response for ${path}`);\n\t\tconst length = response.headers.get(\"Content-Length\");\n\t\tconst etag = response.headers.get(\"ETag\");\n\t\treturn {\n\t\t\tbody: response.body,\n\t\t\tbytes: length !== null && DECIMAL_PATTERN.test(length) ? Number(length) : null,\n\t\t\tsha256: etag ? (SHA256_ETAG_PATTERN.exec(etag)?.[1] ?? null) : null,\n\t\t};\n\t}\n\n\t/**\n\t * Create an import from a package's `manifest.json` bytes. With an\n\t * idempotency key, repeating the call with the same manifest returns the\n\t * import first created with that key.\n\t */\n\tasync transferImportCreate(\n\t\tmanifest: Uint8Array,\n\t\trequest: { idempotencyKey?: string } = {},\n\t): Promise<TransferImportCreateResult> {\n\t\tconst response = await this.send(\"POST\", \"/admin/transfer/imports\", {\n\t\t\tbody: manifest,\n\t\t\theaders: { \"Content-Type\": \"application/json\", ...idempotencyHeader(request) },\n\t\t});\n\t\tawait this.assertOk(response);\n\t\tconst json = (await response.json()) as { data: TransferImportCreateResult };\n\t\treturn json.data;\n\t}\n\n\t/** List imports, newest first */\n\tasync transferImportList(options?: {\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t}): Promise<ListResult<TransferOperation>> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports${pageQuery(options)}`);\n\t}\n\n\tasync transferImportGet(id: string): Promise<TransferImportStatus> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Declared package files not uploaded yet, in path order */\n\tasync transferImportMissing(\n\t\tid: string,\n\t\toptions?: { limit?: number; cursor?: string },\n\t): Promise<ListResult<TransferPackageFile>> {\n\t\treturn this.request(\n\t\t\t\"GET\",\n\t\t\t`/admin/transfer/imports/${encodeURIComponent(id)}/missing${pageQuery(options)}`,\n\t\t);\n\t}\n\n\t/**\n\t * Upload one declared package file. `bytes` must be the file's exact size;\n\t * a stream body is sent with that `Content-Length`.\n\t */\n\tasync transferImportUploadFile(\n\t\tid: string,\n\t\tpath: string,\n\t\tbody: Uint8Array | ReadableStream<Uint8Array>,\n\t\tbytes: number,\n\t): Promise<TransferFileUploadResult> {\n\t\tconst response = await this.send(\n\t\t\t\"PUT\",\n\t\t\t`/admin/transfer/imports/${encodeURIComponent(id)}/files/${encodePackagePath(path)}`,\n\t\t\t{\n\t\t\t\tbody,\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/octet-stream\",\n\t\t\t\t\t\"Content-Length\": String(bytes),\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\t\tawait this.assertOk(response);\n\t\tconst json = (await response.json()) as { data: TransferFileUploadResult };\n\t\treturn json.data;\n\t}\n\n\t/**\n\t * Run one bounded analysis step. Once the import is planned the result\n\t * carries the plan; `decisions` are then applied, producing a new plan\n\t * digest.\n\t */\n\tasync transferImportAnalyze(\n\t\tid: string,\n\t\tdecisions?: SiteImportDecisionsInput,\n\t): Promise<TransferImportAnalyzeResult> {\n\t\treturn this.request(\n\t\t\t\"POST\",\n\t\t\t`/admin/transfer/imports/${encodeURIComponent(id)}/analyze`,\n\t\t\tdecisions === undefined ? undefined : { decisions },\n\t\t);\n\t}\n\n\tasync transferImportPlan(\n\t\tid: string,\n\t): Promise<{ plan: SiteImportPlan; planDigest: Sha256Digest }> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports/${encodeURIComponent(id)}/plan`);\n\t}\n\n\t/** Start a planned import. Both digests must match the reviewed package and plan. */\n\tasync transferImportExecute(\n\t\tid: string,\n\t\tinput: { packageDigest: string; planDigest: string },\n\t): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/execute`, {\n\t\t\tpackageDigest: input.packageDigest,\n\t\t\tplanDigest: input.planDigest,\n\t\t});\n\t}\n\n\t/** Run one bounded step of an executing import */\n\tasync transferImportAdvance(id: string): Promise<TransferAdvanceResult> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/advance`);\n\t}\n\n\tasync transferImportReceipt(id: string): Promise<{ receipt: SiteImportReceipt }> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports/${encodeURIComponent(id)}/receipt`);\n\t}\n\n\t/**\n\t * Cancel an import. An idle import is cancelled at once; a step in\n\t * progress stops after its current batch, so the returned operation may\n\t * still be executing with `cancelRequestedAt` set.\n\t */\n\tasync transferImportCancel(id: string): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/cancel`);\n\t}\n\n\t/**\n\t * Abandon a failed or cancelled import, lifting the site write fence it\n\t * holds. Data the import already wrote stays in place.\n\t */\n\tasync transferImportAbandon(id: string): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/abandon`);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Internal helpers\n\t// -----------------------------------------------------------------------\n\n\t/** Make a typed JSON request to the API */\n\tprivate async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody?: unknown,\n\t\textraHeaders?: Record<string, string>,\n\t): Promise<T> {\n\t\tconst response = await this.requestRaw(method, path, body, extraHeaders);\n\t\tawait this.assertOk(response);\n\t\tconst json = (await response.json()) as { data: T };\n\t\treturn json.data;\n\t}\n\n\t/** Make a raw request — caller handles response */\n\tprivate async requestRaw(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody?: unknown,\n\t\textraHeaders?: Record<string, string>,\n\t): Promise<Response> {\n\t\tconst headers: Record<string, string> = { ...extraHeaders };\n\n\t\tlet requestBody: string | undefined;\n\t\tif (body !== undefined) {\n\t\t\theaders[\"Content-Type\"] = \"application/json\";\n\t\t\trequestBody = JSON.stringify(body);\n\t\t}\n\n\t\treturn this.send(method, path, { body: requestBody, headers });\n\t}\n\n\t/** Send a request with an arbitrary body; the caller handles the response */\n\tprivate async send(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tinit: {\n\t\t\tbody?: string | Uint8Array | ReadableStream<Uint8Array>;\n\t\t\theaders?: Record<string, string>;\n\t\t},\n\t): Promise<Response> {\n\t\tconst url = `${this.baseUrl}/_emdash/api${path}`;\n\t\tconst request = new Request(url, {\n\t\t\tmethod,\n\t\t\theaders: { Accept: \"application/json\", ...init.headers },\n\t\t\tbody: init.body as BodyInit | undefined,\n\t\t\t...(init.body instanceof ReadableStream ? { duplex: \"half\" } : {}),\n\t\t});\n\n\t\treturn this.transport.fetch(request);\n\t}\n\n\t/** Assert a response is OK, throw typed error if not */\n\tprivate async assertOk(response: Response): Promise<void> {\n\t\tif (response.ok) return;\n\n\t\tlet code = \"UNKNOWN_ERROR\";\n\t\tlet message = `HTTP ${response.status}`;\n\t\tlet details: Record<string, unknown> | undefined;\n\n\t\ttry {\n\t\t\tconst json = (await response.json()) as {\n\t\t\t\terror?: { code?: string; message?: string; details?: Record<string, unknown> };\n\t\t\t};\n\t\t\tif (json.error) {\n\t\t\t\tcode = json.error.code ?? code;\n\t\t\t\tmessage = json.error.message ?? message;\n\t\t\t\tdetails = json.error.details;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Response body isn't JSON — use status text\n\t\t\tmessage = response.statusText || message;\n\t\t}\n\n\t\tthrow new EmDashApiError(response.status, code, message, details);\n\t}\n\n\t/** Get cached field schemas for a collection, fetching if needed */\n\tprivate async getFieldSchemas(collection: string): Promise<FieldSchema[]> {\n\t\tlet cached = this.fieldSchemaCache.get(collection);\n\t\tif (cached) return cached;\n\n\t\ttry {\n\t\t\tconst col = await this.collection(collection);\n\t\t\tcached = col.fields.map((field) => ({\n\t\t\t\tslug: field.slug,\n\t\t\t\ttype: field.type,\n\t\t\t\tblockTypes: field.blockTypes,\n\t\t\t\tvalidation: field.validation,\n\t\t\t}));\n\t\t\tthis.fieldSchemaCache.set(collection, cached);\n\t\t\treturn cached;\n\t\t} catch {\n\t\t\t// If we can't fetch the schema, skip conversion\n\t\t\treturn [];\n\t\t}\n\t}\n}\n\ntype _AssertTrue<T extends true> = T;\ntype _MediaRepairUsageRequiresExplicitInput = _AssertTrue<\n\tParameters<EmDashClient[\"mediaRepairUsage\"]> extends [MediaUsageRepairInput] ? true : false\n>;\n\nexport type { SiteImportDecisionsInput, SiteImportPlan, SiteImportReceipt, Sha256Digest };\n\n// Re-export transport types for interceptor authors\nexport type { Interceptor } from \"./transport.js\";\nexport {\n\tcreateTransport,\n\tcsrfInterceptor,\n\ttokenInterceptor,\n\tdevBypassInterceptor,\n} from \"./transport.js\";\nexport { portableTextToMarkdown, markdownToPortableText } from \"./portable-text.js\";\nexport type { PortableTextBlock } from \"./portable-text.js\";\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/client/index.ts"],"sourcesContent":["/**\n * EmDashClient — typed HTTP client for the EmDash REST API.\n *\n * Handles auth, CSRF, PT ↔ Markdown conversion, and optional `_rev`\n * concurrency tokens. Shared foundation for the CLI and future MCP server.\n *\n * @example\n * ```ts\n * import { EmDashClient } from \"emdash/client\";\n *\n * const client = new EmDashClient({\n *   baseUrl: \"http://localhost:4321\",\n *   devBypass: true,\n * });\n *\n * const posts = await client.list(\"posts\", { status: \"published\" });\n * ```\n */\n\nimport mime from \"mime/lite\";\n\nimport type { ContentFieldFilters } from \"../content-list-query.js\";\nimport type {\n\tBlockType,\n\tCreateBlockTypeInput,\n\tUpdateBlockTypeInput,\n} from \"../schema/block-types.js\";\nimport type { Sha256Digest } from \"../transfer/format/digest.js\";\nimport type { SiteImportDecisionsInput, SiteImportPlan } from \"../transfer/format/plan.js\";\nimport type { SiteImportReceipt } from \"../transfer/format/receipt.js\";\nimport type { PublicTransferOperation } from \"../transfer/ops/operations.js\";\nimport type { FieldSchema } from \"./portable-text.js\";\nimport { convertDataForRead, convertDataForWrite } from \"./portable-text.js\";\nimport type { Interceptor } from \"./transport.js\";\nimport {\n\tcreateTransport,\n\tcsrfInterceptor,\n\tdevBypassInterceptor,\n\trefreshInterceptor,\n\ttokenInterceptor,\n} from \"./transport.js\";\n\n// Regex patterns for client utilities\nconst TRAILING_SLASH_PATTERN = /\\/$/;\nconst DECIMAL_PATTERN = /^\\d+$/;\nconst SHA256_ETAG_PATTERN = /^\"([0-9a-f]{64})\"$/;\n\n// ---------------------------------------------------------------------------\n// Helpers\n// ---------------------------------------------------------------------------\n\nfunction mimeFromFilename(filename: string): string {\n\treturn mime.getType(filename) ?? \"application/octet-stream\";\n}\n\nfunction idempotencyHeader(request: { idempotencyKey?: string }): Record<string, string> {\n\treturn request.idempotencyKey === undefined ? {} : { \"Idempotency-Key\": request.idempotencyKey };\n}\n\nfunction pageQuery(options?: { limit?: number; cursor?: string }): string {\n\tconst params = new URLSearchParams();\n\tif (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n\tif (options?.cursor !== undefined) params.set(\"cursor\", options.cursor);\n\tconst qs = params.toString();\n\treturn qs ? `?${qs}` : \"\";\n}\n\n/** Encode a site package path (`records/post/000000.ndjson`) segment by segment */\nfunction encodePackagePath(path: string): string {\n\treturn path.split(\"/\").map(encodeURIComponent).join(\"/\");\n}\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport interface EmDashClientOptions {\n\t/** Base URL of the EmDash instance */\n\tbaseUrl: string;\n\t/** API token (ec_pat_...) or OAuth token (ec_oat_...) */\n\ttoken?: string;\n\t/** OAuth refresh token for auto-refresh on 401 */\n\trefreshToken?: string;\n\t/** Called when a token is refreshed (for persisting new access token) */\n\tonTokenRefresh?: (accessToken: string, expiresIn: number) => void;\n\t/** Use dev-bypass authentication (localhost only) */\n\tdevBypass?: boolean;\n\t/** Additional request interceptors */\n\tinterceptors?: Interceptor[];\n}\n\n/** Standard API error shape */\nexport interface ApiError {\n\tcode: string;\n\tmessage: string;\n\tdetails?: Record<string, unknown>;\n}\n\n/** Standard API response wrapper */\nexport interface ClientResponse<T> {\n\tsuccess: true;\n\tdata: T;\n}\n\n/** Paginated list response */\nexport interface ListResult<T> {\n\titems: T[];\n\tnextCursor?: string;\n}\n\n/** Content item as returned by the API */\nexport interface ContentItem {\n\tid: string;\n\ttype: string;\n\tslug: string | null;\n\tstatus: string;\n\tdata: Record<string, unknown>;\n\tauthorId: string | null;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tpublishedAt: string | null;\n\tscheduledAt: string | null;\n\tliveRevisionId: string | null;\n\tdraftRevisionId: string | null;\n\tlocale: string | null;\n\ttranslationGroup: string | null;\n\t_rev?: string;\n}\n\n/** Collection metadata */\nexport interface Collection {\n\tslug: string;\n\tlabel: string;\n\tlabelSingular: string;\n\tdescription?: string;\n\ticon?: string;\n\tsupports: string[];\n}\n\n/** Collection with fields */\nexport interface CollectionWithFields extends Collection {\n\tfields: Field[];\n}\n\n/** Field metadata */\nexport interface Field {\n\tslug: string;\n\tlabel: string;\n\ttype: string;\n\trequired: boolean;\n\tunique: boolean;\n\tdefaultValue?: unknown;\n\tvalidation?: unknown;\n\twidget?: string;\n\toptions?: unknown;\n\tsortOrder?: number;\n\tblockTypes?: BlockType[];\n\tblockTypeFingerprint?: string;\n}\n\n/** Aggregate trust state for media usage reads */\nexport type MediaUsageCoverageStatus =\n\t| \"complete\"\n\t| \"never\"\n\t| \"running\"\n\t| \"partial\"\n\t| \"failed\"\n\t| \"stale\"\n\t| \"unknown\";\n\n/** Aggregate media usage coverage across all content collections */\nexport interface MediaUsageCoverage {\n\tscope: \"all_content_collections\";\n\tstatus: MediaUsageCoverageStatus;\n}\n\n/** Coverage-aware usage count for a media item */\nexport interface MediaUsageSummary {\n\tcount: number | null;\n\tcoverage: MediaUsageCoverage;\n}\n\n/** One indexed media reference within a content source */\nexport interface MediaUsageOccurrenceDetail {\n\tfieldSlug: string;\n\tfieldPath: string;\n\toccurrenceIndex: number;\n\treferenceType:\n\t\t| \"image_field\"\n\t\t| \"file_field\"\n\t\t| \"portable_text_image\"\n\t\t| \"portable_text_video\"\n\t\t| \"unknown\";\n}\n\n/** Indexed references from one visible content source */\nexport interface MediaUsageSourceDetail {\n\tvariant: \"columns\" | \"draft_overlay\";\n\toccurrences: MediaUsageOccurrenceDetail[];\n}\n\n/** One content entry that references a media item */\nexport interface MediaUsageEntryDetail {\n\tcollection: string;\n\tcontentId: string;\n\ttitle: string | null;\n\tslug: string | null;\n\tlocale: string | null;\n\tstatus: string | null;\n\tscheduledAt: string | null;\n\tdeletedAt: string | null;\n\tsources: MediaUsageSourceDetail[];\n}\n\n/** A site setting that selects a media item */\nexport interface MediaUsageSiteSettingDetail {\n\tsetting: \"logo\" | \"favicon\" | \"seo.defaultOgImage\";\n}\n\n/** Entry-grouped media usage details */\nexport interface MediaUsageDetailsResponse {\n\titems: MediaUsageEntryDetail[];\n\tnextCursor?: string;\n\tsiteSettings: MediaUsageSiteSettingDetail[];\n\tcoverage: MediaUsageCoverage;\n}\n\n/** Media item */\nexport interface MediaItem {\n\tid: string;\n\tfilename: string;\n\tkey: string;\n\tmimeType: string;\n\tsize: number;\n\twidth?: number;\n\theight?: number;\n\tfocalX?: number | null;\n\tfocalY?: number | null;\n\talt?: string;\n\tcaption?: string;\n\tcreatedAt: string;\n\tupdatedAt: string;\n\tfolderId?: string | null;\n\tusage?: MediaUsageSummary;\n}\n\n/** Result of assigning local media to a folder or the Main library */\nexport interface MediaFolderAssignment {\n\tid: string;\n\tfolderId: string | null;\n}\n\n/** Flat media-library folder */\nexport interface MediaFolder {\n\tid: string;\n\tname: string;\n}\n\n/** Media usage repair request */\nexport type MediaUsageRepairInput = { scope: \"collection\"; collection: string } | { scope: \"all\" };\n\n/** Media usage repair status */\nexport type MediaUsageRepairStatus = \"complete\" | \"partial\" | \"failed\" | \"stale\";\n\n/** Per-collection media usage repair summary */\nexport interface MediaUsageRepairCollectionSummary {\n\tcollection: string;\n\tstatus: MediaUsageRepairStatus;\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tlastErrorCode: string | null;\n\tstartedAt: string;\n\tcompletedAt: string | null;\n}\n\n/** Media usage repair response */\nexport interface MediaUsageRepairResponse {\n\tstatus: MediaUsageRepairStatus;\n\tindexedSourceCount: number;\n\tfailedSourceCount: number;\n\tskippedSourceCount: number;\n\tdeletedSourceCount: number;\n\tcollections: MediaUsageRepairCollectionSummary[];\n}\n\nexport interface MediaUsageProgress {\n\tstatus: \"indexing\" | \"ready\" | \"needs_attention\";\n\treadyCollections: number;\n\ttotalCollections: number;\n}\n\nexport interface MediaUsageProgressAdvanceResponse {\n\tactivation: MediaUsageActivationStatus;\n\tprogress: MediaUsageProgress | null;\n\tnextRequestInMs: 0 | 30_000 | null;\n}\n\n/** Durable media usage entry-work state */\nexport type MediaUsageWorkState = \"pending\" | \"retry\" | \"leased\" | \"failed\";\n\n/** Redacted operator view of one durable media usage job */\nexport interface MediaUsageWorkItem {\n\tcollectionId: string;\n\tcollectionSlug: string;\n\tcontentId: string;\n\tstate: MediaUsageWorkState;\n\tattemptCount: number;\n\tnextAttemptAt: string;\n\tleaseExpiresAt: string | null;\n\tlastAttemptedAt: string | null;\n\tlastErrorCode: string | null;\n\tupdatedAt: string;\n}\n\n/** Filters and pagination for durable media usage work */\nexport interface MediaUsageWorkListOptions {\n\tcollection: string;\n\tstate?: MediaUsageWorkState;\n\tlimit?: number;\n\tcursor?: string;\n}\n\n/** One bounded page of durable media usage work */\nexport interface MediaUsageWorkListResponse {\n\titems: MediaUsageWorkItem[];\n\tnextCursor?: string;\n}\n\n/** Identity for explicitly retrying one durable media usage job */\nexport interface MediaUsageWorkRetryInput {\n\tcollectionId: string;\n\tcontentId: string;\n}\n\n/** Result of explicitly retrying one durable media usage job */\nexport interface MediaUsageWorkRetryResponse {\n\tchanged: boolean;\n\titem: MediaUsageWorkItem;\n}\n\nexport interface MediaUsageActivationStatus {\n\tstate: \"expanded\" | \"activating\" | \"active\";\n\tcollectionCursor: string | null;\n\tattemptCount: number;\n\tdrainConfirmedAt: string | null;\n\tlastAttemptedAt: string | null;\n\tlastErrorCode: \"MEDIA_USAGE_ACTIVATION_FAILED\" | null;\n\tleaseExpiresAt: string | null;\n\tactivatedAt: string | null;\n\tupdatedAt: string;\n}\n\nexport interface MediaUsageActivationAdvanceInput {\n\twritersDrained: true;\n}\n\nexport interface MediaUsageActivationAdvanceResponse {\n\toutcome: \"activating\" | \"active\";\n\tprocessedCollections: number;\n\tactivation: MediaUsageActivationStatus;\n}\n\nexport type MediaUsageCollectionDeletionState = \"pending\" | \"retry\" | \"leased\" | \"failed\";\nexport type MediaUsageCollectionDeletionPhase =\n\t| \"fence\"\n\t| \"registry\"\n\t| \"table\"\n\t| \"work\"\n\t| \"sources\"\n\t| \"status\"\n\t| \"finalize\";\nexport interface MediaUsageCollectionDeletionItem {\n\tcollectionId: string;\n\tcollectionSlug: string;\n\tstate: MediaUsageCollectionDeletionState;\n\tphase: MediaUsageCollectionDeletionPhase;\n\tattemptCount: number;\n\tnextAttemptAt: string;\n\tleaseExpiresAt: string | null;\n\tlastErrorCode: string | null;\n\tupdatedAt: string;\n}\nexport interface MediaUsageCollectionDeletionListResponse {\n\titems: MediaUsageCollectionDeletionItem[];\n\tnextCursor?: string;\n}\n\n/** Search result */\nexport interface SearchResult {\n\tid: string;\n\tcollection: string;\n\ttitle: string;\n\texcerpt?: string;\n\tscore: number;\n}\n\n/** Taxonomy */\nexport interface Taxonomy {\n\tname: string;\n\tlabel: string;\n\thierarchical: boolean;\n}\n\n/** Taxonomy term */\nexport interface Term {\n\tid: string;\n\tslug: string;\n\tlabel: string;\n\tparentId?: string | null;\n\tdescription?: string;\n\tcount?: number;\n}\n\n/** Menu */\nexport interface Menu {\n\tname: string;\n\tlabel: string;\n}\n\n/** Menu with items */\nexport interface MenuWithItems extends Menu {\n\titems: MenuItem[];\n}\n\n/** Menu item */\nexport interface MenuItem {\n\tid: string;\n\ttype: string;\n\tlabel: string;\n\tcustomUrl?: string;\n\treferenceCollection?: string;\n\treferenceId?: string;\n\ttarget?: string;\n\tparentId?: string | null;\n\tsortOrder: number;\n}\n\n/** Full schema export (returned by /api/schema) */\nexport interface SchemaExport {\n\tcollections: Array<{\n\t\tslug: string;\n\t\tlabel: string;\n\t\tlabelSingular: string;\n\t\tdescription?: string;\n\t\ticon?: string;\n\t\tsupports: string[];\n\t\tfields: Array<{\n\t\t\tslug: string;\n\t\t\tlabel: string;\n\t\t\ttype: string;\n\t\t\trequired: boolean;\n\t\t\tunique: boolean;\n\t\t\tdefaultValue?: unknown;\n\t\t\tvalidation?: unknown;\n\t\t\twidget?: string;\n\t\t\toptions?: unknown;\n\t\t}>;\n\t}>;\n\tversion: string;\n}\n\n/** Manifest — full schema + field descriptors */\nexport interface Manifest {\n\tversion: string;\n\thash: string;\n\tcollections: Record<\n\t\tstring,\n\t\t{\n\t\t\tlabel: string;\n\t\t\tlabelSingular: string;\n\t\t\tsupports: string[];\n\t\t\tfields: Record<string, { kind: string; label?: string; required?: boolean }>;\n\t\t}\n\t>;\n}\n\n/** User as listed by the admin users API */\nexport interface UserSummary {\n\tid: string;\n\temail: string;\n\tname: string | null;\n\trole: number;\n\tdisabled: boolean;\n}\n\n/** A site transfer operation (export or import) */\nexport type TransferOperation = PublicTransferOperation;\n\n/** Site transfer capabilities of an instance */\nexport interface TransferCapabilities {\n\tformatVersions: string[];\n\tfeatures: string[];\n\toptionalFeatures: string[];\n\tlimits: {\n\t\tmanifestBytes: number;\n\t\trecordLineBytes: number;\n\t\tchunkBytes: number;\n\t\tchunkRecords: number;\n\t\ttotalRecords: number;\n\t\ttotalFiles: number;\n\t\tindexChunks: number;\n\t\tjsonDepth: number;\n\t\tmaxBlobBytes: number;\n\t};\n\tportableDomain: {\n\t\tempty: boolean;\n\t\tblockers: Array<Record<string, string>>;\n\t\tseededScaffold: Array<Record<string, string>>;\n\t};\n}\n\n/** Result of one bounded `advance` step */\nexport interface TransferAdvanceResult {\n\toperation: TransferOperation;\n\t/** Milliseconds until the next step should be requested, or null once the operation has ended. */\n\tnextRequestInMs: number | null;\n}\n\n/** A package file the import has declared but not yet received */\nexport interface TransferPackageFile {\n\tpath: string;\n\tbytes: number;\n\tsha256: string;\n}\n\nexport interface TransferImportCreateResult {\n\toperation: TransferOperation;\n\tcreated: boolean;\n\tmissing: ListResult<TransferPackageFile>;\n}\n\nexport interface TransferFileUploadResult {\n\tpath: string;\n\tbytes: number;\n\t/** True when the file was already stored and the uploaded bytes matched it. */\n\talreadyVerified: boolean;\n\t/** Declared files still to upload. */\n\tremaining: number;\n}\n\nexport interface TransferImportAnalyzeResult {\n\toperation: TransferOperation;\n\tplan?: SiteImportPlan;\n\tplanDigest?: Sha256Digest;\n\t/** Milliseconds until the next step should be requested, or null once analysis has ended. */\n\tnextRequestInMs: number | null;\n}\n\nexport interface TransferImportStatus {\n\toperation: TransferOperation;\n\tfiles: { declared: number; verified: number };\n}\n\n/** A downloaded export file, streamed */\nexport interface TransferFileDownload {\n\tbody: ReadableStream<Uint8Array>;\n\t/** Size from `Content-Length`, when sent */\n\tbytes: number | null;\n\t/** Hex SHA-256 from the `ETag`, when sent */\n\tsha256: string | null;\n}\n\n// ---------------------------------------------------------------------------\n// Client errors\n// ---------------------------------------------------------------------------\n\nexport class EmDashApiError extends Error {\n\tconstructor(\n\t\tpublic readonly status: number,\n\t\tpublic readonly code: string,\n\t\tmessage: string,\n\t\tpublic readonly details?: Record<string, unknown>,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"EmDashApiError\";\n\t}\n}\n\nexport class EmDashClientError extends Error {\n\tconstructor(message: string) {\n\t\tsuper(message);\n\t\tthis.name = \"EmDashClientError\";\n\t}\n}\n\n// ---------------------------------------------------------------------------\n// Client\n// ---------------------------------------------------------------------------\n\nexport class EmDashClient {\n\tprivate readonly baseUrl: string;\n\tprivate readonly transport: { fetch: (request: Request) => Promise<Response> };\n\n\t/** Cached field schemas per collection for PT conversion */\n\tprivate fieldSchemaCache = new Map<string, FieldSchema[]>();\n\n\tconstructor(options: EmDashClientOptions) {\n\t\tthis.baseUrl = options.baseUrl.replace(TRAILING_SLASH_PATTERN, \"\");\n\n\t\t// Build interceptor chain\n\t\tconst interceptors: Interceptor[] = [csrfInterceptor()];\n\n\t\tif (options.token) {\n\t\t\tinterceptors.push(tokenInterceptor(options.token));\n\t\t} else if (options.devBypass) {\n\t\t\tinterceptors.push(devBypassInterceptor(this.baseUrl));\n\t\t}\n\n\t\t// Auto-refresh expired OAuth tokens\n\t\tif (options.refreshToken) {\n\t\t\tinterceptors.push(\n\t\t\t\trefreshInterceptor({\n\t\t\t\t\trefreshToken: options.refreshToken,\n\t\t\t\t\ttokenEndpoint: `${this.baseUrl}/_emdash/api/oauth/token/refresh`,\n\t\t\t\t\tonTokenRefreshed: options.onTokenRefresh\n\t\t\t\t\t\t? (accessToken, _refreshToken, expiresAt) => {\n\t\t\t\t\t\t\t\tconst expiresIn = Math.floor((new Date(expiresAt).getTime() - Date.now()) / 1000);\n\t\t\t\t\t\t\t\toptions.onTokenRefresh!(accessToken, expiresIn);\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: undefined,\n\t\t\t\t\tfetch: createTransport({ interceptors: options.interceptors }).fetch,\n\t\t\t\t}),\n\t\t\t);\n\t\t}\n\n\t\tif (options.interceptors) {\n\t\t\tinterceptors.push(...options.interceptors);\n\t\t}\n\n\t\tthis.transport = createTransport({ interceptors });\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Schema\n\t// -----------------------------------------------------------------------\n\n\t/** List all collections */\n\tasync collections(): Promise<Collection[]> {\n\t\tconst data = await this.request<{ items: Collection[] }>(\"GET\", \"/schema/collections\");\n\t\treturn data.items;\n\t}\n\n\t/** Get a single collection with its fields */\n\tasync collection(slug: string): Promise<CollectionWithFields> {\n\t\tconst data = await this.request<{ item: CollectionWithFields }>(\n\t\t\t\"GET\",\n\t\t\t`/schema/collections/${encodeURIComponent(slug)}?includeFields=true`,\n\t\t);\n\t\tconst col = data.item;\n\t\t// Cache field schemas for PT conversion\n\t\tif (col.fields) {\n\t\t\tthis.fieldSchemaCache.set(\n\t\t\t\tslug,\n\t\t\t\tcol.fields.map((field) => ({\n\t\t\t\t\tslug: field.slug,\n\t\t\t\t\ttype: field.type,\n\t\t\t\t\tblockTypes: field.blockTypes,\n\t\t\t\t\tvalidation: field.validation,\n\t\t\t\t})),\n\t\t\t);\n\t\t}\n\t\treturn col;\n\t}\n\n\tasync blockTypes(): Promise<BlockType[]> {\n\t\tconst data = await this.request<{ items: BlockType[] }>(\"GET\", \"/schema/block-types\");\n\t\treturn data.items;\n\t}\n\n\tasync blockType(slug: string): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\n\t\t\t\"GET\",\n\t\t\t`/schema/block-types/${encodeURIComponent(slug)}`,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\tasync createBlockType(input: CreateBlockTypeInput): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\"POST\", \"/schema/block-types\", input);\n\t\treturn data.item;\n\t}\n\n\tasync updateBlockType(slug: string, input: UpdateBlockTypeInput): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\n\t\t\t\"PUT\",\n\t\t\t`/schema/block-types/${encodeURIComponent(slug)}`,\n\t\t\tinput,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\tasync activateBlockTypeVersion(\n\t\tslug: string,\n\t\tversion: number,\n\t\texpectedFingerprint: string,\n\t): Promise<BlockType> {\n\t\tconst data = await this.request<{ item: BlockType }>(\n\t\t\t\"POST\",\n\t\t\t`/schema/block-types/${encodeURIComponent(slug)}/versions/${version}/activate`,\n\t\t\t{ expectedFingerprint },\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** Create a collection */\n\tasync createCollection(input: {\n\t\tslug: string;\n\t\tlabel: string;\n\t\tlabelSingular?: string;\n\t\tdescription?: string;\n\t\ticon?: string;\n\t\tsupports?: string[];\n\t}): Promise<Collection> {\n\t\tconst data = await this.request<{ item: Collection }>(\"POST\", \"/schema/collections\", input);\n\t\treturn data.item;\n\t}\n\n\t/** Delete a collection */\n\tasync deleteCollection(slug: string): Promise<void> {\n\t\tawait this.request<unknown>(\"DELETE\", `/schema/collections/${encodeURIComponent(slug)}`);\n\t}\n\n\t/** Create a field on a collection */\n\tasync createField(\n\t\tcollection: string,\n\t\tinput: {\n\t\t\tslug: string;\n\t\t\ttype: string;\n\t\t\tlabel: string;\n\t\t\trequired?: boolean;\n\t\t\tunique?: boolean;\n\t\t\tdefaultValue?: unknown;\n\t\t\tvalidation?: unknown;\n\t\t\twidget?: string;\n\t\t\toptions?: unknown;\n\t\t\tsortOrder?: number;\n\t\t},\n\t): Promise<Field> {\n\t\tconst data = await this.request<{ item: Field }>(\n\t\t\t\"POST\",\n\t\t\t`/schema/collections/${encodeURIComponent(collection)}/fields`,\n\t\t\tinput,\n\t\t);\n\t\t// Invalidate field cache\n\t\tthis.fieldSchemaCache.delete(collection);\n\t\treturn data.item;\n\t}\n\n\t/** Delete a field from a collection */\n\tasync deleteField(collection: string, fieldSlug: string): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"DELETE\",\n\t\t\t`/schema/collections/${encodeURIComponent(collection)}/fields/${encodeURIComponent(fieldSlug)}`,\n\t\t);\n\t\tthis.fieldSchemaCache.delete(collection);\n\t}\n\n\t/** Get full manifest (schema + field descriptors + features) */\n\tasync manifest(): Promise<Manifest> {\n\t\treturn this.request<Manifest>(\"GET\", \"/manifest\");\n\t}\n\n\t/** Export full schema as JSON (used by `emdash types`) */\n\tasync schemaExport(): Promise<SchemaExport> {\n\t\treturn this.request<SchemaExport>(\"GET\", \"/schema\");\n\t}\n\n\t/** Export schema as TypeScript type definitions (used by `emdash types`) */\n\tasync schemaTypes(): Promise<string> {\n\t\tconst response = await this.requestRaw(\"GET\", \"/schema?format=typescript\");\n\t\tawait this.assertOk(response);\n\t\treturn response.text();\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Content\n\t// -----------------------------------------------------------------------\n\n\t/** List content in a collection */\n\tasync list(\n\t\tcollection: string,\n\t\toptions?: {\n\t\t\tstatus?: string;\n\t\t\tlimit?: number;\n\t\t\tcursor?: string;\n\t\t\torderBy?: string;\n\t\t\torder?: \"asc\" | \"desc\";\n\t\t\tlocale?: string;\n\t\t\t/** AND-combined filters over custom fields explicitly marked as indexed. */\n\t\t\tfieldFilters?: ContentFieldFilters;\n\t\t},\n\t): Promise<ListResult<ContentItem>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.status) params.set(\"status\", options.status);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tif (options?.orderBy) params.set(\"orderBy\", options.orderBy);\n\t\tif (options?.order) params.set(\"order\", options.order);\n\t\tif (options?.locale) params.set(\"locale\", options.locale);\n\t\tif (options?.fieldFilters && Object.keys(options.fieldFilters).length > 0) {\n\t\t\tparams.set(\"fieldFilters\", JSON.stringify(options.fieldFilters));\n\t\t}\n\n\t\tconst qs = params.toString();\n\t\tconst path = `/content/${encodeURIComponent(collection)}${qs ? `?${qs}` : \"\"}`;\n\t\treturn this.request<ListResult<ContentItem>>(\"GET\", path);\n\t}\n\n\t/** Async iterator that auto-follows cursors */\n\tasync *listAll(\n\t\tcollection: string,\n\t\toptions?: {\n\t\t\tstatus?: string;\n\t\t\tlimit?: number;\n\t\t\torderBy?: string;\n\t\t\torder?: \"asc\" | \"desc\";\n\t\t\tlocale?: string;\n\t\t\t/** AND-combined filters over custom fields explicitly marked as indexed. */\n\t\t\tfieldFilters?: ContentFieldFilters;\n\t\t},\n\t): AsyncGenerator<ContentItem> {\n\t\tlet cursor: string | undefined;\n\t\tdo {\n\t\t\tconst result = await this.list(collection, { ...options, cursor });\n\t\t\tfor (const item of result.items) {\n\t\t\t\tyield item;\n\t\t\t}\n\t\t\tcursor = result.nextCursor;\n\t\t} while (cursor);\n\t}\n\n\t/**\n\t * Get a single content item. Returns the item with a `_rev` token\n\t * that can be passed to update() for optimistic concurrency.\n\t */\n\tasync get(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions?: { raw?: boolean; locale?: string },\n\t): Promise<ContentItem> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.locale) params.set(\"locale\", options.locale);\n\t\tconst qs = params.size > 0 ? `?${params}` : \"\";\n\t\tconst result = await this.requestRaw(\n\t\t\t\"GET\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}${qs}`,\n\t\t);\n\t\tif (!result.ok) {\n\t\t\tawait this.assertOk(result);\n\t\t}\n\n\t\tconst raw = (await result.json()) as { data: { item: ContentItem; _rev?: string } };\n\t\tconst json = raw.data;\n\t\tconst item = json.item;\n\n\t\t// Attach _rev to the item so callers can pass it back on update\n\t\tif (json._rev) {\n\t\t\titem._rev = json._rev;\n\t\t}\n\n\t\t// Convert PT fields to markdown unless raw is requested\n\t\tif (!options?.raw && item.data) {\n\t\t\tconst fields = await this.getFieldSchemas(collection);\n\t\t\titem.data = convertDataForRead(item.data, fields, false);\n\t\t}\n\n\t\treturn item;\n\t}\n\n\t/** Create a new content item */\n\tasync create(\n\t\tcollection: string,\n\t\tinput: {\n\t\t\tdata: Record<string, unknown>;\n\t\t\tslug?: string;\n\t\t\tstatus?: string;\n\t\t\tlocale?: string;\n\t\t\ttranslationOf?: string;\n\t\t\tmigrateBlocks?: boolean;\n\t\t\treplaceBlocks?: boolean;\n\t\t},\n\t): Promise<ContentItem> {\n\t\t// Convert markdown strings to PT for portableText fields\n\t\tconst fields = await this.getFieldSchemas(collection);\n\t\tconst data = convertDataForWrite(input.data, fields);\n\n\t\tconst result = await this.request<{ item: ContentItem }>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}`,\n\t\t\t{ ...input, data },\n\t\t);\n\t\treturn result.item;\n\t}\n\n\t/**\n\t * Update a content item. Pass `_rev` from a prior get() for optimistic\n\t * concurrency — the server returns 409 if the item has changed.\n\t * Omit `_rev` for a blind write (no conflict detection).\n\t */\n\tasync update(\n\t\tcollection: string,\n\t\tid: string,\n\t\tinput: {\n\t\t\tdata?: Record<string, unknown>;\n\t\t\tslug?: string;\n\t\t\tstatus?: string;\n\t\t\t_rev?: string;\n\t\t\tlocale?: string;\n\t\t\tmigrateBlocks?: boolean;\n\t\t\treplaceBlocks?: boolean;\n\t\t\t/** Write even though another editor holds this entry's edit lock. */\n\t\t\toverrideLock?: boolean;\n\t\t},\n\t): Promise<ContentItem> {\n\t\t// Convert markdown strings to PT\n\t\tlet data = input.data;\n\t\tif (data) {\n\t\t\tconst fields = await this.getFieldSchemas(collection);\n\t\t\tdata = convertDataForWrite(data, fields);\n\t\t}\n\n\t\tconst body = {\n\t\t\tdata,\n\t\t\tslug: input.slug,\n\t\t\tstatus: input.status,\n\t\t\tmigrateBlocks: input.migrateBlocks,\n\t\t\treplaceBlocks: input.replaceBlocks,\n\t\t\t...(input._rev ? { _rev: input._rev } : {}),\n\t\t\t...(input.overrideLock ? { overrideLock: true } : {}),\n\t\t};\n\t\tconst params = new URLSearchParams();\n\t\tif (input.locale) params.set(\"locale\", input.locale);\n\t\tconst result = await this.request<{ item: ContentItem; _rev?: string }>(\n\t\t\t\"PUT\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}${params.toString() ? `?${params}` : \"\"}`,\n\t\t\tbody,\n\t\t);\n\n\t\tconst item = result.item;\n\t\tif (result._rev) {\n\t\t\titem._rev = result._rev;\n\t\t}\n\t\treturn item;\n\t}\n\n\t/** Delete (soft) a content item */\n\tasync delete(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tconst query = options.overrideLock ? \"?overrideLock=true\" : \"\";\n\t\tawait this.request<unknown>(\n\t\t\t\"DELETE\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}${query}`,\n\t\t);\n\t}\n\n\t/** Publish a content item */\n\tasync publish(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/publish`,\n\t\t\toptions.overrideLock ? { overrideLock: true } : undefined,\n\t\t);\n\t}\n\n\t/** Unpublish a content item */\n\tasync unpublish(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/unpublish`,\n\t\t\toptions.overrideLock ? { overrideLock: true } : undefined,\n\t\t);\n\t}\n\n\t/** Schedule publishing */\n\tasync schedule(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { at: string; overrideLock?: boolean },\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/schedule`,\n\t\t\t{ scheduledAt: options.at, ...(options.overrideLock ? { overrideLock: true } : {}) },\n\t\t);\n\t}\n\n\t/** Restore a trashed content item */\n\tasync restore(collection: string, id: string): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/restore`,\n\t\t);\n\t}\n\n\t/** Compare live and draft revisions */\n\tasync compare(\n\t\tcollection: string,\n\t\tid: string,\n\t): Promise<{\n\t\thasChanges: boolean;\n\t\tlive: Record<string, unknown> | null;\n\t\tdraft: Record<string, unknown> | null;\n\t}> {\n\t\treturn this.request<{\n\t\t\thasChanges: boolean;\n\t\t\tlive: Record<string, unknown> | null;\n\t\t\tdraft: Record<string, unknown> | null;\n\t\t}>(\"GET\", `/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/compare`);\n\t}\n\n\t/** Discard draft revision, reverting to the published version */\n\tasync discardDraft(\n\t\tcollection: string,\n\t\tid: string,\n\t\toptions: { overrideLock?: boolean } = {},\n\t): Promise<void> {\n\t\tawait this.request<unknown>(\n\t\t\t\"POST\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/discard-draft`,\n\t\t\toptions.overrideLock ? { overrideLock: true } : undefined,\n\t\t);\n\t}\n\n\t/**\n\t * Get all translations of a content item.\n\t * Returns the translation group ID and a summary of each locale version.\n\t */\n\tasync translations(\n\t\tcollection: string,\n\t\tid: string,\n\t): Promise<{\n\t\ttranslationGroup: string;\n\t\ttranslations: Array<{\n\t\t\tid: string;\n\t\t\tlocale: string | null;\n\t\t\tslug: string | null;\n\t\t\tstatus: string;\n\t\t\tupdatedAt: string;\n\t\t}>;\n\t}> {\n\t\treturn this.request(\n\t\t\t\"GET\",\n\t\t\t`/content/${encodeURIComponent(collection)}/${encodeURIComponent(id)}/translations`,\n\t\t);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Media\n\t// -----------------------------------------------------------------------\n\n\t/** List media items */\n\tasync mediaList(options?: {\n\t\tmimeType?: string;\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t\tpage?: number;\n\t\tincludeUsage?: boolean;\n\t\tfolderId?: string | null;\n\t}): Promise<ListResult<MediaItem> & { totalCount?: number }> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.mimeType) params.set(\"mimeType\", options.mimeType);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tif (options?.page !== undefined) params.set(\"page\", String(options.page));\n\t\tif (options?.includeUsage === true) params.set(\"includeUsage\", \"1\");\n\t\tif (options?.folderId === null) {\n\t\t\tparams.set(\"folderId\", \"unfiled\");\n\t\t} else if (options?.folderId !== undefined) {\n\t\t\tparams.set(\"folderId\", options.folderId);\n\t\t}\n\n\t\tconst qs = params.toString();\n\t\treturn this.request<ListResult<MediaItem> & { totalCount?: number }>(\n\t\t\t\"GET\",\n\t\t\t`/media${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t}\n\n\t/** Get a single media item */\n\tasync mediaGet(id: string, options?: { includeUsage?: boolean }): Promise<MediaItem> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.includeUsage === true) params.set(\"includeUsage\", \"1\");\n\n\t\tconst qs = params.toString();\n\t\tconst data = await this.request<{ item: MediaItem }>(\n\t\t\t\"GET\",\n\t\t\t`/media/${encodeURIComponent(id)}${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** List media folders */\n\tasync mediaFolderList(\n\t\toptions: { limit?: number; cursor?: string; q?: string } = {},\n\t): Promise<ListResult<MediaFolder>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options.cursor !== undefined) params.set(\"cursor\", options.cursor);\n\t\tif (options.q !== undefined) params.set(\"q\", options.q);\n\t\tconst qs = params.toString();\n\t\treturn this.request<ListResult<MediaFolder>>(\"GET\", `/media/folders${qs ? `?${qs}` : \"\"}`);\n\t}\n\n\t/** Get one media folder */\n\tasync mediaFolderGet(id: string): Promise<MediaFolder> {\n\t\tconst data = await this.request<{ item: MediaFolder }>(\n\t\t\t\"GET\",\n\t\t\t`/media/folders/${encodeURIComponent(id)}`,\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** Create a media folder */\n\tasync mediaFolderCreate(name: string): Promise<MediaFolder> {\n\t\tconst data = await this.request<{ item: MediaFolder }>(\"POST\", \"/media/folders\", { name });\n\t\treturn data.item;\n\t}\n\n\t/** Rename a media folder */\n\tasync mediaFolderUpdate(id: string, name: string): Promise<MediaFolder> {\n\t\tconst data = await this.request<{ item: MediaFolder }>(\n\t\t\t\"PUT\",\n\t\t\t`/media/folders/${encodeURIComponent(id)}`,\n\t\t\t{ name },\n\t\t);\n\t\treturn data.item;\n\t}\n\n\t/** Delete a media folder */\n\tasync mediaFolderDelete(id: string): Promise<void> {\n\t\tawait this.request<unknown>(\"DELETE\", `/media/folders/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Assign media to a folder, or return it to the Main library */\n\tasync mediaSetFolder(id: string, folderId: string | null): Promise<MediaFolderAssignment> {\n\t\tconst data = await this.request<{ item: MediaFolderAssignment }>(\n\t\t\t\"PUT\",\n\t\t\t`/media/${encodeURIComponent(id)}`,\n\t\t\t{ folderId },\n\t\t);\n\t\treturn { id: data.item.id, folderId: data.item.folderId };\n\t}\n\n\t/** Get entry-grouped usage details for a media item */\n\tasync mediaGetUsage(\n\t\tid: string,\n\t\toptions?: { limit?: number; cursor?: string },\n\t): Promise<MediaUsageDetailsResponse> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor !== undefined) params.set(\"cursor\", options.cursor);\n\n\t\tconst qs = params.toString();\n\t\treturn this.request<MediaUsageDetailsResponse>(\n\t\t\t\"GET\",\n\t\t\t`/media/${encodeURIComponent(id)}/usage${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t}\n\n\t/** Upload a media file */\n\tasync mediaUpload(\n\t\tfile: Uint8Array | Blob,\n\t\tfilename: string,\n\t\toptions?: { alt?: string; caption?: string; contentType?: string },\n\t): Promise<MediaItem> {\n\t\tconst formData = new FormData();\n\n\t\t// Handle different file types\n\t\tif (file instanceof Blob) {\n\t\t\tformData.append(\"file\", file, filename);\n\t\t} else {\n\t\t\tconst mimeType = options?.contentType ?? mimeFromFilename(filename);\n\t\t\tformData.append(\"file\", new Blob([file as BlobPart], { type: mimeType }), filename);\n\t\t}\n\n\t\tif (options?.alt) formData.append(\"alt\", options.alt);\n\t\tif (options?.caption) formData.append(\"caption\", options.caption);\n\n\t\tconst url = `${this.baseUrl}/_emdash/api/media`;\n\t\tconst request = new Request(url, {\n\t\t\tmethod: \"POST\",\n\t\t\tbody: formData,\n\t\t});\n\n\t\tconst response = await this.transport.fetch(request);\n\t\tawait this.assertOk(response);\n\n\t\tconst raw = (await response.json()) as { data: { item: MediaItem } };\n\t\treturn raw.data.item;\n\t}\n\n\t/** Delete a media item */\n\tasync mediaDelete(id: string): Promise<void> {\n\t\tawait this.request<unknown>(\"DELETE\", `/media/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Repair content media usage indexes for one collection or all collections */\n\tasync mediaRepairUsage(input: MediaUsageRepairInput): Promise<MediaUsageRepairResponse> {\n\t\treturn this.request<MediaUsageRepairResponse>(\"POST\", \"/admin/media-usage/repair\", input);\n\t}\n\n\t/** Read aggregate Media Usage indexing progress */\n\tasync mediaGetUsageProgress(): Promise<MediaUsageProgress> {\n\t\treturn this.request<MediaUsageProgress>(\"GET\", \"/admin/media-usage/progress\");\n\t}\n\n\t/** Advance exactly one Media Usage maintenance step */\n\tasync mediaAdvanceUsageProgress(): Promise<MediaUsageProgressAdvanceResponse> {\n\t\treturn this.request<MediaUsageProgressAdvanceResponse>(\"POST\", \"/admin/media-usage/progress\");\n\t}\n\n\t/** Read the redacted controlled-activation status */\n\tasync mediaGetUsageActivation(): Promise<MediaUsageActivationStatus> {\n\t\treturn this.request<MediaUsageActivationStatus>(\"GET\", \"/admin/media-usage/activation\");\n\t}\n\n\t/** Advance exactly one controlled-activation batch */\n\tasync mediaAdvanceUsageActivation(\n\t\tinput: MediaUsageActivationAdvanceInput,\n\t): Promise<MediaUsageActivationAdvanceResponse> {\n\t\treturn this.request<MediaUsageActivationAdvanceResponse>(\n\t\t\t\"POST\",\n\t\t\t\"/admin/media-usage/activation\",\n\t\t\tinput,\n\t\t);\n\t}\n\n\t/** List a bounded page of durable media usage entry work */\n\tasync mediaListUsageWork(\n\t\toptions: MediaUsageWorkListOptions,\n\t): Promise<MediaUsageWorkListResponse> {\n\t\tconst params = new URLSearchParams({ collection: options.collection });\n\t\tif (options.state) params.set(\"state\", options.state);\n\t\tif (options.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options.cursor) params.set(\"cursor\", options.cursor);\n\t\treturn this.request<MediaUsageWorkListResponse>(\"GET\", `/admin/media-usage/work?${params}`);\n\t}\n\n\t/** Explicitly retry one durable media usage entry job */\n\tasync mediaRetryUsageWork(input: MediaUsageWorkRetryInput): Promise<MediaUsageWorkRetryResponse> {\n\t\treturn this.request<MediaUsageWorkRetryResponse>(\n\t\t\t\"POST\",\n\t\t\t\"/admin/media-usage/work/retry\",\n\t\t\tinput,\n\t\t);\n\t}\n\n\tasync mediaListCollectionDeletions(\n\t\toptions: {\n\t\t\tstate?: MediaUsageCollectionDeletionState;\n\t\t\tlimit?: number;\n\t\t\tcursor?: string;\n\t\t} = {},\n\t): Promise<MediaUsageCollectionDeletionListResponse> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options.state) params.set(\"state\", options.state);\n\t\tif (options.limit !== undefined) params.set(\"limit\", String(options.limit));\n\t\tif (options.cursor) params.set(\"cursor\", options.cursor);\n\t\treturn this.request(\"GET\", `/admin/media-usage/collection-deletions?${params}`);\n\t}\n\n\tasync mediaRetryCollectionDeletion(collectionId: string): Promise<{\n\t\tchanged: boolean;\n\t\titem: MediaUsageCollectionDeletionItem;\n\t}> {\n\t\treturn this.request(\"POST\", \"/admin/media-usage/collection-deletions/retry\", {\n\t\t\tcollectionId,\n\t\t});\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Search\n\t// -----------------------------------------------------------------------\n\n\t/** Full-text search */\n\tasync search(\n\t\tquery: string,\n\t\toptions?: { collection?: string; locale?: string; limit?: number },\n\t): Promise<SearchResult[]> {\n\t\tconst params = new URLSearchParams({ q: query });\n\t\tif (options?.collection) params.set(\"collections\", options.collection);\n\t\tif (options?.locale) params.set(\"locale\", options.locale);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\n\t\tconst data = await this.request<{ items: SearchResult[] }>(\"GET\", `/search?${params}`);\n\t\treturn data.items;\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Taxonomies\n\t// -----------------------------------------------------------------------\n\n\t/** List taxonomies */\n\tasync taxonomies(): Promise<Taxonomy[]> {\n\t\tconst data = await this.request<{ taxonomies: Taxonomy[] }>(\"GET\", \"/taxonomies\");\n\t\treturn data.taxonomies;\n\t}\n\n\t/**\n\t * List terms in a taxonomy. Visible-usage counts are included by default.\n\t * Pass `includeCounts: false` to skip the aggregate; `count` is then omitted\n\t * from each term.\n\t */\n\tasync terms(\n\t\ttaxonomy: string,\n\t\toptions?: { limit?: number; cursor?: string; includeCounts?: boolean },\n\t): Promise<ListResult<Term>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tif (options?.includeCounts !== undefined)\n\t\t\tparams.set(\"includeCounts\", String(options.includeCounts));\n\n\t\tconst qs = params.toString();\n\t\tconst data = await this.request<{ terms: Term[] }>(\n\t\t\t\"GET\",\n\t\t\t`/taxonomies/${encodeURIComponent(taxonomy)}/terms${qs ? `?${qs}` : \"\"}`,\n\t\t);\n\t\treturn { items: data.terms };\n\t}\n\n\t/** Create a taxonomy term */\n\tasync createTerm(\n\t\ttaxonomy: string,\n\t\tinput: { slug: string; label: string; parentId?: string; description?: string },\n\t): Promise<Term> {\n\t\treturn this.request<Term>(\"POST\", `/taxonomies/${encodeURIComponent(taxonomy)}/terms`, input);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Menus\n\t// -----------------------------------------------------------------------\n\n\t/** List menus */\n\tasync menus(): Promise<Menu[]> {\n\t\t// Handler returns a bare array, not { items: [...] }\n\t\treturn this.request<Menu[]>(\"GET\", \"/menus\");\n\t}\n\n\t/** Get a menu with its items */\n\tasync menu(name: string): Promise<MenuWithItems> {\n\t\treturn this.request<MenuWithItems>(\"GET\", `/menus/${encodeURIComponent(name)}`);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Users\n\t// -----------------------------------------------------------------------\n\n\t/** List users (admin only) */\n\tasync users(options?: {\n\t\tsearch?: string;\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t}): Promise<ListResult<UserSummary>> {\n\t\tconst params = new URLSearchParams();\n\t\tif (options?.search) params.set(\"search\", options.search);\n\t\tif (options?.limit) params.set(\"limit\", String(options.limit));\n\t\tif (options?.cursor) params.set(\"cursor\", options.cursor);\n\t\tconst qs = params.toString();\n\t\treturn this.request<ListResult<UserSummary>>(\"GET\", `/admin/users${qs ? `?${qs}` : \"\"}`);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Site transfer\n\t// -----------------------------------------------------------------------\n\n\t/** Formats, features, limits, and whether this site can receive an import */\n\tasync transferCapabilities(): Promise<TransferCapabilities> {\n\t\treturn this.request<TransferCapabilities>(\"GET\", \"/admin/transfer/capabilities\");\n\t}\n\n\t/**\n\t * Start a site export. With an idempotency key, repeating the call returns\n\t * the export first created with that key.\n\t */\n\tasync transferExportCreate(\n\t\toptions: { comments?: boolean } = {},\n\t\trequest: { idempotencyKey?: string } = {},\n\t): Promise<{ operation: TransferOperation; created: boolean }> {\n\t\treturn this.request(\"POST\", \"/admin/transfer/exports\", options, idempotencyHeader(request));\n\t}\n\n\t/** List exports, newest first */\n\tasync transferExportList(options?: {\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t}): Promise<ListResult<TransferOperation>> {\n\t\treturn this.request(\"GET\", `/admin/transfer/exports${pageQuery(options)}`);\n\t}\n\n\tasync transferExportGet(id: string): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"GET\", `/admin/transfer/exports/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Run one bounded export step */\n\tasync transferExportAdvance(id: string): Promise<TransferAdvanceResult> {\n\t\treturn this.request(\"POST\", `/admin/transfer/exports/${encodeURIComponent(id)}/advance`);\n\t}\n\n\t/** The complete export's `manifest.json`, byte for byte */\n\tasync transferExportManifest(id: string): Promise<Uint8Array> {\n\t\tconst response = await this.requestRaw(\n\t\t\t\"GET\",\n\t\t\t`/admin/transfer/exports/${encodeURIComponent(id)}/manifest`,\n\t\t);\n\t\tawait this.assertOk(response);\n\t\treturn new Uint8Array(await response.arrayBuffer());\n\t}\n\n\t/**\n\t * Stream one file of a complete export. The server ends the stream with an\n\t * error if the stored bytes no longer match the export, so callers must\n\t * still check the size and digest of what they receive.\n\t */\n\tasync transferExportFile(id: string, path: string): Promise<TransferFileDownload> {\n\t\tconst response = await this.requestRaw(\n\t\t\t\"GET\",\n\t\t\t`/admin/transfer/exports/${encodeURIComponent(id)}/files/${encodePackagePath(path)}`,\n\t\t);\n\t\tawait this.assertOk(response);\n\t\tif (!response.body) throw new EmDashClientError(`Empty response for ${path}`);\n\t\tconst length = response.headers.get(\"Content-Length\");\n\t\tconst etag = response.headers.get(\"ETag\");\n\t\treturn {\n\t\t\tbody: response.body,\n\t\t\tbytes: length !== null && DECIMAL_PATTERN.test(length) ? Number(length) : null,\n\t\t\tsha256: etag ? (SHA256_ETAG_PATTERN.exec(etag)?.[1] ?? null) : null,\n\t\t};\n\t}\n\n\t/**\n\t * Create an import from a package's `manifest.json` bytes. With an\n\t * idempotency key, repeating the call with the same manifest returns the\n\t * import first created with that key.\n\t */\n\tasync transferImportCreate(\n\t\tmanifest: Uint8Array,\n\t\trequest: { idempotencyKey?: string } = {},\n\t): Promise<TransferImportCreateResult> {\n\t\tconst response = await this.send(\"POST\", \"/admin/transfer/imports\", {\n\t\t\tbody: manifest,\n\t\t\theaders: { \"Content-Type\": \"application/json\", ...idempotencyHeader(request) },\n\t\t});\n\t\tawait this.assertOk(response);\n\t\tconst json = (await response.json()) as { data: TransferImportCreateResult };\n\t\treturn json.data;\n\t}\n\n\t/** List imports, newest first */\n\tasync transferImportList(options?: {\n\t\tlimit?: number;\n\t\tcursor?: string;\n\t}): Promise<ListResult<TransferOperation>> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports${pageQuery(options)}`);\n\t}\n\n\tasync transferImportGet(id: string): Promise<TransferImportStatus> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports/${encodeURIComponent(id)}`);\n\t}\n\n\t/** Declared package files not uploaded yet, in path order */\n\tasync transferImportMissing(\n\t\tid: string,\n\t\toptions?: { limit?: number; cursor?: string },\n\t): Promise<ListResult<TransferPackageFile>> {\n\t\treturn this.request(\n\t\t\t\"GET\",\n\t\t\t`/admin/transfer/imports/${encodeURIComponent(id)}/missing${pageQuery(options)}`,\n\t\t);\n\t}\n\n\t/**\n\t * Upload one declared package file. `bytes` must be the file's exact size;\n\t * a stream body is sent with that `Content-Length`.\n\t */\n\tasync transferImportUploadFile(\n\t\tid: string,\n\t\tpath: string,\n\t\tbody: Uint8Array | ReadableStream<Uint8Array>,\n\t\tbytes: number,\n\t): Promise<TransferFileUploadResult> {\n\t\tconst response = await this.send(\n\t\t\t\"PUT\",\n\t\t\t`/admin/transfer/imports/${encodeURIComponent(id)}/files/${encodePackagePath(path)}`,\n\t\t\t{\n\t\t\t\tbody,\n\t\t\t\theaders: {\n\t\t\t\t\t\"Content-Type\": \"application/octet-stream\",\n\t\t\t\t\t\"Content-Length\": String(bytes),\n\t\t\t\t},\n\t\t\t},\n\t\t);\n\t\tawait this.assertOk(response);\n\t\tconst json = (await response.json()) as { data: TransferFileUploadResult };\n\t\treturn json.data;\n\t}\n\n\t/**\n\t * Run one bounded analysis step. Once the import is planned the result\n\t * carries the plan; `decisions` are then applied, producing a new plan\n\t * digest.\n\t */\n\tasync transferImportAnalyze(\n\t\tid: string,\n\t\tdecisions?: SiteImportDecisionsInput,\n\t): Promise<TransferImportAnalyzeResult> {\n\t\treturn this.request(\n\t\t\t\"POST\",\n\t\t\t`/admin/transfer/imports/${encodeURIComponent(id)}/analyze`,\n\t\t\tdecisions === undefined ? undefined : { decisions },\n\t\t);\n\t}\n\n\tasync transferImportPlan(\n\t\tid: string,\n\t): Promise<{ plan: SiteImportPlan; planDigest: Sha256Digest }> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports/${encodeURIComponent(id)}/plan`);\n\t}\n\n\t/** Start a planned import. Both digests must match the reviewed package and plan. */\n\tasync transferImportExecute(\n\t\tid: string,\n\t\tinput: { packageDigest: string; planDigest: string },\n\t): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/execute`, {\n\t\t\tpackageDigest: input.packageDigest,\n\t\t\tplanDigest: input.planDigest,\n\t\t});\n\t}\n\n\t/** Run one bounded step of an executing import */\n\tasync transferImportAdvance(id: string): Promise<TransferAdvanceResult> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/advance`);\n\t}\n\n\tasync transferImportReceipt(id: string): Promise<{ receipt: SiteImportReceipt }> {\n\t\treturn this.request(\"GET\", `/admin/transfer/imports/${encodeURIComponent(id)}/receipt`);\n\t}\n\n\t/**\n\t * Cancel an import. An idle import is cancelled at once; a step in\n\t * progress stops after its current batch, so the returned operation may\n\t * still be executing with `cancelRequestedAt` set.\n\t */\n\tasync transferImportCancel(id: string): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/cancel`);\n\t}\n\n\t/**\n\t * Abandon a failed or cancelled import, lifting the site write fence it\n\t * holds. Data the import already wrote stays in place.\n\t */\n\tasync transferImportAbandon(id: string): Promise<{ operation: TransferOperation }> {\n\t\treturn this.request(\"POST\", `/admin/transfer/imports/${encodeURIComponent(id)}/abandon`);\n\t}\n\n\t// -----------------------------------------------------------------------\n\t// Internal helpers\n\t// -----------------------------------------------------------------------\n\n\t/** Make a typed JSON request to the API */\n\tprivate async request<T>(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody?: unknown,\n\t\textraHeaders?: Record<string, string>,\n\t): Promise<T> {\n\t\tconst response = await this.requestRaw(method, path, body, extraHeaders);\n\t\tawait this.assertOk(response);\n\t\tconst json = (await response.json()) as { data: T };\n\t\treturn json.data;\n\t}\n\n\t/** Make a raw request — caller handles response */\n\tprivate async requestRaw(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tbody?: unknown,\n\t\textraHeaders?: Record<string, string>,\n\t): Promise<Response> {\n\t\tconst headers: Record<string, string> = { ...extraHeaders };\n\n\t\tlet requestBody: string | undefined;\n\t\tif (body !== undefined) {\n\t\t\theaders[\"Content-Type\"] = \"application/json\";\n\t\t\trequestBody = JSON.stringify(body);\n\t\t}\n\n\t\treturn this.send(method, path, { body: requestBody, headers });\n\t}\n\n\t/** Send a request with an arbitrary body; the caller handles the response */\n\tprivate async send(\n\t\tmethod: string,\n\t\tpath: string,\n\t\tinit: {\n\t\t\tbody?: string | Uint8Array | ReadableStream<Uint8Array>;\n\t\t\theaders?: Record<string, string>;\n\t\t},\n\t): Promise<Response> {\n\t\tconst url = `${this.baseUrl}/_emdash/api${path}`;\n\t\tconst request = new Request(url, {\n\t\t\tmethod,\n\t\t\theaders: { Accept: \"application/json\", ...init.headers },\n\t\t\tbody: init.body as BodyInit | undefined,\n\t\t\t...(init.body instanceof ReadableStream ? { duplex: \"half\" } : {}),\n\t\t});\n\n\t\treturn this.transport.fetch(request);\n\t}\n\n\t/** Assert a response is OK, throw typed error if not */\n\tprivate async assertOk(response: Response): Promise<void> {\n\t\tif (response.ok) return;\n\n\t\tlet code = \"UNKNOWN_ERROR\";\n\t\tlet message = `HTTP ${response.status}`;\n\t\tlet details: Record<string, unknown> | undefined;\n\n\t\ttry {\n\t\t\tconst json = (await response.json()) as {\n\t\t\t\terror?: { code?: string; message?: string; details?: Record<string, unknown> };\n\t\t\t};\n\t\t\tif (json.error) {\n\t\t\t\tcode = json.error.code ?? code;\n\t\t\t\tmessage = json.error.message ?? message;\n\t\t\t\tdetails = json.error.details;\n\t\t\t}\n\t\t} catch {\n\t\t\t// Response body isn't JSON — use status text\n\t\t\tmessage = response.statusText || message;\n\t\t}\n\n\t\tthrow new EmDashApiError(response.status, code, message, details);\n\t}\n\n\t/** Get cached field schemas for a collection, fetching if needed */\n\tprivate async getFieldSchemas(collection: string): Promise<FieldSchema[]> {\n\t\tlet cached = this.fieldSchemaCache.get(collection);\n\t\tif (cached) return cached;\n\n\t\ttry {\n\t\t\tconst col = await this.collection(collection);\n\t\t\tcached = col.fields.map((field) => ({\n\t\t\t\tslug: field.slug,\n\t\t\t\ttype: field.type,\n\t\t\t\tblockTypes: field.blockTypes,\n\t\t\t\tvalidation: field.validation,\n\t\t\t}));\n\t\t\tthis.fieldSchemaCache.set(collection, cached);\n\t\t\treturn cached;\n\t\t} catch {\n\t\t\t// If we can't fetch the schema, skip conversion\n\t\t\treturn [];\n\t\t}\n\t}\n}\n\ntype _AssertTrue<T extends true> = T;\ntype _MediaRepairUsageRequiresExplicitInput = _AssertTrue<\n\tParameters<EmDashClient[\"mediaRepairUsage\"]> extends [MediaUsageRepairInput] ? true : false\n>;\n\nexport type { SiteImportDecisionsInput, SiteImportPlan, SiteImportReceipt, Sha256Digest };\n\n// Re-export transport types for interceptor authors\nexport type { Interceptor } from \"./transport.js\";\nexport {\n\tcreateTransport,\n\tcsrfInterceptor,\n\ttokenInterceptor,\n\tdevBypassInterceptor,\n} from \"./transport.js\";\nexport { portableTextToMarkdown, markdownToPortableText } from \"./portable-text.js\";\nexport type { PortableTextBlock } from \"./portable-text.js\";\n"],"mappings":"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"}

package/dist/collection-slugs-cache-B2J5aESO.mjs

@@ -0,0 +1,91 @@
+import { t as after } from "./after-PcEvMY_6.mjs";
+import { getRequestContext } from "./request-context.mjs";
+import { n as invalidateSingleFlightCache, r as singleFlightCached, t as createSingleFlightCache } from "./single-flight-cache-D0EaGbN1.mjs";
+import { r as requestCached } from "./request-cache-5z2WzWmh.mjs";
+
+//#region src/schema/collection-slugs-cache.ts
+const HOLDER_KEY = Symbol.for("emdash:collection-slugs@2");
+const g = globalThis;
+const holder = g[HOLDER_KEY] ?? (() => {
+	const h = {
+		cache: createSingleFlightCache(),
+		fetchedAt: 0
+	};
+	g[HOLDER_KEY] = h;
+	return h;
+})();
+const REVALIDATE_WINDOW_MS = 6e4;
+let revalidateWindowMs = REVALIDATE_WINDOW_MS;
+async function fetchSlugs(db) {
+	const rows = await db.selectFrom("_emdash_collections").select("slug").execute();
+	return new Set(rows.map((row) => row.slug));
+}
+function loadSlugs(db) {
+	return singleFlightCached(holder.cache, async () => {
+		const slugs = await fetchSlugs(db);
+		holder.fetchedAt = Date.now();
+		return slugs;
+	}, {
+		anchor: (promise) => after(() => promise),
+		ownerTimeoutMs: 3e4
+	});
+}
+/**
+* Keep only the collections that have a `_emdash_collections` row, i.e. whose
+* `ec_*` table the registry has created. When the filter would drop a
+* collection and the cached set is older than the revalidation window, the
+* set is re-fetched once so a collection created by another isolate becomes
+* visible without waiting for an isolate recycle.
+*/
+async function filterToRegisteredCollections(db, collections) {
+	if (collections.length === 0) return [];
+	if (getRequestContext()?.dbIsIsolated === true) {
+		const slugs = await requestCached("collection-slugs", () => fetchSlugs(db));
+		return collections.filter((slug) => slugs.has(slug));
+	}
+	let slugs = await loadSlugs(db);
+	let present = collections.filter((slug) => slugs.has(slug));
+	if (present.length < collections.length && Date.now() - holder.fetchedAt > revalidateWindowMs) {
+		holder.fetchedAt = Date.now();
+		invalidateSingleFlightCache(holder.cache);
+		slugs = await loadSlugs(db);
+		present = collections.filter((slug) => slugs.has(slug));
+	}
+	return present;
+}
+/**
+* Seed the cache with slugs an init-time read already fetched, so the first
+* render on a cold isolate pays no extra query. Called by the runtime's
+* auto-seed gate.
+*/
+function primeRegisteredCollections(slugs) {
+	const { cache } = holder;
+	cache.value = new Set(slugs);
+	cache.hasValue = true;
+	cache.valueVersion = cache.version;
+	holder.fetchedAt = Date.now();
+}
+/**
+* Drop the cached slug set so the next reader re-fetches. Called from every
+* schema-mutation path (`invalidateUrlPatternCache`, `SchemaRegistry`
+* create/delete). Other isolates converge through bounded revalidation.
+*/
+function resetRegisteredCollectionsCache() {
+	invalidateSingleFlightCache(holder.cache);
+	holder.fetchedAt = 0;
+}
+/**
+* Note that a query hit a missing `ec_*` table despite the slug filter: the
+* cached set is stale (the collection was deleted on another isolate) or the
+* registry has drifted from the physical schema. Drops the cached set at most
+* once per revalidation window, so the delete case converges like the create
+* case while genuine drift costs one slug re-fetch per window instead of one
+* per render.
+*/
+function noteStaleRegisteredCollections() {
+	if (Date.now() - holder.fetchedAt > revalidateWindowMs) resetRegisteredCollectionsCache();
+}
+
+//#endregion
+export { resetRegisteredCollectionsCache as i, noteStaleRegisteredCollections as n, primeRegisteredCollections as r, filterToRegisteredCollections as t };
+//# sourceMappingURL=collection-slugs-cache-B2J5aESO.mjs.map

package/dist/collection-slugs-cache-B2J5aESO.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"collection-slugs-cache-B2J5aESO.mjs","names":[],"sources":["../src/schema/collection-slugs-cache.ts"],"sourcesContent":["/**\n * Per-isolate cache of registered collection slugs (`_emdash_collections`).\n *\n * Term counting scopes its per-collection UNION to a taxonomy's declared\n * collections, but a declared collection is not necessarily a created one:\n * the migration-seeded defaults declare `posts` whether or not that\n * collection ever exists. Querying optimistically and catching the\n * missing-table error keeps results correct, yet the failed statement itself\n * is logged by the database — on D1 it surfaces as a `no such table` error\n * span per taxonomy per uncached render. Filtering declared collections\n * against the registry up front means the failing statement is never sent.\n *\n * Stored on globalThis behind a Symbol key (same pattern as the taxonomy-defs\n * cache in `taxonomies/index.ts`) so bundler chunk duplication cannot produce\n * two independent caches. It holds the resolved set behind a reclaimable\n * single-flight lock, never an in-flight promise (see\n * `utils/single-flight-cache.ts`).\n *\n * Freshness:\n * - Primed for free at isolate boot: runtime init's auto-seed gate already\n *   reads `_emdash_collections` and hands the slugs to\n *   `primeRegisteredCollections`, so cold isolates pay no extra query.\n * - Every schema-mutation path resets it: `invalidateUrlPatternCache()`\n *   (admin API, MCP, WordPress import, seed application) and\n *   `SchemaRegistry.createCollection`/`deleteCollection` for direct callers.\n * - Creations on *other* isolates surface through bounded revalidation: the\n *   set is re-fetched only when the filter would actually drop a declared\n *   collection and the cached copy is older than the revalidation window.\n *   Sites whose declared collections all exist — the steady state — never\n *   revalidate; a site with a genuinely absent collection pays one slug read\n *   per window instead of one failing statement per render, and a collection\n *   created elsewhere starts counting within the window.\n *\n * Isolated databases bypass the cache (playground / DO preview requests set\n * `requestContext.dbIsIsolated`): they point at a divergent schema, so the\n * slug set is fetched per request instead, deduped by the request cache.\n */\n\nimport type { Kysely } from \"kysely\";\n\nimport { after } from \"../after.js\";\nimport type { Database } from \"../database/types.js\";\nimport { requestCached } from \"../request-cache.js\";\nimport { getRequestContext } from \"../request-context.js\";\nimport {\n\tcreateSingleFlightCache,\n\tinvalidateSingleFlightCache,\n\ttype SingleFlightCache,\n\tsingleFlightCached,\n} from \"../utils/single-flight-cache.js\";\n\ninterface SlugsHolder {\n\tcache: SingleFlightCache<Set<string>>;\n\t/** When the cached set was fetched; gates bounded revalidation. */\n\tfetchedAt: number;\n}\n\nconst HOLDER_KEY = Symbol.for(\"emdash:collection-slugs@2\");\nconst g = globalThis as Record<symbol, unknown>;\nconst holder: SlugsHolder =\n\t// eslint-disable-next-line typescript/no-unsafe-type-assertion -- globalThis singleton pattern (see request-cache.ts)\n\t(g[HOLDER_KEY] as SlugsHolder | undefined) ??\n\t(() => {\n\t\tconst h: SlugsHolder = { cache: createSingleFlightCache(), fetchedAt: 0 };\n\t\tg[HOLDER_KEY] = h;\n\t\treturn h;\n\t})();\n\nconst REVALIDATE_WINDOW_MS = 60_000;\nlet revalidateWindowMs = REVALIDATE_WINDOW_MS;\n\nasync function fetchSlugs(db: Kysely<Database>): Promise<Set<string>> {\n\tconst rows = await db.selectFrom(\"_emdash_collections\").select(\"slug\").execute();\n\treturn new Set(rows.map((row) => row.slug));\n}\n\nfunction loadSlugs(db: Kysely<Database>): Promise<Set<string>> {\n\treturn singleFlightCached(\n\t\tholder.cache,\n\t\tasync () => {\n\t\t\tconst slugs = await fetchSlugs(db);\n\t\t\tholder.fetchedAt = Date.now();\n\t\t\treturn slugs;\n\t\t},\n\t\t{ anchor: (promise) => after(() => promise), ownerTimeoutMs: 30_000 },\n\t);\n}\n\n/**\n * Keep only the collections that have a `_emdash_collections` row, i.e. whose\n * `ec_*` table the registry has created. When the filter would drop a\n * collection and the cached set is older than the revalidation window, the\n * set is re-fetched once so a collection created by another isolate becomes\n * visible without waiting for an isolate recycle.\n */\nexport async function filterToRegisteredCollections(\n\tdb: Kysely<Database>,\n\tcollections: readonly string[],\n): Promise<string[]> {\n\tif (collections.length === 0) return [];\n\tif (getRequestContext()?.dbIsIsolated === true) {\n\t\tconst slugs = await requestCached(\"collection-slugs\", () => fetchSlugs(db));\n\t\treturn collections.filter((slug) => slugs.has(slug));\n\t}\n\tlet slugs = await loadSlugs(db);\n\tlet present = collections.filter((slug) => slugs.has(slug));\n\tif (present.length < collections.length && Date.now() - holder.fetchedAt > revalidateWindowMs) {\n\t\t// Stamped before the refetch so parallel readers of the stale set skip their own.\n\t\tholder.fetchedAt = Date.now();\n\t\tinvalidateSingleFlightCache(holder.cache);\n\t\tslugs = await loadSlugs(db);\n\t\tpresent = collections.filter((slug) => slugs.has(slug));\n\t}\n\treturn present;\n}\n\n/**\n * Seed the cache with slugs an init-time read already fetched, so the first\n * render on a cold isolate pays no extra query. Called by the runtime's\n * auto-seed gate.\n */\nexport function primeRegisteredCollections(slugs: readonly string[]): void {\n\tconst { cache } = holder;\n\tcache.value = new Set(slugs);\n\tcache.hasValue = true;\n\tcache.valueVersion = cache.version;\n\tholder.fetchedAt = Date.now();\n}\n\n/**\n * Drop the cached slug set so the next reader re-fetches. Called from every\n * schema-mutation path (`invalidateUrlPatternCache`, `SchemaRegistry`\n * create/delete). Other isolates converge through bounded revalidation.\n */\nexport function resetRegisteredCollectionsCache(): void {\n\tinvalidateSingleFlightCache(holder.cache);\n\tholder.fetchedAt = 0;\n}\n\n/**\n * Note that a query hit a missing `ec_*` table despite the slug filter: the\n * cached set is stale (the collection was deleted on another isolate) or the\n * registry has drifted from the physical schema. Drops the cached set at most\n * once per revalidation window, so the delete case converges like the create\n * case while genuine drift costs one slug re-fetch per window instead of one\n * per render.\n */\nexport function noteStaleRegisteredCollections(): void {\n\tif (Date.now() - holder.fetchedAt > revalidateWindowMs) {\n\t\tresetRegisteredCollectionsCache();\n\t}\n}\n\n/**\n * Test/internal helper: reset the cache and restore the production\n * revalidation window.\n */\nexport function resetRegisteredCollectionsCacheForTests(): void {\n\tresetRegisteredCollectionsCache();\n\trevalidateWindowMs = REVALIDATE_WINDOW_MS;\n}\n\n/**\n * Test-only: shorten the revalidation window so the cross-isolate refresh\n * path can be exercised without waiting out the production window.\n *\n * @internal\n */\nexport function setRegisteredCollectionsRevalidateWindowForTests(ms: number): void {\n\trevalidateWindowMs = ms;\n}\n"],"mappings":";;;;;;AAyDA,MAAM,aAAa,OAAO,IAAI,4BAA4B;AAC1D,MAAM,IAAI;AACV,MAAM,SAEJ,EAAE,sBACI;CACN,MAAM,IAAiB;EAAE,OAAO,yBAAyB;EAAE,WAAW;EAAG;AACzE,GAAE,cAAc;AAChB,QAAO;IACJ;AAEL,MAAM,uBAAuB;AAC7B,IAAI,qBAAqB;AAEzB,eAAe,WAAW,IAA4C;CACrE,MAAM,OAAO,MAAM,GAAG,WAAW,sBAAsB,CAAC,OAAO,OAAO,CAAC,SAAS;AAChF,QAAO,IAAI,IAAI,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC;;AAG5C,SAAS,UAAU,IAA4C;AAC9D,QAAO,mBACN,OAAO,OACP,YAAY;EACX,MAAM,QAAQ,MAAM,WAAW,GAAG;AAClC,SAAO,YAAY,KAAK,KAAK;AAC7B,SAAO;IAER;EAAE,SAAS,YAAY,YAAY,QAAQ;EAAE,gBAAgB;EAAQ,CACrE;;;;;;;;;AAUF,eAAsB,8BACrB,IACA,aACoB;AACpB,KAAI,YAAY,WAAW,EAAG,QAAO,EAAE;AACvC,KAAI,mBAAmB,EAAE,iBAAiB,MAAM;EAC/C,MAAM,QAAQ,MAAM,cAAc,0BAA0B,WAAW,GAAG,CAAC;AAC3E,SAAO,YAAY,QAAQ,SAAS,MAAM,IAAI,KAAK,CAAC;;CAErD,IAAI,QAAQ,MAAM,UAAU,GAAG;CAC/B,IAAI,UAAU,YAAY,QAAQ,SAAS,MAAM,IAAI,KAAK,CAAC;AAC3D,KAAI,QAAQ,SAAS,YAAY,UAAU,KAAK,KAAK,GAAG,OAAO,YAAY,oBAAoB;AAE9F,SAAO,YAAY,KAAK,KAAK;AAC7B,8BAA4B,OAAO,MAAM;AACzC,UAAQ,MAAM,UAAU,GAAG;AAC3B,YAAU,YAAY,QAAQ,SAAS,MAAM,IAAI,KAAK,CAAC;;AAExD,QAAO;;;;;;;AAQR,SAAgB,2BAA2B,OAAgC;CAC1E,MAAM,EAAE,UAAU;AAClB,OAAM,QAAQ,IAAI,IAAI,MAAM;AAC5B,OAAM,WAAW;AACjB,OAAM,eAAe,MAAM;AAC3B,QAAO,YAAY,KAAK,KAAK;;;;;;;AAQ9B,SAAgB,kCAAwC;AACvD,6BAA4B,OAAO,MAAM;AACzC,QAAO,YAAY;;;;;;;;;;AAWpB,SAAgB,iCAAuC;AACtD,KAAI,KAAK,KAAK,GAAG,OAAO,YAAY,mBACnC,kCAAiC"}