@camox/api-contract 0.57.0 → 0.58.1

package/dist/index.d.ts

@@ -10,6 +10,12 @@ export declare const UNTITLED_ARTIFACT = "Untitled artifact";
 export declare function artifactSourceTitle(source: string): string | undefined;
 /** The artifact's name: its source's `<title>`, or "Untitled artifact". */
 export declare function artifactTitle(source: string): string;
+/**
+ * The hash an artifact source is stored and served under: the SHA-256 of its UTF-8 bytes, in
+ * URL-safe base64 without padding. Shared by the API, which stores sources under it, and the SDK,
+ * which names the URLs public pages load artifacts from.
+ */
+export declare function artifactSourceHash(source: string): Promise<string>;
 //#endregion
 //#region src/record-templates.d.ts
 /**

package/dist/index.js

@@ -31,6 +31,17 @@ function artifactSourceTitle(source) {
 function artifactTitle(source) {
 	return artifactSourceTitle(source) ?? "Untitled artifact";
 }
+/**
+* The hash an artifact source is stored and served under: the SHA-256 of its UTF-8 bytes, in
+* URL-safe base64 without padding. Shared by the API, which stores sources under it, and the SDK,
+* which names the URLs public pages load artifacts from.
+*/
+async function artifactSourceHash(source) {
+	const digest = await crypto.subtle.digest("SHA-256", new TextEncoder().encode(source));
+	let binary = "";
+	for (const byte of new Uint8Array(digest)) binary += String.fromCharCode(byte);
+	return btoa(binary).replaceAll("+", "-").replaceAll("/", "_").replace(/=+$/, "");
+}
 
 //#endregion
 //#region src/record-templates.ts
@@ -133,4 +144,4 @@ function isSettingCondition(value) {
 }
 
 //#endregion
-export { ARTICLE_TYPES, ICON_CATALOG_VERSION, PAGE_TEXT_LINK_PREFIX, QUERY_LIMIT_CAP, SYSTEM_ORDER_KEYS, UNTITLED_ARTIFACT, artifactSourceTitle, artifactTitle, generateUuidv7, isPageUrlMarker, isQueryBacked, isSettingCondition, isSystemOrderKey, linkedRecordId, nonStringTemplateFields, projectIdSchema, recordLink, recordText, referenceQueryProblem, scopeIconSvgIds, templateFields, uuidv7JsonSchema, uuidv7Schema, validateIconValue };
+export { ARTICLE_TYPES, ICON_CATALOG_VERSION, PAGE_TEXT_LINK_PREFIX, QUERY_LIMIT_CAP, SYSTEM_ORDER_KEYS, UNTITLED_ARTIFACT, artifactSourceHash, artifactSourceTitle, artifactTitle, generateUuidv7, isPageUrlMarker, isQueryBacked, isSettingCondition, isSystemOrderKey, linkedRecordId, nonStringTemplateFields, projectIdSchema, recordLink, recordText, referenceQueryProblem, scopeIconSvgIds, templateFields, uuidv7JsonSchema, uuidv7Schema, validateIconValue };