emdash 0.0.0-b → 0.0.2

package/dist/client/cf-access.d.mts

@@ -0,0 +1,60 @@
+import { t as Interceptor } from "../transport-BFGblqwG.mjs";
+
+//#region src/client/cf-access.d.ts
+/**
+ * Parse headers from the EMDASH_HEADERS env var.
+ * Format: newline-separated "Name: Value" pairs.
+ * Blank lines and malformed entries are silently skipped.
+ */
+declare function parseHeadersFromEnv(): Record<string, string>;
+/**
+ * Parse an array of "Name: Value" strings into a headers record.
+ * Malformed entries are silently skipped. Later values override earlier ones.
+ */
+declare function parseHeaderStrings(headers: string[]): Record<string, string>;
+/**
+ * Collect all --header flag values from process.argv.
+ *
+ * citty doesn't support repeatable string args, so we parse argv directly.
+ * Handles both `--header "Name: Value"` and `--header="Name: Value"`.
+ */
+declare function parseHeadersFromArgv(): string[];
+/**
+ * Resolve custom headers from all sources.
+ * Priority: env var < CLI flags (later wins).
+ */
+declare function resolveCustomHeaders(): Record<string, string>;
+/**
+ * Creates a transport interceptor that injects custom headers on every request.
+ */
+declare function customHeadersInterceptor(headers: Record<string, string>): Interceptor;
+/**
+ * Creates a fetch wrapper that injects custom headers.
+ * Used by the login command for raw fetch calls before the client is created.
+ */
+declare function createHeaderAwareFetch(headers: Record<string, string>): typeof fetch;
+/**
+ * Check whether a response (fetched with `redirect: "manual"`) is a
+ * Cloudflare Access redirect.
+ */
+declare function isAccessRedirect(response: Response): boolean;
+/**
+ * Try to get a cached Cloudflare Access JWT via `cloudflared access token`.
+ *
+ * Returns the JWT string if cloudflared is installed and has a cached token.
+ * Returns null if cloudflared is not installed or has no cached token.
+ */
+declare function getCachedAccessToken(appUrl: string): Promise<string | null>;
+/**
+ * Launch `cloudflared access login` for interactive browser-based auth.
+ *
+ * This opens a browser window for the user to authenticate with their IdP.
+ * On success, cloudflared caches the JWT locally. Call `getCachedAccessToken`
+ * afterwards to retrieve it.
+ *
+ * Returns true if the command succeeded, false otherwise.
+ */
+declare function runCloudflaredLogin(appUrl: string): Promise<boolean>;
+//#endregion
+export { createHeaderAwareFetch, customHeadersInterceptor, getCachedAccessToken, isAccessRedirect, parseHeaderStrings, parseHeadersFromArgv, parseHeadersFromEnv, resolveCustomHeaders, runCloudflaredLogin };
+//# sourceMappingURL=cf-access.d.mts.map

package/dist/client/cf-access.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-access.d.mts","names":[],"sources":["../../src/client/cf-access.ts"],"mappings":";;;;;;;;iBAiDgB,mBAAA,CAAA,GAAuB,MAAA;;AAgFvC;;;iBAtEgB,kBAAA,CAAmB,OAAA,aAAoB,MAAA;;;;;;AA6FvD;iBA5EgB,oBAAA,CAAA;;;;AAwFhB;iBAhEgB,oBAAA,CAAA,GAAwB,MAAA;;;;iBASxB,wBAAA,CAAyB,OAAA,EAAS,MAAA,mBAAyB,WAAA;;;;;iBAoB3D,sBAAA,CAAuB,OAAA,EAAS,MAAA,0BAAgC,KAAA;;;;;iBAuBhE,gBAAA,CAAiB,QAAA,EAAU,QAAA;;;;;;;iBAYrB,oBAAA,CAAqB,MAAA,WAAiB,OAAA;;;;;;;;;;iBAoBtC,mBAAA,CAAoB,MAAA,WAAiB,OAAA"}

package/dist/client/cf-access.mjs

@@ -0,0 +1,179 @@
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+
+//#region src/client/cf-access.ts
+/**
+* Custom headers + Cloudflare Access support for the EmDash client.
+*
+* Two concerns live here:
+*
+* 1. **Custom headers** — injects user-provided headers on every request.
+*    Used for reverse proxy auth (CF Access service tokens, Tailscale, etc.)
+*    Headers come from three sources (all merged, later wins):
+*    - EMDASH_HEADERS env var (newline-separated "Name: Value" pairs)
+*    - --header CLI flags (repeatable, "Name: Value" format)
+*    - Stored credentials (persisted during `emdash login --header`)
+*
+* 2. **Cloudflare Access detection** — when the login command hits an Access
+*    redirect, it tries `cloudflared access token` for a cached JWT, or
+*    prompts the user to run `cloudflared access login <url>`.
+*
+* @example CF Access service token:
+*   emdash login --url https://cms.example.com \
+*     --header "CF-Access-Client-Id: xxx" \
+*     --header "CF-Access-Client-Secret: yyy"
+*
+* @example Via env var:
+*   EMDASH_HEADERS="CF-Access-Client-Id: xxx\nCF-Access-Client-Secret: yyy"
+*/
+const execFileAsync = promisify(execFile);
+/**
+* Parse a single "Name: Value" header string. Returns null if malformed.
+*/
+function parseHeaderLine(line) {
+	const idx = line.indexOf(":");
+	if (idx === -1) return null;
+	const name = line.slice(0, idx).trim();
+	const value = line.slice(idx + 1).trim();
+	if (!name) return null;
+	return [name, value];
+}
+/**
+* Parse headers from the EMDASH_HEADERS env var.
+* Format: newline-separated "Name: Value" pairs.
+* Blank lines and malformed entries are silently skipped.
+*/
+function parseHeadersFromEnv() {
+	const raw = process.env["EMDASH_HEADERS"];
+	if (!raw) return {};
+	return parseHeaderStrings(raw.split("\n"));
+}
+/**
+* Parse an array of "Name: Value" strings into a headers record.
+* Malformed entries are silently skipped. Later values override earlier ones.
+*/
+function parseHeaderStrings(headers) {
+	const result = {};
+	for (const h of headers) {
+		const parsed = parseHeaderLine(h);
+		if (parsed) result[parsed[0]] = parsed[1];
+	}
+	return result;
+}
+/**
+* Collect all --header flag values from process.argv.
+*
+* citty doesn't support repeatable string args, so we parse argv directly.
+* Handles both `--header "Name: Value"` and `--header="Name: Value"`.
+*/
+function parseHeadersFromArgv() {
+	const headers = [];
+	const argv = process.argv;
+	for (let i = 0; i < argv.length; i++) {
+		const arg = argv[i];
+		if (arg === "--header" || arg === "-H") {
+			const next = argv[i + 1];
+			if (next && !next.startsWith("-")) {
+				headers.push(next);
+				i++;
+			}
+		} else if (arg.startsWith("--header=")) headers.push(arg.slice(9));
+		else if (arg.startsWith("-H=")) headers.push(arg.slice(3));
+	}
+	return headers;
+}
+/**
+* Resolve custom headers from all sources.
+* Priority: env var < CLI flags (later wins).
+*/
+function resolveCustomHeaders() {
+	const envHeaders = parseHeadersFromEnv();
+	const cliHeaders = parseHeaderStrings(parseHeadersFromArgv());
+	return {
+		...envHeaders,
+		...cliHeaders
+	};
+}
+/**
+* Creates a transport interceptor that injects custom headers on every request.
+*/
+function customHeadersInterceptor(headers) {
+	const entries = Object.entries(headers);
+	if (entries.length === 0) return (request, next) => next(request);
+	return (request, next) => {
+		const h = new Headers(request.headers);
+		for (const [name, value] of entries) h.set(name, value);
+		return next(new Request(request, { headers: h }));
+	};
+}
+/**
+* Creates a fetch wrapper that injects custom headers.
+* Used by the login command for raw fetch calls before the client is created.
+*/
+function createHeaderAwareFetch(headers) {
+	if (Object.keys(headers).length === 0) return globalThis.fetch.bind(globalThis);
+	return (input, init) => {
+		const h = new Headers(init?.headers);
+		for (const [name, value] of Object.entries(headers)) h.set(name, value);
+		return globalThis.fetch(input, {
+			...init,
+			headers: h
+		});
+	};
+}
+const ACCESS_LOGIN_PATTERN = /cloudflareaccess\.com\/cdn-cgi\/access\/login/;
+/**
+* Check whether a response (fetched with `redirect: "manual"`) is a
+* Cloudflare Access redirect.
+*/
+function isAccessRedirect(response) {
+	if (response.status !== 301 && response.status !== 302) return false;
+	const location = response.headers.get("location") ?? "";
+	return ACCESS_LOGIN_PATTERN.test(location);
+}
+/**
+* Try to get a cached Cloudflare Access JWT via `cloudflared access token`.
+*
+* Returns the JWT string if cloudflared is installed and has a cached token.
+* Returns null if cloudflared is not installed or has no cached token.
+*/
+async function getCachedAccessToken(appUrl) {
+	const origin = new URL(appUrl).origin;
+	try {
+		const { stdout } = await execFileAsync("cloudflared", [
+			"access",
+			"token",
+			"-app",
+			origin
+		]);
+		return stdout.trim() || null;
+	} catch {
+		return null;
+	}
+}
+/**
+* Launch `cloudflared access login` for interactive browser-based auth.
+*
+* This opens a browser window for the user to authenticate with their IdP.
+* On success, cloudflared caches the JWT locally. Call `getCachedAccessToken`
+* afterwards to retrieve it.
+*
+* Returns true if the command succeeded, false otherwise.
+*/
+async function runCloudflaredLogin(appUrl) {
+	const origin = new URL(appUrl).origin;
+	try {
+		await execFileAsync("cloudflared", [
+			"access",
+			"login",
+			origin
+		]);
+		return true;
+	} catch {
+		return false;
+	}
+}
+
+//#endregion
+export { createHeaderAwareFetch, customHeadersInterceptor, getCachedAccessToken, isAccessRedirect, parseHeaderStrings, parseHeadersFromArgv, parseHeadersFromEnv, resolveCustomHeaders, runCloudflaredLogin };
+//# sourceMappingURL=cf-access.mjs.map

package/dist/client/cf-access.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"cf-access.mjs","names":[],"sources":["../../src/client/cf-access.ts"],"sourcesContent":["/**\n * Custom headers + Cloudflare Access support for the EmDash client.\n *\n * Two concerns live here:\n *\n * 1. **Custom headers** — injects user-provided headers on every request.\n *    Used for reverse proxy auth (CF Access service tokens, Tailscale, etc.)\n *    Headers come from three sources (all merged, later wins):\n *    - EMDASH_HEADERS env var (newline-separated \"Name: Value\" pairs)\n *    - --header CLI flags (repeatable, \"Name: Value\" format)\n *    - Stored credentials (persisted during `emdash login --header`)\n *\n * 2. **Cloudflare Access detection** — when the login command hits an Access\n *    redirect, it tries `cloudflared access token` for a cached JWT, or\n *    prompts the user to run `cloudflared access login <url>`.\n *\n * @example CF Access service token:\n *   emdash login --url https://cms.example.com \\\n *     --header \"CF-Access-Client-Id: xxx\" \\\n *     --header \"CF-Access-Client-Secret: yyy\"\n *\n * @example Via env var:\n *   EMDASH_HEADERS=\"CF-Access-Client-Id: xxx\\nCF-Access-Client-Secret: yyy\"\n */\n\nimport { execFile } from \"node:child_process\";\nimport { promisify } from \"node:util\";\n\nimport type { Interceptor } from \"./transport.js\";\n\nconst execFileAsync = promisify(execFile);\n\n/**\n * Parse a single \"Name: Value\" header string. Returns null if malformed.\n */\nfunction parseHeaderLine(line: string): [string, string] | null {\n\tconst idx = line.indexOf(\":\");\n\tif (idx === -1) return null;\n\tconst name = line.slice(0, idx).trim();\n\tconst value = line.slice(idx + 1).trim();\n\tif (!name) return null;\n\treturn [name, value];\n}\n\n/**\n * Parse headers from the EMDASH_HEADERS env var.\n * Format: newline-separated \"Name: Value\" pairs.\n * Blank lines and malformed entries are silently skipped.\n */\nexport function parseHeadersFromEnv(): Record<string, string> {\n\tconst raw = process.env[\"EMDASH_HEADERS\"];\n\tif (!raw) return {};\n\treturn parseHeaderStrings(raw.split(\"\\n\"));\n}\n\n/**\n * Parse an array of \"Name: Value\" strings into a headers record.\n * Malformed entries are silently skipped. Later values override earlier ones.\n */\nexport function parseHeaderStrings(headers: string[]): Record<string, string> {\n\tconst result: Record<string, string> = {};\n\tfor (const h of headers) {\n\t\tconst parsed = parseHeaderLine(h);\n\t\tif (parsed) {\n\t\t\tresult[parsed[0]] = parsed[1];\n\t\t}\n\t}\n\treturn result;\n}\n\n/**\n * Collect all --header flag values from process.argv.\n *\n * citty doesn't support repeatable string args, so we parse argv directly.\n * Handles both `--header \"Name: Value\"` and `--header=\"Name: Value\"`.\n */\nexport function parseHeadersFromArgv(): string[] {\n\tconst headers: string[] = [];\n\tconst argv = process.argv;\n\tfor (let i = 0; i < argv.length; i++) {\n\t\tconst arg = argv[i];\n\t\tif (arg === \"--header\" || arg === \"-H\") {\n\t\t\tconst next = argv[i + 1];\n\t\t\tif (next && !next.startsWith(\"-\")) {\n\t\t\t\theaders.push(next);\n\t\t\t\ti++; // skip value\n\t\t\t}\n\t\t} else if (arg.startsWith(\"--header=\")) {\n\t\t\theaders.push(arg.slice(\"--header=\".length));\n\t\t} else if (arg.startsWith(\"-H=\")) {\n\t\t\theaders.push(arg.slice(\"-H=\".length));\n\t\t}\n\t}\n\treturn headers;\n}\n\n/**\n * Resolve custom headers from all sources.\n * Priority: env var < CLI flags (later wins).\n */\nexport function resolveCustomHeaders(): Record<string, string> {\n\tconst envHeaders = parseHeadersFromEnv();\n\tconst cliHeaders = parseHeaderStrings(parseHeadersFromArgv());\n\treturn { ...envHeaders, ...cliHeaders };\n}\n\n/**\n * Creates a transport interceptor that injects custom headers on every request.\n */\nexport function customHeadersInterceptor(headers: Record<string, string>): Interceptor {\n\tconst entries = Object.entries(headers);\n\tif (entries.length === 0) {\n\t\t// No-op interceptor\n\t\treturn (request, next) => next(request);\n\t}\n\n\treturn (request, next) => {\n\t\tconst h = new Headers(request.headers);\n\t\tfor (const [name, value] of entries) {\n\t\t\th.set(name, value);\n\t\t}\n\t\treturn next(new Request(request, { headers: h }));\n\t};\n}\n\n/**\n * Creates a fetch wrapper that injects custom headers.\n * Used by the login command for raw fetch calls before the client is created.\n */\nexport function createHeaderAwareFetch(headers: Record<string, string>): typeof fetch {\n\tif (Object.keys(headers).length === 0) {\n\t\treturn globalThis.fetch.bind(globalThis);\n\t}\n\treturn (input: RequestInfo | URL, init?: RequestInit) => {\n\t\tconst h = new Headers(init?.headers);\n\t\tfor (const [name, value] of Object.entries(headers)) {\n\t\t\th.set(name, value);\n\t\t}\n\t\treturn globalThis.fetch(input, { ...init, headers: h });\n\t};\n}\n\n// ---------------------------------------------------------------------------\n// Cloudflare Access detection\n// ---------------------------------------------------------------------------\n\nconst ACCESS_LOGIN_PATTERN = /cloudflareaccess\\.com\\/cdn-cgi\\/access\\/login/;\n\n/**\n * Check whether a response (fetched with `redirect: \"manual\"`) is a\n * Cloudflare Access redirect.\n */\nexport function isAccessRedirect(response: Response): boolean {\n\tif (response.status !== 301 && response.status !== 302) return false;\n\tconst location = response.headers.get(\"location\") ?? \"\";\n\treturn ACCESS_LOGIN_PATTERN.test(location);\n}\n\n/**\n * Try to get a cached Cloudflare Access JWT via `cloudflared access token`.\n *\n * Returns the JWT string if cloudflared is installed and has a cached token.\n * Returns null if cloudflared is not installed or has no cached token.\n */\nexport async function getCachedAccessToken(appUrl: string): Promise<string | null> {\n\tconst origin = new URL(appUrl).origin;\n\ttry {\n\t\tconst { stdout } = await execFileAsync(\"cloudflared\", [\"access\", \"token\", \"-app\", origin]);\n\t\tconst token = stdout.trim();\n\t\treturn token || null;\n\t} catch {\n\t\treturn null;\n\t}\n}\n\n/**\n * Launch `cloudflared access login` for interactive browser-based auth.\n *\n * This opens a browser window for the user to authenticate with their IdP.\n * On success, cloudflared caches the JWT locally. Call `getCachedAccessToken`\n * afterwards to retrieve it.\n *\n * Returns true if the command succeeded, false otherwise.\n */\nexport async function runCloudflaredLogin(appUrl: string): Promise<boolean> {\n\tconst origin = new URL(appUrl).origin;\n\ttry {\n\t\tawait execFileAsync(\"cloudflared\", [\"access\", \"login\", origin]);\n\t\treturn true;\n\t} catch {\n\t\treturn false;\n\t}\n}\n"],"mappings":"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"}

package/dist/client/index.d.mts

@@ -0,0 +1,398 @@
+import { a as tokenInterceptor, i as devBypassInterceptor, n as createTransport, r as csrfInterceptor, t as Interceptor } from "../transport-BFGblqwG.mjs";
+
+//#region src/client/portable-text.d.ts
+/**
+ * Portable Text <-> Markdown conversion layer.
+ *
+ * Three tiers of block handling:
+ *   Tier 1: Standard PT blocks <-> standard Markdown (headings, paragraphs, lists, etc.)
+ *   Tier 2: EmDash custom blocks <-> Markdown directives (future)
+ *   Tier 3: Unknown blocks <-> opaque HTML comment fences (preserved, not editable)
+ */
+/** Minimal Portable Text block shape */
+interface PortableTextBlock {
+  _type: string;
+  _key?: string;
+  style?: string;
+  level?: number;
+  listItem?: string;
+  markDefs?: MarkDef[];
+  children?: PortableTextSpan[];
+  [key: string]: unknown;
+}
+interface PortableTextSpan {
+  _type: string;
+  _key?: string;
+  text?: string;
+  marks?: string[];
+  [key: string]: unknown;
+}
+interface MarkDef {
+  _key: string;
+  _type: string;
+  href?: string;
+  [key: string]: unknown;
+}
+/**
+ * Convert Portable Text blocks to Markdown.
+ * Unknown block types are serialized as opaque fences.
+ */
+declare function portableTextToMarkdown(blocks: PortableTextBlock[]): string;
+/**
+ * Convert Markdown to Portable Text blocks.
+ * Opaque fences (<!--ec:block ... -->) are deserialized and spliced back in.
+ */
+declare function markdownToPortableText(markdown: string): PortableTextBlock[];
+//#endregion
+//#region src/client/index.d.ts
+interface EmDashClientOptions {
+  /** Base URL of the EmDash instance */
+  baseUrl: string;
+  /** API token (ec_pat_...) or OAuth token (ec_oat_...) */
+  token?: string;
+  /** OAuth refresh token for auto-refresh on 401 */
+  refreshToken?: string;
+  /** Called when a token is refreshed (for persisting new access token) */
+  onTokenRefresh?: (accessToken: string, expiresIn: number) => void;
+  /** Use dev-bypass authentication (localhost only) */
+  devBypass?: boolean;
+  /** Additional request interceptors */
+  interceptors?: Interceptor[];
+}
+/** Standard API error shape */
+interface ApiError {
+  code: string;
+  message: string;
+  details?: Record<string, unknown>;
+}
+/** Standard API response wrapper */
+interface ClientResponse<T> {
+  success: true;
+  data: T;
+}
+/** Paginated list response */
+interface ListResult<T> {
+  items: T[];
+  nextCursor?: string;
+}
+/** Content item as returned by the API */
+interface ContentItem {
+  id: string;
+  type: string;
+  slug: string | null;
+  status: string;
+  data: Record<string, unknown>;
+  authorId: string | null;
+  createdAt: string;
+  updatedAt: string;
+  publishedAt: string | null;
+  scheduledAt: string | null;
+  liveRevisionId: string | null;
+  draftRevisionId: string | null;
+  locale: string | null;
+  translationGroup: string | null;
+  _rev?: string;
+}
+/** Collection metadata */
+interface Collection {
+  slug: string;
+  label: string;
+  labelSingular: string;
+  description?: string;
+  icon?: string;
+  supports: string[];
+}
+/** Collection with fields */
+interface CollectionWithFields extends Collection {
+  fields: Field[];
+}
+/** Field metadata */
+interface Field {
+  slug: string;
+  label: string;
+  type: string;
+  required: boolean;
+  unique: boolean;
+  defaultValue?: unknown;
+  validation?: unknown;
+  widget?: string;
+  options?: unknown;
+  sortOrder?: number;
+}
+/** Media item */
+interface MediaItem {
+  id: string;
+  filename: string;
+  key: string;
+  mimeType: string;
+  size: number;
+  width?: number;
+  height?: number;
+  alt?: string;
+  caption?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+/** Search result */
+interface SearchResult {
+  id: string;
+  collection: string;
+  title: string;
+  excerpt?: string;
+  score: number;
+}
+/** Taxonomy */
+interface Taxonomy {
+  name: string;
+  label: string;
+  hierarchical: boolean;
+}
+/** Taxonomy term */
+interface Term {
+  id: string;
+  slug: string;
+  label: string;
+  parentId?: string | null;
+  description?: string;
+  count?: number;
+}
+/** Menu */
+interface Menu {
+  name: string;
+  label: string;
+}
+/** Menu with items */
+interface MenuWithItems extends Menu {
+  items: MenuItem[];
+}
+/** Menu item */
+interface MenuItem {
+  id: string;
+  type: string;
+  label: string;
+  customUrl?: string;
+  referenceCollection?: string;
+  referenceId?: string;
+  target?: string;
+  parentId?: string | null;
+  sortOrder: number;
+}
+/** Full schema export (returned by /api/schema) */
+interface SchemaExport {
+  collections: Array<{
+    slug: string;
+    label: string;
+    labelSingular: string;
+    description?: string;
+    icon?: string;
+    supports: string[];
+    fields: Array<{
+      slug: string;
+      label: string;
+      type: string;
+      required: boolean;
+      unique: boolean;
+      defaultValue?: unknown;
+      validation?: unknown;
+      widget?: string;
+      options?: unknown;
+    }>;
+  }>;
+  version: string;
+}
+/** Manifest — full schema + field descriptors */
+interface Manifest {
+  version: string;
+  hash: string;
+  collections: Record<string, {
+    label: string;
+    labelSingular: string;
+    supports: string[];
+    fields: Record<string, {
+      kind: string;
+      label?: string;
+      required?: boolean;
+    }>;
+  }>;
+}
+declare class EmDashApiError extends Error {
+  readonly status: number;
+  readonly code: string;
+  readonly details?: Record<string, unknown> | undefined;
+  constructor(status: number, code: string, message: string, details?: Record<string, unknown> | undefined);
+}
+declare class EmDashClientError extends Error {
+  constructor(message: string);
+}
+declare class EmDashClient {
+  private readonly baseUrl;
+  private readonly transport;
+  /** Cached field schemas per collection for PT conversion */
+  private fieldSchemaCache;
+  constructor(options: EmDashClientOptions);
+  /** List all collections */
+  collections(): Promise<Collection[]>;
+  /** Get a single collection with its fields */
+  collection(slug: string): Promise<CollectionWithFields>;
+  /** Create a collection */
+  createCollection(input: {
+    slug: string;
+    label: string;
+    labelSingular?: string;
+    description?: string;
+    icon?: string;
+    supports?: string[];
+  }): Promise<Collection>;
+  /** Delete a collection */
+  deleteCollection(slug: string): Promise<void>;
+  /** Create a field on a collection */
+  createField(collection: string, input: {
+    slug: string;
+    type: string;
+    label: string;
+    required?: boolean;
+    unique?: boolean;
+    defaultValue?: unknown;
+    validation?: unknown;
+    widget?: string;
+    options?: unknown;
+    sortOrder?: number;
+  }): Promise<Field>;
+  /** Delete a field from a collection */
+  deleteField(collection: string, fieldSlug: string): Promise<void>;
+  /** Get full manifest (schema + field descriptors + features) */
+  manifest(): Promise<Manifest>;
+  /** Export full schema as JSON (used by `emdash types`) */
+  schemaExport(): Promise<SchemaExport>;
+  /** Export schema as TypeScript type definitions (used by `emdash types`) */
+  schemaTypes(): Promise<string>;
+  /** List content in a collection */
+  list(collection: string, options?: {
+    status?: string;
+    limit?: number;
+    cursor?: string;
+    orderBy?: string;
+    order?: "asc" | "desc";
+    locale?: string;
+  }): Promise<ListResult<ContentItem>>;
+  /** Async iterator that auto-follows cursors */
+  listAll(collection: string, options?: {
+    status?: string;
+    limit?: number;
+    orderBy?: string;
+    order?: "asc" | "desc";
+    locale?: string;
+  }): AsyncGenerator<ContentItem>;
+  /**
+   * Get a single content item. Returns the item with a `_rev` token
+   * that can be passed to update() for optimistic concurrency.
+   */
+  get(collection: string, id: string, options?: {
+    raw?: boolean;
+    locale?: string;
+  }): Promise<ContentItem>;
+  /** Create a new content item */
+  create(collection: string, input: {
+    data: Record<string, unknown>;
+    slug?: string;
+    status?: string;
+    locale?: string;
+    translationOf?: string;
+  }): Promise<ContentItem>;
+  /**
+   * Update a content item. Pass `_rev` from a prior get() for optimistic
+   * concurrency — the server returns 409 if the item has changed.
+   * Omit `_rev` for a blind write (no conflict detection).
+   */
+  update(collection: string, id: string, input: {
+    data?: Record<string, unknown>;
+    slug?: string;
+    status?: string;
+    _rev?: string;
+  }): Promise<ContentItem>;
+  /** Delete (soft) a content item */
+  delete(collection: string, id: string): Promise<void>;
+  /** Publish a content item */
+  publish(collection: string, id: string): Promise<void>;
+  /** Unpublish a content item */
+  unpublish(collection: string, id: string): Promise<void>;
+  /** Schedule publishing */
+  schedule(collection: string, id: string, options: {
+    at: string;
+  }): Promise<void>;
+  /** Restore a trashed content item */
+  restore(collection: string, id: string): Promise<void>;
+  /** Compare live and draft revisions */
+  compare(collection: string, id: string): Promise<{
+    hasChanges: boolean;
+    live: Record<string, unknown> | null;
+    draft: Record<string, unknown> | null;
+  }>;
+  /** Discard draft revision, reverting to the published version */
+  discardDraft(collection: string, id: string): Promise<void>;
+  /**
+   * Get all translations of a content item.
+   * Returns the translation group ID and a summary of each locale version.
+   */
+  translations(collection: string, id: string): Promise<{
+    translationGroup: string;
+    translations: Array<{
+      id: string;
+      locale: string | null;
+      slug: string | null;
+      status: string;
+      updatedAt: string;
+    }>;
+  }>;
+  /** List media items */
+  mediaList(options?: {
+    mimeType?: string;
+    limit?: number;
+    cursor?: string;
+  }): Promise<ListResult<MediaItem>>;
+  /** Get a single media item */
+  mediaGet(id: string): Promise<MediaItem>;
+  /** Upload a media file */
+  mediaUpload(file: Uint8Array | Blob, filename: string, options?: {
+    alt?: string;
+    caption?: string;
+    contentType?: string;
+  }): Promise<MediaItem>;
+  /** Delete a media item */
+  mediaDelete(id: string): Promise<void>;
+  /** Full-text search */
+  search(query: string, options?: {
+    collection?: string;
+    locale?: string;
+    limit?: number;
+  }): Promise<SearchResult[]>;
+  /** List taxonomies */
+  taxonomies(): Promise<Taxonomy[]>;
+  /** List terms in a taxonomy */
+  terms(taxonomy: string, options?: {
+    limit?: number;
+    cursor?: string;
+  }): Promise<ListResult<Term>>;
+  /** Create a taxonomy term */
+  createTerm(taxonomy: string, input: {
+    slug: string;
+    label: string;
+    parentId?: string;
+    description?: string;
+  }): Promise<Term>;
+  /** List menus */
+  menus(): Promise<Menu[]>;
+  /** Get a menu with its items */
+  menu(name: string): Promise<MenuWithItems>;
+  /** Make a typed JSON request to the API */
+  private request;
+  /** Make a raw request — caller handles response */
+  private requestRaw;
+  /** Assert a response is OK, throw typed error if not */
+  private assertOk;
+  /** Get cached field schemas for a collection, fetching if needed */
+  private getFieldSchemas;
+}
+//#endregion
+export { ApiError, ClientResponse, Collection, CollectionWithFields, ContentItem, EmDashApiError, EmDashClient, EmDashClientError, EmDashClientOptions, Field, type Interceptor, ListResult, Manifest, MediaItem, Menu, MenuItem, MenuWithItems, type PortableTextBlock, SchemaExport, SearchResult, Taxonomy, Term, createTransport, csrfInterceptor, devBypassInterceptor, markdownToPortableText, portableTextToMarkdown, tokenInterceptor };
+//# sourceMappingURL=index.d.mts.map

package/dist/client/index.d.mts.map

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