@mohasinac/appkit 3.2.8 → 3.2.10

package/dist/http/retry.js

@@ -0,0 +1,26 @@
+/** Exponential-backoff retry for idempotent async operations.
+ *
+ * Use for GCS / Firestore transient errors (429, 503) where retrying is safe.
+ * Do NOT use for non-idempotent writes unless the underlying operation is
+ * already idempotent (e.g. Firestore set-with-merge at a known document path).
+ *
+ * @param fn         Async operation to attempt.
+ * @param retries    Number of additional attempts after the first (default 2 → up to 3 total).
+ * @param baseDelayMs  Base delay before first retry; doubles each attempt (default 200ms).
+ */
+import { normalizeError } from "../errors/normalize";
+export async function withRetry(fn, retries = 2, baseDelayMs = 200) {
+    let lastErr;
+    for (let attempt = 0; attempt <= retries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastErr = normalizeError(err);
+            if (attempt < retries) {
+                await new Promise((res) => setTimeout(res, baseDelayMs * 2 ** attempt));
+            }
+        }
+    }
+    throw lastErr;
+}

package/dist/index.d.ts

@@ -586,6 +586,8 @@ export type { ProductTemplateDocument, ProductTemplateCreateInput, ProductTempla
 export { tokenRepository } from "./repositories/index";
 export { userRepository } from "./repositories/index";
 export { wishlistRepository } from "./repositories/index";
+export { MediaAssetsRepository, mediaAssetsRepository } from "./repositories/index";
+export type { MediaAssetDocument, MediaAssetCreateInput } from "./repositories/index";
 export { GroupedListingsRepository, groupedListingsRepository } from "./repositories/index";
 export type { NewsletterListModel } from "./repositories/index";
 export type { WishlistItem } from "./repositories/index";
@@ -3212,5 +3214,7 @@ export { SellerLiveView } from "./features/seller/components/SellerLiveView";
 export type { SellerLiveViewProps } from "./features/seller/components/SellerLiveView";
 export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./schemas/index";
 export type { ApiRouteKey, ApiRouteSchema, FirestoreDocument, FirestoreValue, FormFieldValue, FormValues, HttpVerb, JsonArray, JsonObject, JsonObjectWithUndefined, JsonPrimitive, JsonValue, JsonValueWithUndefined, RegisteredApiRouteKey, RegisteredFirestoreCollection, RegisteredFormId, RegisteredRtdbChannel, RegisteredSieveCollection, RegisteredStorageOp, RegisteredWebhookProvider, RegistryEntry, SchemaRegistry, SchemasShape, WebhookSchemaBucket, } from "./schemas/index";
+export { safeFireAndForget } from "./utils/safe-fire-forget";
+export { withRetry } from "./http/retry";
 export { normalizeError, getErrorMessage, isApiNormalized, isAppNormalized, isFirebaseAuthNormalized, isFirebaseFirestoreNormalized, isFirebaseStorageNormalized, isNativeNormalized, isNetworkNormalized, isUnknownNormalized, isZodNormalized, } from "./errors/normalize";
 export type { NormalizedError, NormalizedApiError, NormalizedAppError, NormalizedFirebaseAuthError, NormalizedFirebaseFirestoreError, NormalizedFirebaseStorageError, NormalizedNativeError, NormalizedNetworkError, NormalizedUnknownThrownValue, NormalizedZodError, } from "./errors/normalize";

package/dist/index.js

@@ -1170,6 +1170,8 @@ export { userRepository } from "./repositories/index";
 // [DB]-Database layer â€" uses firebase-admin or another server-side DB SDK; can only run in a trusted server environment.
 // wishlistRepository - Shared export for wishlist repository.
 export { wishlistRepository } from "./repositories/index";
+// [DB]-Database layer — mediaAssetsRepository for SEO-friendly /media/{shortId} URL mapping.
+export { MediaAssetsRepository, mediaAssetsRepository } from "./repositories/index";
 export { GroupedListingsRepository, groupedListingsRepository } from "./repositories/index";
 // ./seed/index
 // [SERVER-ONLY]-Server-only â€" uses Node.js, Next.js server internals, or third-party server SDKs (auth, email, payment, shipping).
@@ -5660,6 +5662,12 @@ export { SellerLiveView } from "./features/seller/components/SellerLiveView";
 // Per-feature `schemas/index.ts` files register into the relevant bucket.
 // Pure Zod, isomorphic — safe on both client and server.
 export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./schemas/index";
+// ── Fire-and-forget safety wrapper ─────────────────────────────────────────
+// Replaces .catch(console.error) for non-critical background operations.
+export { safeFireAndForget } from "./utils/safe-fire-forget";
+// ── Exponential-backoff retry ───────────────────────────────────────────────
+// Use for GCS / Firestore transient errors where retrying is safe.
+export { withRetry } from "./http/retry";
 // ── W3 catch-clause normalizer ──────────────────────────────────────────────
 // Every catch (e: unknown) funnels through normalizeError(e) which returns
 // a NormalizedError discriminated union. Audit-catch-normalize enforces this.

package/dist/next/ErrorBoundary.js

@@ -4,7 +4,7 @@ import { Component } from "react";
 import { Button } from "../ui/components/Button";
 import { Heading, Text } from "../ui/components/Typography";
 function DefaultFallback({ error, onReset, }) {
-    return (_jsxs("div", { className: "flex min-h-[40vh] flex-col items-center justify-center gap-4 rounded-xl border border-zinc-200 bg-white p-6 text-center dark:border-slate-700 dark:bg-slate-900", "data-section": "errorboundary-div-445", children: [_jsx(Heading, { level: 2, children: "Something went wrong" }), _jsx(Text, { variant: "secondary", children: "An unexpected error occurred. Please try again." }), process.env.NODE_ENV === "development" && error ? (_jsx("pre", { className: "max-w-full overflow-auto rounded-md bg-zinc-100 p-3 text-left text-xs dark:bg-slate-800", children: error.message })) : null, _jsx(Button, { type: "button", onClick: onReset, children: "Try again" })] }));
+    return (_jsxs("div", { className: "flex min-h-[40vh] flex-col items-center justify-center gap-4 rounded-xl border border-zinc-200 bg-[var(--appkit-color-surface)] p-6 text-center border-[var(--appkit-color-border)] bg-[var(--appkit-color-surface)]", "data-section": "errorboundary-div-445", children: [_jsx(Heading, { level: 2, children: "Something went wrong" }), _jsx(Text, { variant: "secondary", children: "An unexpected error occurred. Please try again." }), process.env.NODE_ENV === "development" && error ? (_jsx("pre", { className: "max-w-full overflow-auto rounded-md bg-[var(--appkit-color-surface)] p-3 text-left text-xs bg-[var(--appkit-color-surface-elevated)]", children: error.message })) : null, _jsx(Button, { type: "button", onClick: onReset, children: "Try again" })] }));
 }
 export class ErrorBoundary extends Component {
     constructor(props) {

package/dist/providers/storage-firebase/provider.js

@@ -20,6 +20,9 @@
  * ```
  */
 import { getAdminStorageLite } from "../db-firebase/admin-storage-lite";
+import { withRetry } from "../../http/retry";
+import { normalizeError } from "../../errors/normalize";
+import { serverLogger } from "../../monitoring/server-logger";
 function getBucket() {
     const bucketName = process.env.FIREBASE_ADMIN_STORAGE_BUCKET?.trim() ??
         process.env.NEXT_PUBLIC_FIREBASE_STORAGE_BUCKET?.trim();
@@ -29,75 +32,126 @@ function getBucket() {
 }
 export const firebaseStorageProvider = {
     async upload(file, storagePath, options) {
-        const bucket = getBucket();
-        const fileRef = bucket.file(storagePath);
-        await fileRef.save(file, {
-            metadata: {
-                contentType: options?.contentType ?? "application/octet-stream",
-                cacheControl: options?.cacheControl ?? "public, max-age=31536000",
-                metadata: options?.metadata ?? {},
-            },
-            public: options?.isPublic !== false,
-        });
-        const [metadata] = await fileRef.getMetadata();
-        const url = options?.isPublic !== false
-            ? `https://storage.googleapis.com/${bucket.name}/${storagePath}`
-            : await fileRef
-                .getSignedUrl({
-                action: "read",
-                expires: Date.now() + 60 * 60 * 1000, // 1 hour
-            })
-                .then(([u]) => u);
-        return {
-            path: storagePath,
-            url,
-            contentType: metadata.contentType,
-            size: Number(metadata.size),
-            updatedAt: metadata.updated,
-        };
+        try {
+            const bucket = getBucket();
+            const fileRef = bucket.file(storagePath);
+            await withRetry(() => fileRef.save(file, {
+                metadata: {
+                    contentType: options?.contentType ?? "application/octet-stream",
+                    cacheControl: options?.cacheControl ?? "public, max-age=31536000",
+                    metadata: options?.metadata ?? {},
+                },
+                public: options?.isPublic !== false,
+            }), 2, 300);
+            const [metadata] = await withRetry(() => fileRef.getMetadata(), 2, 300);
+            const url = options?.isPublic !== false
+                ? `https://storage.googleapis.com/${bucket.name}/${storagePath}`
+                : await withRetry(() => fileRef
+                    .getSignedUrl({
+                    action: "read",
+                    expires: Date.now() + 60 * 60 * 1000,
+                })
+                    .then(([u]) => u), 2, 300);
+            return {
+                path: storagePath,
+                url,
+                contentType: metadata.contentType,
+                size: Number(metadata.size),
+                updatedAt: metadata.updated,
+            };
+        }
+        catch (err) {
+            void normalizeError(err);
+            serverLogger.error("storage-provider: upload failed", {
+                storagePath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
     },
     async delete(storagePath) {
-        await getBucket().file(storagePath).delete({ ignoreNotFound: true });
+        try {
+            await withRetry(() => getBucket().file(storagePath).delete({ ignoreNotFound: true }), 2, 300);
+        }
+        catch (err) {
+            void normalizeError(err);
+            serverLogger.error("storage-provider: delete failed", {
+                storagePath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
     },
     getPublicUrl(storagePath) {
         const bucket = getBucket();
         return `https://storage.googleapis.com/${bucket.name}/${storagePath}`;
     },
     async getSignedUrl(storagePath, expiresInSeconds = 3600) {
-        const [url] = await getBucket()
-            .file(storagePath)
-            .getSignedUrl({
-            action: "read",
-            expires: Date.now() + expiresInSeconds * 1000,
-        });
-        return url;
+        try {
+            const [url] = await withRetry(() => getBucket()
+                .file(storagePath)
+                .getSignedUrl({
+                action: "read",
+                expires: Date.now() + expiresInSeconds * 1000,
+            }), 2, 300);
+            return url;
+        }
+        catch (err) {
+            void normalizeError(err);
+            serverLogger.error("storage-provider: getSignedUrl failed", {
+                storagePath,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
     },
     async copy(from, to) {
-        const bucket = getBucket();
-        const src = bucket.file(from);
-        const dest = bucket.file(to);
-        await src.copy(dest);
-        const [metadata] = await dest.getMetadata();
-        return {
-            path: to,
-            url: `https://storage.googleapis.com/${bucket.name}/${to}`,
-            contentType: metadata.contentType,
-            size: Number(metadata.size),
-            updatedAt: metadata.updated,
-        };
-    },
-    async list(prefix) {
-        const bucket = getBucket();
-        const [files] = await bucket.getFiles({ prefix });
-        return Promise.all(files.map(async (f) => {
-            const [metadata] = await f.getMetadata();
+        try {
+            const bucket = getBucket();
+            const src = bucket.file(from);
+            const dest = bucket.file(to);
+            await withRetry(() => src.copy(dest), 2, 300);
+            const [metadata] = await withRetry(() => dest.getMetadata(), 2, 300);
             return {
-                path: f.name,
-                url: `https://storage.googleapis.com/${bucket.name}/${f.name}`,
+                path: to,
+                url: `https://storage.googleapis.com/${bucket.name}/${to}`,
                 contentType: metadata.contentType,
                 size: Number(metadata.size),
                 updatedAt: metadata.updated,
             };
-        }));
+        }
+        catch (err) {
+            void normalizeError(err);
+            serverLogger.error("storage-provider: copy failed", {
+                from,
+                to,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
+    },
+    async list(prefix) {
+        try {
+            const bucket = getBucket();
+            const [files] = await withRetry(() => bucket.getFiles({ prefix }), 2, 300);
+            return Promise.all(files.map(async (f) => {
+                const [metadata] = await withRetry(() => f.getMetadata(), 2, 300);
+                return {
+                    path: f.name,
+                    url: `https://storage.googleapis.com/${bucket.name}/${f.name}`,
+                    contentType: metadata.contentType,
+                    size: Number(metadata.size),
+                    updatedAt: metadata.updated,
+                };
+            }));
+        }
+        catch (err) {
+            void normalizeError(err);
+            serverLogger.error("storage-provider: list failed", {
+                prefix,
+                error: err instanceof Error ? err.message : String(err),
+            });
+            throw err;
+        }
     },
 };

package/dist/repositories/index.d.ts

@@ -51,3 +51,5 @@ export { ProductFeaturesRepository, productFeaturesRepository, } from "../featur
 export type { ProductFeatureListFilter } from "../features/products/repository/product-features.repository";
 export { loadProductFeaturesForStore } from "../features/products/repository/loadProductFeatures";
 export { LotteryEntryRepository, lotteryEntryRepository, } from "../features/lottery/repository/lottery-entry.repository";
+export { MediaAssetsRepository, mediaAssetsRepository, } from "../features/media/repository/media-assets.repository";
+export type { MediaAssetDocument, MediaAssetCreateInput, } from "../features/media/repository/media-assets.repository";

package/dist/repositories/index.js

@@ -62,3 +62,5 @@ export { loadProductFeaturesForStore } from "../features/products/repository/loa
 // listByType / findBySlugAndType helpers.
 // Lottery entries repository
 export { LotteryEntryRepository, lotteryEntryRepository, } from "../features/lottery/repository/lottery-entry.repository";
+// Media assets — short ID → storagePath mapping for SEO-friendly /media/{id} URLs
+export { MediaAssetsRepository, mediaAssetsRepository, } from "../features/media/repository/media-assets.repository";