emdash 1.0.1 → 1.1.0

package/dist/parse-QVS0t5oR.d.mts

@@ -0,0 +1,172 @@
+import { w as BlockType } from "./types-CLTQ9b_r.mjs";
+import { i as ContentItem } from "./types-LtS0SM4F.mjs";
+import { z } from "zod";
+
+//#region src/api/types.d.ts
+/**
+ * List response with cursor pagination
+ */
+interface ListResponse<T> {
+  items: T[];
+  nextCursor?: string;
+  /**
+   * Total number of rows matching the filters, ignoring pagination. Used
+   * by the admin to render a stable pagination denominator. Optional so
+   * callers that don't surface a row count don't pay for the extra query.
+   */
+  total?: number;
+}
+/**
+ * Content API responses
+ */
+interface ContentListResponse extends ListResponse<ContentItem> {}
+interface ContentResponse {
+  item: ContentItem;
+  /** Opaque revision token for optimistic concurrency */
+  _rev?: string;
+}
+/**
+ * Manifest API response
+ */
+interface ManifestResponse {
+  version: string;
+  hash: string;
+  collections: ManifestCollectionMap;
+  plugins: Record<string, {
+    adminPages?: Array<{
+      path: string;
+      component: string;
+    }>;
+    widgets?: string[];
+  }>;
+}
+type ManifestCollectionMap = Record<string, ManifestCollectionDescriptor>;
+interface ManifestCollectionDescriptor {
+  label: string;
+  labelSingular: string;
+  supports: string[];
+  hasSeo: boolean;
+  urlPattern?: string;
+  routable?: boolean;
+  titleField?: string;
+  dateField?: string;
+  hidden?: boolean;
+  /** Phosphor icon name for the admin sidebar entry */
+  icon?: string;
+  /** Admin sidebar folder shared with other collections of the same group */
+  group?: string;
+  /** `false` omits the dashboard's "new entry" quick action */
+  quickCreate?: boolean;
+  listColumns?: string[];
+  fields: Record<string, ManifestFieldDescriptor>;
+}
+interface ManifestFieldDescriptor extends FieldDescriptor {
+  id?: string;
+  widget?: string;
+  validation?: Record<string, unknown>;
+  unsupportedType?: {
+    type: string;
+    path: string;
+  };
+  blockTypes?: BlockType[];
+  blockTypeFingerprint?: string;
+}
+interface FieldDescriptor {
+  kind: string;
+  label?: string;
+  required?: boolean;
+  translatable?: boolean;
+  /**
+   * For `select` / `multiSelect`: the list of enum choices.
+   * For `json` fields driven by a plugin `widget`: arbitrary widget config.
+   */
+  options?: Array<{
+    value: string;
+    label: string;
+  }> | Record<string, unknown>;
+}
+/**
+ * Discriminated union for handler results.
+ *
+ * Handlers return `ApiResult<T>` -- either `{ success: true, data: T }` or
+ * `{ success: false, error: { code, message } }`. The `success` literal
+ * enables TypeScript narrowing on `.data`.
+ *
+ * The generic `E` parameter defaults to `ErrorCode` but can be narrowed to
+ * `OAuthErrorCode` for OAuth token-endpoint handlers.
+ *
+ * Use `unwrapResult()` from `error.ts` to convert to an HTTP Response.
+ */
+type ApiResult<T, E extends string = string> = {
+  success: true;
+  data: T;
+} | {
+  success: false;
+  error: {
+    code: E;
+    message: string;
+    details?: Record<string, unknown>;
+  };
+};
+/**
+ * API request context
+ */
+interface ApiContext {
+  userId?: string;
+  userRole?: string;
+}
+//#endregion
+//#region src/api/error.d.ts
+/**
+ * Create a standardized error response.
+ *
+ * Always returns `{ success: false, error: { code, message } }` with correct
+ * Content-Type. Use this for all error responses in API routes.
+ */
+declare function apiError(code: string, message: string, status: number, details?: Record<string, unknown>): Response;
+/**
+ * Create a standardized success response.
+ *
+ * Always returns `{ success: true, data: T }` with correct status code.
+ * Use this for all success responses in API routes.
+ */
+declare function apiSuccess<T>(data: T, status?: number): Response;
+/**
+ * Handle an unknown error in a catch block.
+ *
+ * - Logs the full error server-side
+ * - Returns a generic message to the client (never leaks error.message)
+ * - Use `fallbackMessage` for the public-facing message
+ * - Use `fallbackCode` for the error code
+ */
+declare function handleError(error: unknown, fallbackMessage: string, fallbackCode: string): Response;
+//#endregion
+//#region src/api/parse.d.ts
+/**
+ * Result of parsing: either the validated data or an error Response.
+ * Routes should check `if (result instanceof Response) return result;`
+ */
+type ParseResult<T> = T | Response;
+/**
+ * Parse and validate a JSON request body against a Zod schema.
+ *
+ * Returns the validated data on success, or a 400 Response on failure.
+ * Replaces all `(await request.json()) as T` casts.
+ */
+declare function parseBody<T extends z.ZodType>(request: Request, schema: T): Promise<ParseResult<z.infer<T>>>;
+/**
+ * Parse and validate URL search params against a Zod schema.
+ *
+ * Converts searchParams to a plain object before validation.
+ * Zod coercion handles string -> number/boolean conversion.
+ * Replaces manual `url.searchParams.get()` + `parseInt()` patterns.
+ */
+declare function parseQuery<T extends z.ZodType>(url: URL, schema: T): ParseResult<z.infer<T>>;
+/**
+ * Type guard to check if a ParseResult is an error Response.
+ * Usage: `if (isParseError(result)) return result;`
+ */
+declare function isParseError<T>(result: ParseResult<T>): result is Response;
+//#endregion
+export { ManifestResponse as _, apiError as a, ApiContext as c, ContentResponse as d, FieldDescriptor as f, ManifestFieldDescriptor as g, ManifestCollectionMap as h, parseQuery as i, ApiResult as l, ManifestCollectionDescriptor as m, isParseError as n, apiSuccess as o, ListResponse as p, parseBody as r, handleError as s, ParseResult as t, ContentListResponse as u };
+//# sourceMappingURL=parse-QVS0t5oR.d.mts.map

package/dist/parse-QVS0t5oR.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-QVS0t5oR.d.mts","names":[],"sources":["../src/api/types.ts","../src/api/error.ts","../src/api/parse.ts"],"mappings":";;;;;;AASA;;UAAiB,YAAA;EAChB,KAAA,EAAO,CAAA;EACP,UAAA;EADA;;;;;EAOA,KAAA;AAAA;;;;UAMgB,mBAAA,SAA4B,YAAA,CAAa,WAAA;AAAA,UAEzC,eAAA;EAChB,IAAA,EAAM,WAAA;EAAW;EAEjB,IAAA;AAAA;;;;UAMgB,gBAAA;EAChB,OAAA;EACA,IAAA;EACA,WAAA,EAAa,qBAAA;EACb,OAAA,EAAS,MAAA;IAGP,UAAA,GAAa,KAAA;MAAQ,IAAA;MAAc,SAAA;IAAA;IACnC,OAAA;EAAA;AAAA;AAAA,KAKS,qBAAA,GAAwB,MAAA,SAAe,4BAAA;AAAA,UAElC,4BAAA;EAChB,KAAA;EACA,aAAA;EACA,QAAA;EACA,MAAA;EACA,UAAA;EACA,QAAA;EACA,UAAA;EACA,SAAA;EACA,MAAA;;EAEA,IAAA;EAb8E;EAe9E,KAAA;EAb4C;EAe5C,WAAA;EACA,WAAA;EACA,MAAA,EAAQ,MAAA,SAAe,uBAAA;AAAA;AAAA,UAGP,uBAAA,SAAgC,eAAA;EAChD,EAAA;EACA,MAAA;EACA,UAAA,GAAa,MAAA;EACb,eAAA;IAAoB,IAAA;IAAc,IAAA;EAAA;EAClC,UAAA,GAAa,SAAA;EACb,oBAAA;AAAA;AAAA,UAGgB,eAAA;EAChB,IAAA;EACA,KAAA;EACA,QAAA;EACA,YAAA;EAbgB;;;;EAkBhB,OAAA,GAAU,KAAA;IAAQ,KAAA;IAAe,KAAA;EAAA,KAAmB,MAAA;AAAA;;;;;;;;;;;;;KAezC,SAAA;EACP,OAAA;EAAe,IAAA,EAAM,CAAA;AAAA;EAEvB,OAAA;EACA,KAAA;IAAS,IAAA,EAAM,CAAA;IAAG,OAAA;IAAiB,OAAA,GAAU,MAAA;EAAA;AAAA;;;;UAM/B,UAAA;EAChB,MAAA;EACA,QAAA;AAAA;;;;;;;;;iBCpFe,QAAA,CACf,IAAA,UACA,OAAA,UACA,MAAA,UACA,OAAA,GAAU,MAAA,oBACR,QAAA;;ADZH;;;;;iBC2BgB,UAAA,GAAA,CAAc,IAAA,EAAM,CAAA,EAAG,MAAA,YAAe,QAAA;;;;;;;;;iBAYtC,WAAA,CACf,KAAA,WACA,eAAA,UACA,YAAA,WACE,QAAA;;;;;;;KChDS,WAAA,MAAiB,CAAA,GAAI,QAAA;;;;;AFKjC;;iBEGsB,SAAA,WAAoB,CAAA,CAAE,OAAA,CAAA,CAC3C,OAAA,EAAS,OAAA,EACT,MAAA,EAAQ,CAAA,GACN,OAAA,CAAQ,WAAA,CAAY,CAAA,CAAE,KAAA,CAAM,CAAA;;;;;AFK/B;;;iBEyDgB,UAAA,WAAqB,CAAA,CAAE,OAAA,CAAA,CAAS,GAAA,EAAK,GAAA,EAAK,MAAA,EAAQ,CAAA,GAAI,WAAA,CAAY,CAAA,CAAE,KAAA,CAAM,CAAA;;;;;iBA+B1E,YAAA,GAAA,CAAgB,MAAA,EAAQ,WAAA,CAAY,CAAA,IAAK,MAAA,IAAU,QAAA"}

package/dist/passkey-config-C-MxsV22.mjs

@@ -0,0 +1,46 @@
+//#region src/auth/passkey-config.ts
+/**
+* Get passkey configuration from request URL
+*
+* @param url The request URL (typically `new URL(Astro.request.url)` or `new URL(request.url)`)
+* @param siteName Optional site name for rpName (defaults to hostname from `url` or public origin)
+* @param siteUrl Optional browser-facing origin (see `EmDashConfig.siteUrl`).
+*        When set, the canonical **origin** and **rpId** are taken from this URL.
+* @param allowedOrigins Optional list of additional accepted origins for verification.
+*        Each must share `rpId` with the canonical origin (WebAuthn requirement).
+*        Typical use: apex + preview subdomain on the same registrable domain.
+* @throws If `siteUrl` is non-empty but not parseable by `new URL()`.
+*/
+function getPasskeyConfig(url, siteName, siteUrl, allowedOrigins) {
+	let rpName;
+	let rpId;
+	let canonicalOrigin;
+	if (siteUrl) {
+		let publicUrl;
+		try {
+			publicUrl = new URL(siteUrl);
+		} catch (e) {
+			throw new Error(`Invalid siteUrl: "${siteUrl}"`, { cause: e });
+		}
+		rpName = siteName || publicUrl.hostname;
+		rpId = publicUrl.hostname;
+		canonicalOrigin = publicUrl.origin;
+	} else {
+		rpName = siteName || url.hostname;
+		rpId = url.hostname;
+		canonicalOrigin = url.origin;
+	}
+	const origins = [canonicalOrigin];
+	if (allowedOrigins) {
+		for (const extra of allowedOrigins) if (extra && !origins.includes(extra)) origins.push(extra);
+	}
+	return {
+		rpName,
+		rpId,
+		origins
+	};
+}
+
+//#endregion
+export { getPasskeyConfig as t };
+//# sourceMappingURL=passkey-config-C-MxsV22.mjs.map

package/dist/passkey-config-C-MxsV22.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"passkey-config-C-MxsV22.mjs","names":[],"sources":["../src/auth/passkey-config.ts"],"sourcesContent":["/**\n * Passkey configuration helper\n *\n * Extracts passkey configuration from the request URL.\n * This ensures the rpId and origin are correctly set for both\n * localhost development and production deployments.\n */\n\nexport interface PasskeyConfig {\n\trpName: string;\n\trpId: string;\n\t/**\n\t * Accepted client-data origins. First entry is the canonical/preferred origin;\n\t * additional entries support multi-origin deployments (e.g. apex + preview\n\t * subdomain sharing the same `rpId`). See `allowedOrigins` parameter.\n\t */\n\torigins: string[];\n}\n\n/**\n * Get passkey configuration from request URL\n *\n * @param url The request URL (typically `new URL(Astro.request.url)` or `new URL(request.url)`)\n * @param siteName Optional site name for rpName (defaults to hostname from `url` or public origin)\n * @param siteUrl Optional browser-facing origin (see `EmDashConfig.siteUrl`).\n *        When set, the canonical **origin** and **rpId** are taken from this URL.\n * @param allowedOrigins Optional list of additional accepted origins for verification.\n *        Each must share `rpId` with the canonical origin (WebAuthn requirement).\n *        Typical use: apex + preview subdomain on the same registrable domain.\n * @throws If `siteUrl` is non-empty but not parseable by `new URL()`.\n */\nexport function getPasskeyConfig(\n\turl: URL,\n\tsiteName?: string,\n\tsiteUrl?: string,\n\tallowedOrigins?: string[],\n): PasskeyConfig {\n\tlet rpName: string;\n\tlet rpId: string;\n\tlet canonicalOrigin: string;\n\n\tif (siteUrl) {\n\t\tlet publicUrl: URL;\n\t\ttry {\n\t\t\tpublicUrl = new URL(siteUrl);\n\t\t} catch (e) {\n\t\t\tthrow new Error(`Invalid siteUrl: \"${siteUrl}\"`, { cause: e });\n\t\t}\n\t\trpName = siteName || publicUrl.hostname;\n\t\trpId = publicUrl.hostname;\n\t\tcanonicalOrigin = publicUrl.origin;\n\t} else {\n\t\trpName = siteName || url.hostname;\n\t\trpId = url.hostname;\n\t\tcanonicalOrigin = url.origin;\n\t}\n\n\tconst origins = [canonicalOrigin];\n\tif (allowedOrigins) {\n\t\tfor (const extra of allowedOrigins) {\n\t\t\tif (extra && !origins.includes(extra)) origins.push(extra);\n\t\t}\n\t}\n\n\treturn { rpName, rpId, origins };\n}\n"],"mappings":";;;;;;;;;;;;;AA+BA,SAAgB,iBACf,KACA,UACA,SACA,gBACgB;CAChB,IAAI;CACJ,IAAI;CACJ,IAAI;AAEJ,KAAI,SAAS;EACZ,IAAI;AACJ,MAAI;AACH,eAAY,IAAI,IAAI,QAAQ;WACpB,GAAG;AACX,SAAM,IAAI,MAAM,qBAAqB,QAAQ,IAAI,EAAE,OAAO,GAAG,CAAC;;AAE/D,WAAS,YAAY,UAAU;AAC/B,SAAO,UAAU;AACjB,oBAAkB,UAAU;QACtB;AACN,WAAS,YAAY,IAAI;AACzB,SAAO,IAAI;AACX,oBAAkB,IAAI;;CAGvB,MAAM,UAAU,CAAC,gBAAgB;AACjC,KAAI,gBACH;OAAK,MAAM,SAAS,eACnB,KAAI,SAAS,CAAC,QAAQ,SAAS,MAAM,CAAE,SAAQ,KAAK,MAAM;;AAI5D,QAAO;EAAE;EAAQ;EAAM;EAAS"}

package/dist/paths-kr8hAMMI.mjs

@@ -0,0 +1,77 @@
+import { p as isRecordKind } from "./kinds-BQl5gN6e.mjs";
+
+//#region src/transfer/format/paths.ts
+/**
+* Package file paths.
+*
+* A package contains exactly these files, and nothing else:
+*
+* ```
+* manifest.json
+* index/<seq>.ndjson                file index chunks, listed in the manifest
+* records/<kind>/<seq>.ndjson       record chunks, listed in the index
+* media/<sha256-hex>                raw media bytes, listed in the index
+* ```
+*
+* `seq` is a zero-padded six-digit number starting at `000000` with no gaps.
+* Paths are case-sensitive, relative, and never contain `.`/`..` segments,
+* backslashes, or empty segments; anything that does not match is rejected.
+*/
+const MANIFEST_PATH = "manifest.json";
+const SEQ_DIGITS = 6;
+const MAX_SEQ = 10 ** SEQ_DIGITS - 1;
+const INDEX_PATH_PATTERN = /^index\/(\d{6})\.ndjson$/;
+const RECORD_PATH_PATTERN = /^records\/([a-z_]+)\/(\d{6})\.ndjson$/;
+const MEDIA_PATH_PATTERN = /^media\/([0-9a-f]{64})$/;
+const SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;
+function parsePackagePath(path) {
+	if (path === MANIFEST_PATH) return {
+		type: "manifest",
+		path
+	};
+	const index = INDEX_PATH_PATTERN.exec(path);
+	if (index) return {
+		type: "index",
+		path,
+		seq: Number(index[1])
+	};
+	const records = RECORD_PATH_PATTERN.exec(path);
+	if (records) {
+		const kind = records[1];
+		if (!isRecordKind(kind)) return null;
+		return {
+			type: "records",
+			path,
+			kind,
+			seq: Number(records[2])
+		};
+	}
+	const media = MEDIA_PATH_PATTERN.exec(path);
+	if (media) return {
+		type: "media",
+		path,
+		sha256: media[1]
+	};
+	return null;
+}
+function isPackagePath(path) {
+	return parsePackagePath(path) !== null;
+}
+function formatSeq(seq) {
+	if (!Number.isInteger(seq) || seq < 0 || seq > MAX_SEQ) throw new RangeError(`Invalid chunk sequence ${seq}`);
+	return String(seq).padStart(SEQ_DIGITS, "0");
+}
+function indexChunkPath(seq) {
+	return `index/${formatSeq(seq)}.ndjson`;
+}
+function recordChunkPath(kind, seq) {
+	return `records/${kind}/${formatSeq(seq)}.ndjson`;
+}
+function mediaBlobPath(sha256) {
+	if (!SHA256_HEX_PATTERN.test(sha256)) throw new TypeError("Expected a lowercase hex SHA-256");
+	return `media/${sha256}`;
+}
+
+//#endregion
+export { parsePackagePath as a, mediaBlobPath as i, indexChunkPath as n, recordChunkPath as o, isPackagePath as r, MANIFEST_PATH as t };
+//# sourceMappingURL=paths-kr8hAMMI.mjs.map

package/dist/paths-kr8hAMMI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths-kr8hAMMI.mjs","names":[],"sources":["../src/transfer/format/paths.ts"],"sourcesContent":["/**\n * Package file paths.\n *\n * A package contains exactly these files, and nothing else:\n *\n * ```\n * manifest.json\n * index/<seq>.ndjson                file index chunks, listed in the manifest\n * records/<kind>/<seq>.ndjson       record chunks, listed in the index\n * media/<sha256-hex>                raw media bytes, listed in the index\n * ```\n *\n * `seq` is a zero-padded six-digit number starting at `000000` with no gaps.\n * Paths are case-sensitive, relative, and never contain `.`/`..` segments,\n * backslashes, or empty segments; anything that does not match is rejected.\n */\n\nimport { isRecordKind, type RecordKind } from \"./kinds.js\";\n\nexport const MANIFEST_PATH = \"manifest.json\";\n\nconst SEQ_DIGITS = 6;\nconst MAX_SEQ = 10 ** SEQ_DIGITS - 1;\n\nconst INDEX_PATH_PATTERN = /^index\\/(\\d{6})\\.ndjson$/;\nconst RECORD_PATH_PATTERN = /^records\\/([a-z_]+)\\/(\\d{6})\\.ndjson$/;\nconst MEDIA_PATH_PATTERN = /^media\\/([0-9a-f]{64})$/;\nconst SHA256_HEX_PATTERN = /^[0-9a-f]{64}$/;\n\nexport type PackagePath =\n\t| { type: \"manifest\"; path: typeof MANIFEST_PATH }\n\t| { type: \"index\"; path: string; seq: number }\n\t| { type: \"records\"; path: string; kind: RecordKind; seq: number }\n\t| { type: \"media\"; path: string; sha256: string };\n\nexport function parsePackagePath(path: string): PackagePath | null {\n\tif (path === MANIFEST_PATH) return { type: \"manifest\", path };\n\tconst index = INDEX_PATH_PATTERN.exec(path);\n\tif (index) return { type: \"index\", path, seq: Number(index[1]) };\n\tconst records = RECORD_PATH_PATTERN.exec(path);\n\tif (records) {\n\t\tconst kind = records[1];\n\t\tif (!isRecordKind(kind)) return null;\n\t\treturn { type: \"records\", path, kind, seq: Number(records[2]) };\n\t}\n\tconst media = MEDIA_PATH_PATTERN.exec(path);\n\tif (media) return { type: \"media\", path, sha256: media[1] };\n\treturn null;\n}\n\nexport function isPackagePath(path: string): boolean {\n\treturn parsePackagePath(path) !== null;\n}\n\nfunction formatSeq(seq: number): string {\n\tif (!Number.isInteger(seq) || seq < 0 || seq > MAX_SEQ) {\n\t\tthrow new RangeError(`Invalid chunk sequence ${seq}`);\n\t}\n\treturn String(seq).padStart(SEQ_DIGITS, \"0\");\n}\n\nexport function indexChunkPath(seq: number): string {\n\treturn `index/${formatSeq(seq)}.ndjson`;\n}\n\nexport function recordChunkPath(kind: RecordKind, seq: number): string {\n\treturn `records/${kind}/${formatSeq(seq)}.ndjson`;\n}\n\nexport function mediaBlobPath(sha256: string): string {\n\tif (!SHA256_HEX_PATTERN.test(sha256)) throw new TypeError(\"Expected a lowercase hex SHA-256\");\n\treturn `media/${sha256}`;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAmBA,MAAa,gBAAgB;AAE7B,MAAM,aAAa;AACnB,MAAM,UAAU,MAAM,aAAa;AAEnC,MAAM,qBAAqB;AAC3B,MAAM,sBAAsB;AAC5B,MAAM,qBAAqB;AAC3B,MAAM,qBAAqB;AAQ3B,SAAgB,iBAAiB,MAAkC;AAClE,KAAI,SAAS,cAAe,QAAO;EAAE,MAAM;EAAY;EAAM;CAC7D,MAAM,QAAQ,mBAAmB,KAAK,KAAK;AAC3C,KAAI,MAAO,QAAO;EAAE,MAAM;EAAS;EAAM,KAAK,OAAO,MAAM,GAAG;EAAE;CAChE,MAAM,UAAU,oBAAoB,KAAK,KAAK;AAC9C,KAAI,SAAS;EACZ,MAAM,OAAO,QAAQ;AACrB,MAAI,CAAC,aAAa,KAAK,CAAE,QAAO;AAChC,SAAO;GAAE,MAAM;GAAW;GAAM;GAAM,KAAK,OAAO,QAAQ,GAAG;GAAE;;CAEhE,MAAM,QAAQ,mBAAmB,KAAK,KAAK;AAC3C,KAAI,MAAO,QAAO;EAAE,MAAM;EAAS;EAAM,QAAQ,MAAM;EAAI;AAC3D,QAAO;;AAGR,SAAgB,cAAc,MAAuB;AACpD,QAAO,iBAAiB,KAAK,KAAK;;AAGnC,SAAS,UAAU,KAAqB;AACvC,KAAI,CAAC,OAAO,UAAU,IAAI,IAAI,MAAM,KAAK,MAAM,QAC9C,OAAM,IAAI,WAAW,0BAA0B,MAAM;AAEtD,QAAO,OAAO,IAAI,CAAC,SAAS,YAAY,IAAI;;AAG7C,SAAgB,eAAe,KAAqB;AACnD,QAAO,SAAS,UAAU,IAAI,CAAC;;AAGhC,SAAgB,gBAAgB,MAAkB,KAAqB;AACtE,QAAO,WAAW,KAAK,GAAG,UAAU,IAAI,CAAC;;AAG1C,SAAgB,cAAc,QAAwB;AACrD,KAAI,CAAC,mBAAmB,KAAK,OAAO,CAAE,OAAM,IAAI,UAAU,mCAAmC;AAC7F,QAAO,SAAS"}

package/dist/placeholder-Dn7MMdWr.d.mts

@@ -0,0 +1,306 @@
+//#region src/media/types.d.ts
+/**
+ * Media Provider Types
+ *
+ * Media providers are pluggable sources for browsing, uploading, and embedding media.
+ * They enable integration with external services (Unsplash, Cloudinary, Mux, etc.)
+ * alongside the built-in local media library.
+ */
+/**
+ * Serializable media provider configuration descriptor
+ * Returned by provider config functions (e.g., unsplash(), mux())
+ */
+interface MediaProviderDescriptor<TConfig = Record<string, unknown>> {
+  /** Unique identifier, used in MediaValue.provider */
+  id: string;
+  /** Display name for admin UI */
+  name: string;
+  /** Icon for tab UI (emoji or URL) */
+  icon?: string;
+  /** Module path exporting createMediaProvider function */
+  entrypoint: string;
+  /** Optional React component module for custom admin UI */
+  adminModule?: string;
+  /** Capability flags determine UI behavior */
+  capabilities: MediaProviderCapabilities;
+  /** Serializable config passed to createMediaProvider at runtime */
+  config: TConfig;
+}
+/**
+ * Provider capabilities determine what UI elements to show
+ */
+interface MediaProviderCapabilities {
+  /** Can list/browse media */
+  browse: boolean;
+  /** Supports text search */
+  search: boolean;
+  /** Can upload new media */
+  upload: boolean;
+  /** Can delete media */
+  delete: boolean;
+}
+/**
+ * Options for listing media
+ */
+interface MediaListOptions {
+  /** Pagination cursor */
+  cursor?: string;
+  /** Max items to return (default 20) */
+  limit?: number;
+  /** Search query (if capabilities.search is true) */
+  query?: string;
+  /** Filter by MIME type prefix, e.g., "image/", "video/" */
+  mimeType?: string;
+}
+/**
+ * Result from listing media
+ */
+interface MediaListResult {
+  items: MediaProviderItem[];
+  nextCursor?: string;
+}
+/**
+ * A media item as returned by a provider
+ * This is the provider's view of the item, before it's selected
+ */
+interface MediaProviderItem {
+  /** Provider-specific ID */
+  id: string;
+  /** Original filename */
+  filename: string;
+  /** MIME type */
+  mimeType: string;
+  /** File size in bytes (if known) */
+  size?: number;
+  /** Dimensions (for images/video) */
+  width?: number;
+  height?: number;
+  /** Default focal point for cover-cropped displays */
+  focalX?: number;
+  focalY?: number;
+  /** LQIP blurhash placeholder (images only) */
+  blurhash?: string;
+  /** LQIP dominant-color placeholder, as a CSS color (images only) */
+  dominantColor?: string;
+  /** Accessibility text */
+  alt?: string;
+  /** Preview URL for admin UI thumbnail */
+  previewUrl?: string;
+  /** Provider-specific metadata */
+  meta?: Record<string, unknown>;
+}
+/**
+ * Input for uploading media
+ */
+interface MediaUploadInput {
+  file: File;
+  filename: string;
+  alt?: string;
+}
+/**
+ * Options for generating embed
+ */
+interface EmbedOptions {
+  /** Desired width (provider may use for optimization) */
+  width?: number;
+  /** Desired height */
+  height?: number;
+  /** Image format preference */
+  format?: "webp" | "avif" | "jpeg" | "png" | "auto";
+}
+/**
+ * Embed result types
+ */
+type EmbedResult = ImageEmbed | VideoEmbed | AudioEmbed | ComponentEmbed;
+interface ImageEmbed {
+  type: "image";
+  src: string;
+  srcset?: string;
+  sizes?: string;
+  width?: number;
+  height?: number;
+  /** LQIP blurhash placeholder for rendering before the image loads */
+  blurhash?: string;
+  /** LQIP dominant-color placeholder, as a CSS color */
+  dominantColor?: string;
+  alt?: string;
+  /** Base URL without transforms, for responsive image generation */
+  cdnBaseUrl?: string;
+  /** For providers with URL-based transforms (Cloudinary, imgix) */
+  getSrc?: (opts: {
+    width?: number;
+    height?: number;
+    format?: string;
+  }) => string;
+}
+interface VideoEmbed {
+  type: "video";
+  /** Single source URL */
+  src?: string;
+  /** Multiple sources for format fallback */
+  sources?: Array<{
+    src: string;
+    type: string;
+  }>;
+  /** Poster/thumbnail image */
+  poster?: string;
+  width?: number;
+  height?: number;
+  /** Player controls */
+  controls?: boolean;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  playsinline?: boolean;
+  preload?: "none" | "metadata" | "auto";
+  crossorigin?: "anonymous" | "use-credentials";
+}
+interface AudioEmbed {
+  type: "audio";
+  src?: string;
+  sources?: Array<{
+    src: string;
+    type: string;
+  }>;
+  controls?: boolean;
+  autoplay?: boolean;
+  muted?: boolean;
+  loop?: boolean;
+  preload?: "none" | "metadata" | "auto";
+}
+interface ComponentEmbed {
+  type: "component";
+  /** Package to import from, e.g., "@mux/player-react" */
+  package: string;
+  /** Named export (default export if not specified) */
+  export?: string;
+  /** Props to pass to the component */
+  props: Record<string, unknown>;
+}
+/**
+ * Options for thumbnail generation
+ */
+interface ThumbnailOptions {
+  /** Desired width */
+  width?: number;
+  /** Desired height */
+  height?: number;
+}
+/**
+ * Runtime media provider interface
+ * Implemented by provider entrypoints
+ */
+interface MediaProvider {
+  /**
+   * List/search media items
+   */
+  list(options: MediaListOptions): Promise<MediaListResult>;
+  /**
+   * Get a single item by ID (optional, for refresh/validation)
+   */
+  get?(id: string): Promise<MediaProviderItem | null>;
+  /**
+   * Upload new media (if capabilities.upload is true)
+   */
+  upload?(input: MediaUploadInput): Promise<MediaProviderItem>;
+  /**
+   * Delete media (if capabilities.delete is true)
+   */
+  delete?(id: string): Promise<void>;
+  /**
+   * Get embed information for rendering this media item
+   * Called at runtime when rendering content
+   */
+  getEmbed(value: MediaValue, options?: EmbedOptions): Promise<EmbedResult> | EmbedResult;
+  /**
+   * Get a thumbnail URL for admin display
+   * For images: returns a resized image URL
+   * For videos: returns a poster/thumbnail URL
+   */
+  getThumbnailUrl?(id: string, mimeType?: string, options?: ThumbnailOptions): string;
+}
+/**
+ * Function signature for provider entrypoint modules
+ */
+type CreateMediaProviderFn<TConfig = Record<string, unknown>> = (config: TConfig) => MediaProvider;
+/**
+ * Media value stored in content fields
+ * This is what gets persisted when media is selected
+ *
+ * For backwards compatibility:
+ * - `provider` defaults to "local" if not specified
+ * - `src` is supported for legacy data or external URLs
+ */
+interface MediaValue {
+  /** Provider ID, e.g., "local", "unsplash", "mux" (defaults to "local") */
+  provider?: string;
+  /** Provider-specific item ID */
+  id: string;
+  /** Direct URL (for local media or legacy data) */
+  src?: string;
+  /** Preview URL for admin display (external providers) */
+  previewUrl?: string;
+  /** Cached metadata for display without runtime lookup */
+  filename?: string;
+  mimeType?: string;
+  width?: number;
+  height?: number;
+  /** Default focal point copied when the media item is selected */
+  focalX?: number;
+  focalY?: number;
+  /** Cached LQIP blurhash placeholder (images only) */
+  blurhash?: string;
+  /** Cached LQIP dominant-color placeholder, as a CSS color (images only) */
+  dominantColor?: string;
+  alt?: string;
+  /** Provider-specific data needed for embedding */
+  meta?: Record<string, unknown>;
+}
+/**
+ * Convert a MediaProviderItem to a MediaValue for storage
+ */
+declare function mediaItemToValue(providerId: string, item: MediaProviderItem): MediaValue;
+//#endregion
+//#region src/media/normalize.d.ts
+/**
+ * Normalize a media field value into a consistent MediaValue shape.
+ *
+ * - `null`/`undefined` → `null`
+ * - Bare URL string → `{ provider: "external", id: "", src: url }`
+ * - Bare internal media URL → resolved via local provider's `get()`
+ * - Bare local media ID → resolved via local provider's `get()`
+ * - Object with `provider` + `id` → enriched with missing fields from provider
+ */
+declare function normalizeMediaValue(value: unknown, getProvider: (id: string) => MediaProvider | undefined): Promise<MediaValue | null>;
+//#endregion
+//#region src/media/placeholder.d.ts
+/**
+ * Image Placeholder Generation
+ *
+ * Generates blurhash and dominant color from image buffers for LQIP support.
+ * Decodes images via jpeg-js (pure JS) and upng-js (pure JS, uses pako for
+ * deflate). No Node-specific dependencies — works in Workers and Node SSR.
+ */
+interface PlaceholderData {
+  blurhash: string;
+  dominantColor: string;
+}
+/**
+ * Generate blurhash and dominant color from an image buffer.
+ * Returns null for non-image MIME types or on failure.
+ *
+ * @param dimensions - Optional pre-known dimensions. When present they are
+ *   trusted verbatim (the caller has typically already read them via
+ *   readDimensions); otherwise dimensions are read from this buffer's header.
+ *   Generation is skipped (returns null) when no dimensions are available at
+ *   all, or when the decoded size (width * height * 4) exceeds
+ *   MAX_DECODED_BYTES — both guards avoid OOM from unbounded decodes on
+ *   memory-constrained runtimes.
+ */
+declare function generatePlaceholder(buffer: Uint8Array, mimeType: string, dimensions?: {
+  width: number;
+  height: number;
+}): Promise<PlaceholderData | null>;
+//#endregion
+export { MediaValue as _, ComponentEmbed as a, mediaItemToValue as b, EmbedResult as c, MediaListResult as d, MediaProvider as f, MediaUploadInput as g, MediaProviderItem as h, AudioEmbed as i, ImageEmbed as l, MediaProviderDescriptor as m, generatePlaceholder as n, CreateMediaProviderFn as o, MediaProviderCapabilities as p, normalizeMediaValue as r, EmbedOptions as s, PlaceholderData as t, MediaListOptions as u, ThumbnailOptions as v, VideoEmbed as y };
+//# sourceMappingURL=placeholder-Dn7MMdWr.d.mts.map

package/dist/placeholder-Dn7MMdWr.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"placeholder-Dn7MMdWr.d.mts","names":[],"sources":["../src/media/types.ts","../src/media/normalize.ts","../src/media/placeholder.ts"],"mappings":"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"}