@pixldocs/canvas-renderer 0.5.165 → 0.5.167

package/README.md

@@ -8,7 +8,85 @@ Client-side template renderer for Pixldocs — render templates in any web app w
 npm install @pixldocs/canvas-renderer fabric react react-dom
 ```
 
-> **Private package**: Add `//registry.npmjs.org/:_authToken=${NPM_TOKEN}` to your `.npmrc` and configure `NPM_TOKEN` as a build secret.
+> Public package — no auth token or `.npmrc` needed.
+
+---
+
+## Quick Start: Build an App From a Workspace
+
+Got a Pixldocs workspace full of published templates (e.g. social-media posts,
+invitations, certificates)? You can spin up a standalone app that lists and
+renders them with just the **workspace ID** + Pixldocs anon key — no per-template
+wiring needed.
+
+```tsx
+import {
+  listPublishedTemplates,
+  PixldocsRenderer,
+} from '@pixldocs/canvas-renderer';
+
+const SUPABASE_URL = 'https://ttvtjhxjxuxdeybcnjkd.supabase.co';
+const SUPABASE_ANON_KEY = 'eyJ...'; // Pixldocs publishable key (safe in browser)
+const WORKSPACE_ID = 'your-workspace-uuid';
+
+// 1. List all published templates owned by a workspace
+const templates = await listPublishedTemplates({
+  workspaceId: WORKSPACE_ID,
+  supabaseUrl: SUPABASE_URL,
+  supabaseAnonKey: SUPABASE_ANON_KEY,
+  // category: 'social-media',  // optional filter
+});
+
+// templates: [{ id, name, thumbnail_url, category, price, ... }, ...]
+
+// 2. Render a chosen template (form-bound or static)
+const renderer = new PixldocsRenderer({
+  supabaseUrl: SUPABASE_URL,
+  supabaseAnonKey: SUPABASE_ANON_KEY,
+});
+
+const pages = await renderer.renderFromForm({
+  templateId: templates[0].id,
+  sectionState: { /* user inputs (optional for static templates) */ },
+});
+```
+
+### Two ways to source templates
+
+| Approach | Best for | API |
+|----------|----------|-----|
+| **By workspace** | Multi-template apps (template gallery, social-media post maker, certificate maker) — pick from a curated workspace | `listPublishedTemplates({ workspaceId })` |
+| **By form schema** | Single-purpose apps where one form drives many template variants (e.g. BioMaker — one form, many biodata designs) | Resolve directly via `renderFromForm({ templateId, formSchemaId, sectionState })` |
+
+Both work with the same anon key and the same renderer — choose whichever
+matches your product shape.
+
+---
+
+## Templates Catalog API
+
+### `listPublishedTemplates(options)`
+
+Returns every published template belonging to a workspace. Uses public RLS
+(no auth needed beyond the anon key).
+
+```ts
+const templates = await listPublishedTemplates({
+  workspaceId: 'uuid',
+  supabaseUrl: '...',
+  supabaseAnonKey: '...',
+  category: 'social-media',  // optional
+  limit: 200,                 // optional (default 200)
+  offset: 0,                  // optional pagination
+});
+```
+
+Each item: `{ id, name, description, category, thumbnail_url, preview_images, price, download_count, workspace_id, sort_order, created_at, updated_at }`.
+
+### `getPublishedTemplate({ templateId, supabaseUrl, supabaseAnonKey })`
+
+Fetch a single published template's catalog row (without the heavy `config`
+JSON — use the renderer for that).
 
 ---
 

package/dist/{index-CQGSjfcH.js → index-7Etfiz-e.js}

@@ -16018,9 +16018,9 @@ function captureFabricCanvasSvgForPdf(fabricInstance, canvasWidth, canvasHeight)
   }
   return svgString;
 }
-const resolvedPackageVersion = "0.5.165";
+const resolvedPackageVersion = "0.5.167";
 const PACKAGE_VERSION = resolvedPackageVersion;
-const DEPLOYMENT_VERSION_MARKER = "__PIXLDOCS_CANVAS_RENDERER_VERSION__:0.5.165";
+const DEPLOYMENT_VERSION_MARKER = "__PIXLDOCS_CANVAS_RENDERER_VERSION__:0.5.167";
 const roundParityValue = (value) => {
   if (typeof value !== "number") return value;
   return Number.isFinite(value) ? Number(value.toFixed(3)) : value;
@@ -16455,7 +16455,7 @@ class PixldocsRenderer {
         await this.waitForCanvasScene(container, cloned, i);
       }
       console.log(`[canvas-renderer][pdf-unified] mounted ${cloned.pages.length} page(s), handing off to client exportMultiPagePdf`);
-      const { exportMultiPagePdf, preparePagesForExport } = await import("./vectorPdfExport-C0lD4Sum.js");
+      const { exportMultiPagePdf, preparePagesForExport } = await import("./vectorPdfExport-Ce68BOFf.js");
       const prepared = preparePagesForExport(
         cloned.pages,
         canvasWidth,
@@ -18557,7 +18557,7 @@ async function prepareLiveCanvasSvgForPdf(rawSvg, pageWidth, pageHeight, pageKey
     if (options == null ? void 0 : options.stripPageBackground) stripRootPageBackgroundFromSvg(svgToDraw);
     sanitizeSvgTreeForPdf(svgToDraw);
     try {
-      const { bakeTextAnchorPositionsFromLiveSvg, logTextMeasurementDiagnostic } = await import("./vectorPdfExport-C0lD4Sum.js");
+      const { bakeTextAnchorPositionsFromLiveSvg, logTextMeasurementDiagnostic } = await import("./vectorPdfExport-Ce68BOFf.js");
       try {
         await logTextMeasurementDiagnostic(svgToDraw);
       } catch {
@@ -18763,6 +18763,56 @@ async function assemblePdfFromSvgs(svgResults, options = {}) {
     pages: svgResults.map((p) => ({ width: p.width, height: p.height }))
   };
 }
+const SELECT_COLUMNS = "id,name,description,category,thumbnail_url,preview_images,price,download_count,workspace_id,sort_order,created_at,updated_at";
+async function listPublishedTemplates(options) {
+  const { workspaceId, supabaseUrl, supabaseAnonKey, category, limit = 200, offset = 0 } = options;
+  if (!workspaceId) throw new Error("listPublishedTemplates: workspaceId is required");
+  if (!supabaseUrl || !supabaseAnonKey) {
+    throw new Error("listPublishedTemplates: supabaseUrl and supabaseAnonKey are required");
+  }
+  const params = new URLSearchParams({
+    select: SELECT_COLUMNS,
+    workspace_id: `eq.${workspaceId}`,
+    status: "eq.published",
+    order: "sort_order.asc,updated_at.desc",
+    limit: String(limit),
+    offset: String(offset)
+  });
+  if (category) params.set("category", `eq.${category}`);
+  const url = `${supabaseUrl.replace(/\/$/, "")}/rest/v1/templates?${params.toString()}`;
+  const res = await fetch(url, {
+    headers: {
+      apikey: supabaseAnonKey,
+      Authorization: `Bearer ${supabaseAnonKey}`,
+      Accept: "application/json"
+    }
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`listPublishedTemplates failed: ${res.status} ${text}`);
+  }
+  return await res.json();
+}
+async function getPublishedTemplate(options) {
+  const { templateId, supabaseUrl, supabaseAnonKey } = options;
+  const params = new URLSearchParams({
+    select: SELECT_COLUMNS,
+    id: `eq.${templateId}`,
+    status: "eq.published",
+    limit: "1"
+  });
+  const url = `${supabaseUrl.replace(/\/$/, "")}/rest/v1/templates?${params.toString()}`;
+  const res = await fetch(url, {
+    headers: {
+      apikey: supabaseAnonKey,
+      Authorization: `Bearer ${supabaseAnonKey}`,
+      Accept: "application/json"
+    }
+  });
+  if (!res.ok) return null;
+  const rows = await res.json();
+  return rows[0] ?? null;
+}
 function collectImageUrls(config) {
   const urls = [];
   const walk = (nodes) => {
@@ -18852,7 +18902,7 @@ function setAutoShrinkDebug(enabled) {
   }
 }
 export {
-  canvasImageLoader as $,
+  warmResolvedTemplateForPreview as $,
   API_URL as A,
   collectImageUrls as B,
   configHasAutoShrinkText$1 as C,
@@ -18865,22 +18915,24 @@ export {
   ensureFontsForResolvedConfig as J,
   extractFontFamiliesFromSvgs as K,
   getEmbeddedJsPDFFontName as L,
-  isBundledAssetUrl as M,
-  isFontAvailable as N,
-  isPrivateUrl as O,
+  getPublishedTemplate as M,
+  isBundledAssetUrl as N,
+  isFontAvailable as O,
   PACKAGE_VERSION as P,
-  loadGoogleFontCSS as Q,
-  normalizeFontFamily as R,
-  resolveFontWeight as S,
+  isPrivateUrl as Q,
+  listPublishedTemplates as R,
+  loadGoogleFontCSS as S,
   TRIANGLE_STROKE_MITER_LIMIT as T,
-  resolveFromForm as U,
-  resolveTemplateData as V,
-  rewriteSvgFontsForJsPDF as W,
-  setAutoShrinkDebug as X,
-  setBundledAssetPrefixes as Y,
-  warmResolvedTemplateForPreview as Z,
-  warmTemplateFromForm as _,
+  normalizeFontFamily as U,
+  resolveFontWeight as V,
+  resolveFromForm as W,
+  resolveTemplateData as X,
+  rewriteSvgFontsForJsPDF as Y,
+  setAutoShrinkDebug as Z,
+  setBundledAssetPrefixes as _,
   getAbsoluteBounds as a,
+  warmTemplateFromForm as a0,
+  canvasImageLoader as a1,
   getProxiedImageUrl as b,
   captureFabricCanvasSvgForPdf as c,
   bakeEdgeFade as d,
@@ -18907,4 +18959,4 @@ export {
   collectFontDescriptorsFromConfig as y,
   collectFontsFromConfig as z
 };
-//# sourceMappingURL=index-CQGSjfcH.js.map
+//# sourceMappingURL=index-7Etfiz-e.js.map