@rovela-ai/sdk 0.9.2 → 0.10.1

package/dist/media/taxonomy.js

@@ -0,0 +1,227 @@
+/**
+ * @rovela-ai/sdk/media/taxonomy
+ *
+ * Asset taxonomy — the single source of truth for classifying every R2
+ * object under `stores/{storeId}/...` into a typed `StoreAsset`. Shared by
+ * TWO surfaces that list the same storage live (no sync layer by design):
+ *
+ *   - the store admin's Files page (SDK, /admin/files)
+ *   - the Rovela platform's Assets Library (`lib/assets/categories.ts`
+ *     re-exports this module — never fork the parse logic there)
+ *
+ * Well-known prefixes:
+ *   branding/{logo|favicon}        — merchant-uploaded logos (canonical keys, no extension)
+ *   products/{...}                 — product photos
+ *   products/videos/{...}          — product videos
+ *   variants/{...}                 — variant images (admin upload folder)
+ *   categories/{...}               — category cover images (admin upload folder)
+ *   locations/{...}                — store-location images (admin upload folder)
+ *   general/{...}                  — untyped admin uploads
+ *   chat-attachments/{...}         — platform chat / library uploads (any kind)
+ *   generated/products/{...}       — AI-generated product images
+ *   generated/library/{...}        — AI-generated library images
+ *   generated/{...}                — AI-generated section images
+ *   references/{...}               — reference screenshots (system)
+ *   thumbnail.jpg                  — post-deploy store thumbnail (system)
+ *
+ * Adding a category: append the union value, define META, extend
+ * `categoryFromInnerPath` (more specific prefixes FIRST). Removing one is a
+ * fleet decision — unrecognised keys parse to `null` and are silently
+ * skipped by every list surface.
+ */
+export const CATEGORY_META = {
+    logo: { id: 'logo', label: 'Logo', origin: 'upload' },
+    favicon: { id: 'favicon', label: 'Favicon', origin: 'upload' },
+    'product-image': { id: 'product-image', label: 'Product image', origin: 'upload' },
+    'product-video': { id: 'product-video', label: 'Product video', origin: 'upload' },
+    'category-image': { id: 'category-image', label: 'Category image', origin: 'upload' },
+    'location-image': { id: 'location-image', label: 'Location image', origin: 'upload' },
+    'general-upload': { id: 'general-upload', label: 'Upload', origin: 'upload' },
+    'chat-upload': { id: 'chat-upload', label: 'Upload', origin: 'upload' },
+    'ai-generated': { id: 'ai-generated', label: 'AI image', origin: 'ai-generated' },
+    'ai-generated-product': {
+        id: 'ai-generated-product',
+        label: 'AI product image',
+        origin: 'ai-generated',
+    },
+    'ai-generated-library': {
+        id: 'ai-generated-library',
+        label: 'AI library image',
+        origin: 'ai-generated',
+    },
+    reference: { id: 'reference', label: 'Reference screenshot', origin: 'system' },
+    thumbnail: { id: 'thumbnail', label: 'Store thumbnail', origin: 'system' },
+};
+/**
+ * Categories the store ADMIN must never delete: branding assets are wired
+ * into env vars + the platform branding helpers (deleting the raw object
+ * would leave a dangling logo URL on the deployed store), and system
+ * artifacts (references, thumbnail) belong to the platform pipeline.
+ */
+export const ADMIN_PROTECTED_CATEGORIES = new Set([
+    'logo',
+    'favicon',
+    'reference',
+    'thumbnail',
+]);
+/**
+ * Media chips shared by the admin Files page and the platform Assets
+ * Library. "All" first; order is the render order.
+ */
+export const MEDIA_CHIP_FILTERS = [
+    { id: 'all', label: 'All', test: () => true },
+    { id: 'image', label: 'Images', test: (a) => a.kind === 'image' },
+    { id: 'video', label: 'Videos', test: (a) => a.kind === 'video' },
+    {
+        id: 'branding',
+        label: 'Branding',
+        test: (a) => a.category === 'logo' || a.category === 'favicon',
+    },
+    {
+        id: 'products',
+        label: 'Products',
+        test: (a) => a.category === 'product-image' || a.category === 'product-video',
+    },
+    {
+        id: 'ai',
+        label: 'AI generated',
+        test: (a) => a.category === 'ai-generated' ||
+            a.category === 'ai-generated-product' ||
+            a.category === 'ai-generated-library',
+    },
+    {
+        id: 'uploads',
+        label: 'Uploads',
+        test: (a) => a.category === 'chat-upload' ||
+            a.category === 'general-upload' ||
+            a.category === 'category-image' ||
+            a.category === 'location-image',
+    },
+    {
+        id: 'references',
+        label: 'References',
+        test: (a) => a.category === 'reference' || a.category === 'thumbnail',
+    },
+];
+// ---------------------------------------------------------------------------
+// Key parsing.
+// ---------------------------------------------------------------------------
+/**
+ * Image vs video vs other from the file extension. Mirrors the storefront's
+ * `isVideoUrl()` rule — URL-extension detection, no MIME.
+ */
+const IMAGE_EXTS = new Set([
+    'png', 'jpg', 'jpeg', 'gif', 'webp', 'svg', 'avif', 'ico', 'bmp',
+]);
+const VIDEO_EXTS = new Set(['mp4', 'webm', 'mov', 'm4v']);
+function kindFromKey(key) {
+    // Logo / favicon ship without an extension on the canonical key (R2 stores
+    // Content-Type as object metadata). Treat as images by category, not extension.
+    if (key.endsWith('/branding/logo') || key.endsWith('/branding/favicon')) {
+        return 'image';
+    }
+    const ext = key.toLowerCase().match(/\.([a-z0-9]+)$/)?.[1];
+    if (!ext)
+        return 'other';
+    if (IMAGE_EXTS.has(ext))
+        return 'image';
+    if (VIDEO_EXTS.has(ext))
+        return 'video';
+    return 'other';
+}
+/**
+ * Classify the per-store sub-path. Tests in priority order — more specific
+ * prefixes (`generated/products/`) MUST come before less specific ones
+ * (`generated/`).
+ */
+function categoryFromInnerPath(rest) {
+    if (rest === 'branding/logo')
+        return 'logo';
+    if (rest === 'branding/favicon')
+        return 'favicon';
+    if (rest === 'thumbnail.jpg')
+        return 'thumbnail';
+    if (rest.startsWith('products/videos/'))
+        return 'product-video';
+    if (rest.startsWith('products/'))
+        return 'product-image';
+    if (rest.startsWith('variants/'))
+        return 'product-image';
+    if (rest.startsWith('categories/'))
+        return 'category-image';
+    if (rest.startsWith('locations/'))
+        return 'location-image';
+    if (rest.startsWith('general/'))
+        return 'general-upload';
+    if (rest.startsWith('chat-attachments/'))
+        return 'chat-upload';
+    if (rest.startsWith('generated/products/'))
+        return 'ai-generated-product';
+    if (rest.startsWith('generated/library/'))
+        return 'ai-generated-library';
+    if (rest.startsWith('generated/'))
+        return 'ai-generated';
+    if (rest.startsWith('references/'))
+        return 'reference';
+    return null;
+}
+/**
+ * Pretty-name from the file portion of a key. Strips the leading `{digits}_`
+ * collision-buster used by upload routes. Canonical branding / thumbnail
+ * paths get hardcoded labels; references keep their `ref-N.jpg` shape.
+ */
+function displayName(category, rest) {
+    if (category === 'logo')
+        return 'Logo';
+    if (category === 'favicon')
+        return 'Favicon';
+    if (category === 'thumbnail')
+        return 'Store thumbnail';
+    const leaf = rest.split('/').pop() ?? rest;
+    if (category === 'reference')
+        return leaf;
+    return leaf.replace(/^\d+_/, '');
+}
+/**
+ * Parse one R2 object into a StoreAsset. Returns `null` for keys outside
+ * the `stores/{id}/` namespace or with unknown prefixes — callers SKIP
+ * nulls so stray objects never surface.
+ */
+export function parseAssetKey({ key, size, lastModified, publicUrlBase, }) {
+    const m = key.match(/^stores\/([^/]+)\/(.+)$/);
+    if (!m)
+        return null;
+    const projectId = m[1];
+    const rest = m[2];
+    const category = categoryFromInnerPath(rest);
+    if (!category)
+        return null;
+    const iso = lastModified instanceof Date
+        ? lastModified.toISOString()
+        : new Date(lastModified).toISOString();
+    return {
+        key,
+        projectId,
+        category,
+        url: `${publicUrlBase.replace(/\/$/, '')}/${key}`,
+        name: displayName(category, rest),
+        size,
+        lastModified: iso,
+        kind: kindFromKey(key),
+        origin: CATEGORY_META[category].origin,
+    };
+}
+/**
+ * Branding-key sniffer — 'logo' / 'favicon' / null. Used by the platform's
+ * generic DELETE route to forward to the branding handlers (which also clear
+ * `blueprint.store.{logo|favicon}Url` + PATCH Vercel envs).
+ */
+export function brandingKindFromKey(key) {
+    const m = key.match(/^stores\/[^/]+\/branding\/(logo|favicon)$/);
+    return m ? m[1] : null;
+}
+/** Authz guard: confirms a key belongs to the given store/project. */
+export function keyBelongsToProject(key, projectId) {
+    return key.startsWith(`stores/${projectId}/`);
+}
+//# sourceMappingURL=taxonomy.js.map

package/dist/media/taxonomy.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rovela-ai/sdk",
-  "version": "0.9.2",
+  "version": "0.10.1",
   "description": "Rovela SDK - Pre-built e-commerce components for AI-powered store generation",
   "type": "module",
   "license": "MIT",
@@ -264,6 +264,10 @@
       "types": "./dist/media/server/index.d.ts",
       "import": "./dist/media/server/index.js"
     },
+    "./media/taxonomy": {
+      "types": "./dist/media/taxonomy.d.ts",
+      "import": "./dist/media/taxonomy.js"
+    },
     "./media/api": {
       "types": "./dist/media/api/index.d.ts",
       "import": "./dist/media/api/index.js"