Files
m3e-canvas/web/vendor/lib/share.ts
T
pastilhasandClaude Fable 5 240d63940d vendor m3e-canvas 5c83ac6, with the import rewrite scripted
upstream imports through a @/ alias, and this platform already binds
@/* to src/apps/officer-web and @/components/* to its own shared
components — so an unrewritten import resolves to the WRONG module
rather than failing. the rewrite is mechanical and lives in
scripts/vendor.sh so a re-vendor produces a readable diff.

lib/ai.ts and AiPanel are vendored despite being unwanted: deleting them
meant editing vendored code, and Canvas.tsx references them throughout.
a faithful copy carrying an unused module beats a doctored one.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-09-05 12:00:17 +01:00

80 lines
3.0 KiB
TypeScript

import { Doc } from "./tokens";
import { isProject } from "./project";
/* A design travels in a link: the document as JSON, deflated and base64url-encoded
* after `#docz=`, or plain JSON after `#doc=` for tools that cannot compress. The
* fragment never reaches the server, so the static site stays static. */
export const DOC_PARAM = "doc";
export const DOCZ_PARAM = "docz";
/** the document with what a link should not carry: picked images and AI rewrite history */
export function shareable(doc: Doc): Doc {
return {
...doc,
frames: doc.frames.map(({ noteHistory: _h, ...f }) => f),
groups: doc.groups.map((g) => ({
...g,
items: g.items.map(({ src, noteHistory: _h, ...it }) => (src && /^https?:\/\//.test(src) ? { ...it, src } : it)),
})),
};
}
const toBase64Url = (bytes: Uint8Array) => {
let bin = "";
for (const b of bytes) bin += String.fromCharCode(b);
return btoa(bin).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
};
const fromBase64Url = (s: string) => {
const b64 = s.replace(/-/g, "+").replace(/_/g, "/") + "=".repeat((4 - (s.length % 4)) % 4);
const bin = atob(b64);
const out = new Uint8Array(bin.length);
for (let i = 0; i < bin.length; i++) out[i] = bin.charCodeAt(i);
return out;
};
async function pipe(bytes: Uint8Array, stream: { readable: ReadableStream; writable: WritableStream }): Promise<Uint8Array> {
const writer = stream.writable.getWriter();
/* the writer's own promises reject too on bad input; the read below reports the failure */
writer.write(bytes).catch(() => {});
writer.close().catch(() => {});
return new Uint8Array(await new Response(stream.readable).arrayBuffer());
}
/** the link that opens `doc` at `base` (the app URL without a hash) */
export async function shareLink(doc: Doc, base: string): Promise<string> {
const json = JSON.stringify(shareable(doc));
if (typeof CompressionStream !== "undefined") {
const packed = await pipe(new TextEncoder().encode(json), new CompressionStream("deflate-raw"));
return `${base}#${DOCZ_PARAM}=${toBase64Url(packed)}`;
}
return `${base}#${DOC_PARAM}=${encodeURIComponent(json)}`;
}
/** the document a hash carries, or null when it carries none or a broken one */
export async function readShareHash(hash: string): Promise<Doc | null> {
const params = new URLSearchParams(hash.replace(/^#/, ""));
try {
let json: string | null = null;
const packed = params.get(DOCZ_PARAM);
if (packed) {
const bytes = await pipe(fromBase64Url(packed), new DecompressionStream("deflate-raw"));
json = new TextDecoder().decode(bytes);
} else {
json = params.get(DOC_PARAM);
}
if (!json) return null;
const value: unknown = JSON.parse(json);
return isProject(value) ? value : null;
} catch {
return null;
}
}
/** whether a hash claims to carry a document at all */
export const hasShareHash = (hash: string) => {
const params = new URLSearchParams(hash.replace(/^#/, ""));
return params.has(DOCZ_PARAM) || params.has(DOC_PARAM);
};