@visual-platform/next 0.3.0 → 0.4.0

package/dist/adapters.d.ts

@@ -0,0 +1,51 @@
+import type { SourceResolveArgs } from "./sources.js";
+/**
+ * Ready-made `resolve` functions (ADR-048 P5) for common backends — no extra dependencies.
+ *   products: defineSource({ params, resolve: fromFetch({ url: process.env.CATALOG_URL + "/products", headers: { authorization: `Bearer ${process.env.CATALOG_TOKEN}` } }) })
+ * URLs and credentials come from your code/env — never from Studio or the page JSON. Every request
+ * gets the source's abort signal (timeout) and is read as JSON with a size cap.
+ */
+type Params = Record<string, unknown>;
+export type FetchSourceOptions<P extends Params> = {
+    /** Fixed by you: a string, or built from the validated params. */
+    url: string | ((params: P, locale: string) => string);
+    method?: "GET" | "POST";
+    headers?: Record<string, string> | (() => Record<string, string>);
+    /** GET: params become query string (default). POST: JSON body (params + locale). */
+    sendParams?: "query" | "body" | "none";
+    /** Dot path of the part of the answer to return, e.g. "data.items". */
+    select?: string;
+    /** Map the answer (after select) to the shape your components expect. */
+    map?: (data: unknown, params: P) => unknown;
+};
+export declare function fromFetch<P extends Params = Params>(o: FetchSourceOptions<P>): ({ params, locale, signal }: SourceResolveArgs<P>) => Promise<unknown>;
+export type SanitySourceOptions<P extends Params> = {
+    projectId: string;
+    dataset: string;
+    /** GROQ; params are passed as $variables (plus $locale). Never built from strings. */
+    query: string;
+    apiVersion?: string;
+    /** Read token for private datasets / drafts (server only). */
+    token?: string;
+    useCdn?: boolean;
+    map?: (result: unknown, params: P) => unknown;
+};
+/** Sanity Content Lake (HTTP Query API). */
+export declare function fromSanity<P extends Params = Params>(o: SanitySourceOptions<P>): ({ params, locale, signal }: SourceResolveArgs<P>) => Promise<unknown>;
+export type ContentfulSourceOptions<P extends Params> = {
+    space: string;
+    environment?: string;
+    /** Delivery API token (or Preview API token with preview: true). */
+    accessToken: string;
+    preview?: boolean;
+    contentType: string;
+    /** Extra query (e.g. { "fields.slug": params.slug, limit: 10 }), built from validated params. */
+    query?: (params: P, locale: string) => Record<string, string | number | boolean | undefined>;
+    /** Contentful locale for a page locale (default: same code). */
+    locale?: (pageLocale: string) => string;
+    map?: (items: Record<string, unknown>[], params: P) => unknown;
+};
+/** Contentful Content Delivery API: entries of one content type, linked assets/entries resolved one level. */
+export declare function fromContentful<P extends Params = Params>(o: ContentfulSourceOptions<P>): ({ params, locale, signal }: SourceResolveArgs<P>) => Promise<unknown>;
+export {};
+//# sourceMappingURL=adapters.d.ts.map

package/dist/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEtD;;;;;GAKG;AACH,KAAK,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAiBtC,MAAM,MAAM,kBAAkB,CAAC,CAAC,SAAS,MAAM,IAAI;IACjD,kEAAkE;IAClE,GAAG,EAAE,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,CAAC;IACtD,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClE,oFAAoF;IACpF,UAAU,CAAC,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC;IACvC,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,yEAAyE;IACzE,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;CAC7C,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,kBAAkB,CAAC,CAAC,CAAC,gCACjC,iBAAiB,CAAC,CAAC,CAAC,sBAe/D;AAED,MAAM,MAAM,mBAAmB,CAAC,CAAC,SAAS,MAAM,IAAI;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;CAC/C,CAAC;AAEF,4CAA4C;AAC5C,wBAAgB,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,gCAEnC,iBAAiB,CAAC,CAAC,CAAC,sBAS/D;AAED,MAAM,MAAM,uBAAuB,CAAC,CAAC,SAAS,MAAM,IAAI;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,iGAAiG;IACjG,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC,CAAC;IAC7F,gEAAgE;IAChE,MAAM,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,CAAC;IACxC,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,KAAK,OAAO,CAAC;CAChE,CAAC;AAQF,8GAA8G;AAC9G,wBAAgB,cAAc,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,uBAAuB,CAAC,CAAC,CAAC,gCAC3C,iBAAiB,CAAC,CAAC,CAAC,sBAkB/D"}

package/dist/adapters.js

@@ -0,0 +1,79 @@
+const MAX_BYTES = 2_000_000;
+async function readJson(res, what) {
+    if (!res.ok)
+        throw new Error(`${what} answered ${res.status}`);
+    const text = await res.text();
+    if (text.length > MAX_BYTES)
+        throw new Error(`${what} answered more than 2 MB`);
+    return JSON.parse(text);
+}
+const pick = (v, path) => {
+    if (!path)
+        return v;
+    let cur = v;
+    for (const seg of path.split("."))
+        cur = cur && typeof cur === "object" ? cur[seg] : undefined;
+    return cur;
+};
+export function fromFetch(o) {
+    return async ({ params, locale, signal }) => {
+        const method = o.method ?? "GET";
+        const send = o.sendParams ?? (method === "GET" ? "query" : "body");
+        let url = typeof o.url === "function" ? o.url(params, locale) : o.url;
+        if (send === "query") {
+            const u = new URL(url);
+            for (const [k, v] of Object.entries(params ?? {}))
+                if (v !== undefined && v !== null)
+                    u.searchParams.set(k, String(v));
+            if (!u.searchParams.has("locale"))
+                u.searchParams.set("locale", locale);
+            url = u.toString();
+        }
+        const headers = { accept: "application/json", ...(typeof o.headers === "function" ? o.headers() : o.headers ?? {}), ...(send === "body" ? { "content-type": "application/json" } : {}) };
+        const res = await fetch(url, { method, headers, signal, ...(send === "body" ? { body: JSON.stringify({ ...params, locale }) } : {}), cache: "no-store" });
+        const data = pick(await readJson(res, new URL(url).host), o.select);
+        return o.map ? o.map(data, params) : data;
+    };
+}
+/** Sanity Content Lake (HTTP Query API). */
+export function fromSanity(o) {
+    if (!/^[a-z0-9]+$/.test(o.projectId) || !/^[a-z0-9_-]+$/.test(o.dataset))
+        throw new Error("[visual] fromSanity: invalid projectId or dataset");
+    return async ({ params, locale, signal }) => {
+        const host = `https://${o.projectId}.${o.useCdn === false || o.token ? "api" : "apicdn"}.sanity.io`;
+        const u = new URL(`${host}/v${o.apiVersion ?? "2025-02-19"}/data/query/${o.dataset}`);
+        u.searchParams.set("query", o.query);
+        for (const [k, v] of Object.entries({ ...params, locale }))
+            if (v !== undefined)
+                u.searchParams.set(`$${k}`, JSON.stringify(v));
+        const res = await fetch(u, { headers: { accept: "application/json", ...(o.token ? { authorization: `Bearer ${o.token}` } : {}) }, signal, cache: "no-store" });
+        const result = (await readJson(res, "Sanity")).result;
+        return o.map ? o.map(result, params) : result;
+    };
+}
+/** Contentful Content Delivery API: entries of one content type, linked assets/entries resolved one level. */
+export function fromContentful(o) {
+    return async ({ params, locale, signal }) => {
+        const u = new URL(`https://${o.preview ? "preview" : "cdn"}.contentful.com/spaces/${encodeURIComponent(o.space)}/environments/${encodeURIComponent(o.environment ?? "master")}/entries`);
+        u.searchParams.set("content_type", o.contentType);
+        u.searchParams.set("locale", o.locale ? o.locale(locale) : locale);
+        for (const [k, v] of Object.entries(o.query?.(params, locale) ?? {}))
+            if (v !== undefined)
+                u.searchParams.set(k, String(v));
+        const res = await fetch(u, { headers: { authorization: `Bearer ${o.accessToken}` }, signal, cache: "no-store" });
+        const body = (await readJson(res, "Contentful"));
+        const assets = new Map((body.includes?.Asset ?? []).map((a) => [a.sys.id, { url: a.fields.file?.url ? `https:${a.fields.file.url}` : "", alt: a.fields.title ?? "" }]));
+        const entries = new Map((body.includes?.Entry ?? []).map((e) => [e.sys.id, { id: e.sys.id, ...e.fields }]));
+        const link = (v) => {
+            if (Array.isArray(v))
+                return v.map(link);
+            const s = v?.sys;
+            if (s?.type === "Link" && s.id)
+                return s.linkType === "Asset" ? assets.get(s.id) ?? null : entries.get(s.id) ?? null;
+            return v;
+        };
+        const items = (body.items ?? []).map((e) => ({ id: e.sys.id, ...Object.fromEntries(Object.entries(e.fields).map(([k, v]) => [k, link(v)])) }));
+        return o.map ? o.map(items, params) : items;
+    };
+}
+//# sourceMappingURL=adapters.js.map

package/dist/adapters.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.js","sourceRoot":"","sources":["../src/adapters.ts"],"names":[],"mappings":"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"}

package/dist/client.d.ts

@@ -0,0 +1,54 @@
+import { type ReactNode } from "react";
+import type { SourceStat, VisualSourceHandle } from "./sources.js";
+/**
+ * Browser side of app sources (ADR-048 P3). `useVisual()` reads the context the app chose to expose
+ * (static, cache-safe values only); `useVisualSource(handle)` loads a `load: "client"` source through the
+ * app's own route with the signed handle the server render produced.
+ */
+type Ctx = {
+    context: Record<string, unknown>;
+    endpoint: string;
+};
+export declare function VisualClientProvider(p: {
+    context?: Record<string, unknown> | undefined;
+    endpoint?: string | undefined;
+    children?: ReactNode;
+}): import("react").FunctionComponentElement<import("react").ProviderProps<Ctx>>;
+/** The app context exposed to the browser (`context.expose` in createVisualNext). */
+export declare function useVisual<T extends Record<string, unknown> = Record<string, unknown>>(): T;
+export type VisualSourceState<T> = {
+    data: T | undefined;
+    error: string | undefined;
+    loading: boolean;
+    /** Load now (for when: "interaction"). */
+    load: () => void;
+    /** Reload (e.g. after your own mutation). */
+    refresh: () => void;
+    /** Attach to an element for when: "visible". */
+    ref: (el: Element | null) => void;
+};
+/**
+ * Data of a `load: "client"` source, given the handle your component received through `needs`.
+ * when: "load" (default) fetches after hydration, "idle" when the browser is idle, "visible" when `ref`
+ * scrolls into view, "interaction" only when you call `load()`.
+ */
+export declare function useVisualSource<T = unknown>(handle: VisualSourceHandle | null | undefined): VisualSourceState<T>;
+/** Listens for "refresh" steps and changed sources after actions (ADR-048 P4) and refreshes server data. */
+export declare function VisualRefresh(): null;
+/** Development only: which sources this render resolved, how long they took, cache hits (ADR-048 P5). */
+export declare function VisualDebug(p: {
+    stats: SourceStat[];
+    page: string;
+    dynamic: string[];
+}): import("react").DetailedReactHTMLElement<{
+    "data-vp-debug": string;
+    style: {
+        position: "fixed";
+        insetInlineEnd: number;
+        bottom: number;
+        zIndex: number;
+        font: "12px/1.4 ui-monospace, Menlo, monospace";
+    };
+}, HTMLElement> | null;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAA4G,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AACjJ,OAAO,KAAK,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAEnE;;;;GAIG;AACH,KAAK,GAAG,GAAG;IAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAGlE,wBAAgB,oBAAoB,CAAC,CAAC,EAAE;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,gFAI7I;AAED,qFAAqF;AACrF,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,CAE1F;AAqCD,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI;IACjC,IAAI,EAAE,CAAC,GAAG,SAAS,CAAC;IACpB,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,0CAA0C;IAC1C,IAAI,EAAE,MAAM,IAAI,CAAC;IACjB,6CAA6C;IAC7C,OAAO,EAAE,MAAM,IAAI,CAAC;IACpB,gDAAgD;IAChD,GAAG,EAAE,CAAC,EAAE,EAAE,OAAO,GAAG,IAAI,KAAK,IAAI,CAAC;CACnC,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,kBAAkB,GAAG,IAAI,GAAG,SAAS,GAAG,iBAAiB,CAAC,CAAC,CAAC,CAyBhH;AAED,4GAA4G;AAC5G,wBAAgB,aAAa,SAS5B;AAED,yGAAyG;AACzG,wBAAgB,WAAW,CAAC,CAAC,EAAE;IAAE,KAAK,EAAE,UAAU,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE;;;;;;;;;uBAatF"}

package/dist/client.js

@@ -0,0 +1,114 @@
+"use client";
+import { useRouter } from "next/navigation";
+import { createContext, createElement, useCallback, useContext, useEffect, useRef, useState, useSyncExternalStore } from "react";
+const VisualClientContext = createContext({ context: {}, endpoint: "/api/visual/sources" });
+export function VisualClientProvider(p) {
+    const parent = useContext(VisualClientContext);
+    const value = { context: { ...parent.context, ...(p.context ?? {}) }, endpoint: p.endpoint ?? parent.endpoint };
+    return createElement(VisualClientContext.Provider, { value }, p.children);
+}
+/** The app context exposed to the browser (`context.expose` in createVisualNext). */
+export function useVisual() {
+    return useContext(VisualClientContext).context;
+}
+const store = new Map();
+const notify = (e) => e.listeners.forEach((l) => l());
+function entry(handle) {
+    let e = store.get(handle.$vpSource);
+    if (!e) {
+        e = { status: "idle", source: handle.source, listeners: new Set() };
+        store.set(handle.$vpSource, e);
+    }
+    return e;
+}
+function fetchEntry(token, e, endpoint) {
+    if (e.promise)
+        return e.promise;
+    e.status = "loading";
+    notify(e);
+    e.promise = fetch(endpoint, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ handle: token }), credentials: "same-origin" })
+        .then(async (r) => {
+        const j = (await r.json().catch(() => ({})));
+        if (!r.ok)
+            throw new Error(j.error ?? `HTTP ${r.status}`);
+        e.status = "success";
+        e.data = j.data;
+        e.error = undefined;
+    })
+        .catch((x) => { e.status = "error"; e.error = x instanceof Error ? x.message : String(x); })
+        .finally(() => { e.promise = undefined; notify(e); });
+    return e.promise;
+}
+if (typeof window !== "undefined") {
+    // Actions that changed data (ADR-048 P4) name the sources to reload.
+    window.addEventListener("vp:sources-changed", (ev) => {
+        const names = ev.detail?.names ?? [];
+        for (const [token, e] of store)
+            if (names.includes(e.source) && e.status !== "idle")
+                void fetchEntry(token, e, e.endpoint ?? "/api/visual/sources");
+    });
+}
+/**
+ * Data of a `load: "client"` source, given the handle your component received through `needs`.
+ * when: "load" (default) fetches after hydration, "idle" when the browser is idle, "visible" when `ref`
+ * scrolls into view, "interaction" only when you call `load()`.
+ */
+export function useVisualSource(handle) {
+    const { endpoint } = useContext(VisualClientContext);
+    const e = handle ? entry(handle) : null;
+    if (e)
+        e.endpoint = endpoint;
+    const subscribe = useCallback((l) => { if (!e)
+        return () => { }; e.listeners.add(l); return () => { e.listeners.delete(l); }; }, [e]);
+    const snap = useSyncExternalStore(subscribe, () => (e ? `${e.status}:${e.error ?? ""}` : "none"), () => "idle:");
+    const load = useCallback(() => { if (handle && e && e.status !== "success")
+        void fetchEntry(handle.$vpSource, e, endpoint); }, [handle, e, endpoint]);
+    const refresh = useCallback(() => { if (handle && e)
+        void fetchEntry(handle.$vpSource, e, endpoint); }, [handle, e, endpoint]);
+    const observer = useRef(null);
+    const ref = useCallback((el) => {
+        observer.current?.disconnect();
+        if (!el || handle?.when !== "visible")
+            return;
+        observer.current = new IntersectionObserver((entries) => { if (entries.some((x) => x.isIntersecting)) {
+            observer.current?.disconnect();
+            load();
+        } }, { rootMargin: "200px" });
+        observer.current.observe(el);
+    }, [handle?.when, load]);
+    useEffect(() => {
+        if (!handle || !e || e.status !== "idle")
+            return;
+        if (handle.when === "load")
+            load();
+        else if (handle.when === "idle") {
+            const ric = window.requestIdleCallback;
+            if (ric)
+                ric(load);
+            else
+                setTimeout(load, 200);
+        }
+    }, [handle, e, load]);
+    void snap;
+    return { data: e?.data, error: e?.error, loading: e?.status === "loading" || (e?.status === "idle" && handle?.when === "load"), load, refresh, ref };
+}
+/** Listens for "refresh" steps and changed sources after actions (ADR-048 P4) and refreshes server data. */
+export function VisualRefresh() {
+    const router = useRouter();
+    useEffect(() => {
+        const on = () => router.refresh();
+        window.addEventListener("vp:refresh", on);
+        window.addEventListener("vp:sources-changed", on);
+        return () => { window.removeEventListener("vp:refresh", on); window.removeEventListener("vp:sources-changed", on); };
+    }, [router]);
+    return null;
+}
+/** Development only: which sources this render resolved, how long they took, cache hits (ADR-048 P5). */
+export function VisualDebug(p) {
+    const [open, setOpen] = useState(false);
+    if (!p.stats.length && !p.dynamic.length)
+        return null;
+    const color = { hit: "#16a34a", memo: "#16a34a", value: "#6b7280", miss: "#d97706", private: "#7c3aed", client: "#2563eb", stream: "#2563eb", skipped: "#9ca3af", error: "#dc2626" };
+    return createElement("div", { "data-vp-debug": "", style: { position: "fixed", insetInlineEnd: 12, bottom: 12, zIndex: 2147483001, font: "12px/1.4 ui-monospace, Menlo, monospace" } }, createElement("button", { type: "button", onClick: () => setOpen((o) => !o), style: { background: "#111827", color: "#fff", border: 0, borderRadius: 6, padding: "6px 10px", cursor: "pointer" } }, `visual · ${p.stats.length} source${p.stats.length === 1 ? "" : "s"}${p.dynamic.length ? " · dynamic" : ""}`), open ? createElement("div", { style: { marginTop: 6, background: "#fff", color: "#111827", border: "1px solid #e5e7eb", borderRadius: 8, padding: 10, maxWidth: 420, boxShadow: "0 8px 24px rgba(0,0,0,.15)" } }, createElement("div", { style: { fontWeight: 600, marginBottom: 6 } }, p.page), p.dynamic.length ? createElement("div", { style: { color: "#7c3aed", marginBottom: 6 } }, `renders per visitor: ${p.dynamic.join(", ")}`) : null, ...p.stats.map((s, i) => createElement("div", { key: i, style: { display: "flex", gap: 8, justifyContent: "space-between" } }, createElement("span", null, s.input.startsWith("$need:") ? `needs → ${s.source}` : s.input === s.source ? s.input : `${s.input} ← ${s.source}`), createElement("span", { style: { color: color[s.cache] } }, `${s.cache}${s.ms ? ` · ${s.ms} ms` : ""}`)))) : null);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"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"}