@mohasinac/appkit 2.8.9 → 3.0.0

package/dist/react/hooks/usePendingTable.js

@@ -13,7 +13,7 @@ import { usePendingFilters } from "./usePendingFilters";
  * @example
  * ```tsx
  * const { pendingTable, filterActiveCount, onFilterApply, onFilterClear } =
- *   usePendingTable(table, ['status', 'category', 'minPrice', 'maxPrice']);
+ * usePendingTable(table, ['status', 'category', 'minPrice', 'maxPrice']);
  *
  * // Pass pendingTable directly to any *Filters component:
  * filterContent={<ProductFilters table={pendingTable} showStatus />}

package/dist/react/hooks/usePullToRefresh.d.ts

@@ -24,14 +24,14 @@ export interface UsePullToRefreshReturn {
  * @example
  * ```tsx
  * const { containerRef, isPulling, progress } = usePullToRefresh(async () => {
- *   await refetchOrders();
+ * await refetchOrders();
  * });
  *
  * return (
- *   <div ref={containerRef} className="overflow-y-auto">
- *     {isPulling && <PullIndicator progress={progress} />}
- *     {…}
- *   </div>
+ * <div ref={containerRef} className="overflow-y-auto">
+ * {isPulling && <PullIndicator progress={progress} />}
+ * {…}
+ * </div>
  * );
  * ```
  */

package/dist/react/hooks/usePullToRefresh.js

@@ -13,14 +13,14 @@ import { useRef, useState, useCallback, useEffect } from "react";
  * @example
  * ```tsx
  * const { containerRef, isPulling, progress } = usePullToRefresh(async () => {
- *   await refetchOrders();
+ * await refetchOrders();
  * });
  *
  * return (
- *   <div ref={containerRef} className="overflow-y-auto">
- *     {isPulling && <PullIndicator progress={progress} />}
- *     {…}
- *   </div>
+ * <div ref={containerRef} className="overflow-y-auto">
+ * {isPulling && <PullIndicator progress={progress} />}
+ * {…}
+ * </div>
  * );
  * ```
  */

package/dist/react/hooks/useRealtimeEvent.d.ts

@@ -1,3 +1,4 @@
+import type { JsonValue } from "../../schemas/types";
 import { type IClientRealtimeProvider } from "../../contracts/client-realtime";
 export declare const RealtimeEventType: {
     readonly AUTH: "auth";
@@ -25,7 +26,7 @@ export declare const RTDBPayloadStatus: {
 export interface RTDBEventPayload {
     status: (typeof RTDBPayloadStatus)[keyof typeof RTDBPayloadStatus];
     error?: string;
-    [key: string]: unknown;
+    [key: string]: JsonValue | undefined;
 }
 export interface RealtimeEventMessages {
     tokenFailure?: string;

package/dist/react/hooks/useRealtimeEvent.js

@@ -1,4 +1,5 @@
 "use client";
+import { normalizeError } from "../../errors/normalize";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { getClientRealtimeProvider, } from "../../contracts/client-realtime";
 export const RealtimeEventType = {
@@ -68,6 +69,7 @@ export function useRealtimeEvent(config) {
                 await provider.signInWithToken(customToken);
             }
             catch (authErr) {
+                void normalizeError(authErr);
                 onLogError?.(`useRealtimeEvent[${type}]: custom token sign-in failed`, authErr);
                 setError(msg.tokenFailure);
                 setStatus(RealtimeEventStatus.FAILED);

package/dist/react/hooks/useSwipe.d.ts

@@ -43,9 +43,9 @@ export interface UseSwipeOptions {
  * const ref = useRef<HTMLDivElement>(null);
  *
  * useSwipe(ref, {
- *   onSwipeLeft: () => console.log('Swiped left'),
- *   onSwipeRight: () => console.log('Swiped right'),
- *   minSwipeDistance: 100,
+ * onSwipeLeft: () => console.log('Swiped left'),
+ * onSwipeRight: () => console.log('Swiped right'),
+ * minSwipeDistance: 100,
  * });
  *
  * return <div ref={ref}>Swipe me!</div>;

package/dist/react/hooks/useSwipe.js

@@ -14,9 +14,9 @@ import { useRef, useEffect } from "react";
  * const ref = useRef<HTMLDivElement>(null);
  *
  * useSwipe(ref, {
- *   onSwipeLeft: () => console.log('Swiped left'),
- *   onSwipeRight: () => console.log('Swiped right'),
- *   minSwipeDistance: 100,
+ * onSwipeLeft: () => console.log('Swiped left'),
+ * onSwipeRight: () => console.log('Swiped right'),
+ * minSwipeDistance: 100,
  * });
  *
  * return <div ref={ref}>Swipe me!</div>;

package/dist/react/hooks/useUrlTable.js

@@ -18,11 +18,11 @@
  * const table = useUrlTable({ defaults: { pageSize: '25', sort: '-createdAt' } });
  *
  * // Read
- * table.get('status')        // string | ''
+ * table.get('status') // string | ''
  * table.getNumber('page', 1) // number
  *
  * // Write
- * table.set('status', 'active')   // resets page → 1
+ * table.set('status', 'active') // resets page → 1
  * table.setPage(3)
  * table.setSort('-price')
  * table.setMany({ status: 'active', role: 'seller' })

package/dist/react/index.d.ts

@@ -17,8 +17,6 @@ export { useSwipe } from "./hooks/useSwipe";
 export type { SwipeDirection, UseSwipeOptions } from "./hooks/useSwipe";
 export { usePullToRefresh } from "./hooks/usePullToRefresh";
 export type { UsePullToRefreshOptions, UsePullToRefreshReturn, } from "./hooks/usePullToRefresh";
-export { ThemeProvider, useTheme } from "./contexts/ThemeContext";
-export type { ThemeMode } from "./contexts/ThemeContext";
 export { SessionProvider, useSession, useAuth, } from "./contexts/SessionContext";
 export type { SessionUser, SessionContextValue, SessionEndpoints, SessionProviderProps, AvatarMetadataShape, InvalidateQueriesFn, } from "./contexts/SessionContext";
 export { useCountdown } from "./hooks/useCountdown";

package/dist/react/index.js

@@ -15,8 +15,8 @@ export { useLongPress } from "./hooks/useLongPress";
 export { useGesture } from "./hooks/useGesture";
 export { useSwipe } from "./hooks/useSwipe";
 export { usePullToRefresh } from "./hooks/usePullToRefresh";
-// Contexts
-export { ThemeProvider, useTheme } from "./contexts/ThemeContext";
+// Contexts — ThemeProvider/useTheme/ThemeMode moved to "@mohasinac/appkit/client"
+// (registry-aware ThemeProvider lives in _internal/client/theme).
 export { SessionProvider, useSession, useAuth, } from "./contexts/SessionContext";
 // Timer / countdown
 export { useCountdown } from "./hooks/useCountdown";

package/dist/react/useModalStack.d.ts

@@ -15,7 +15,7 @@ export interface ModalEntry<T = unknown> {
  * // open a modal with optional payload:
  * <Button onClick={() => open("review-modal", review)}>Write Review</Button>
  *
- * const active = peek();          // { id: "review-modal", data: review }
+ * const active = peek(); // { id: "review-modal", data: review }
  * const visible = isOpen("review-modal");
  * ```
  */

package/dist/react/useModalStack.js

@@ -14,7 +14,7 @@ import { useCallback, useRef, useState } from "react";
  * // open a modal with optional payload:
  * <Button onClick={() => open("review-modal", review)}>Write Review</Button>
  *
- * const active = peek();          // { id: "review-modal", data: review }
+ * const active = peek(); // { id: "review-modal", data: review }
  * const visible = isOpen("review-modal");
  * ```
  */

package/dist/schemas/api-routes.d.ts

@@ -0,0 +1,7 @@
+import type { ApiRouteSchema } from "./types";
+export declare const postApiWishlist: ApiRouteSchema;
+export declare const postApiAuthSession: ApiRouteSchema;
+export declare const postApiAdminProductsIdGroup: ApiRouteSchema;
+export declare const postApiMediaSign: ApiRouteSchema;
+export declare const postApiMediaFinalize: ApiRouteSchema;
+export declare const getApiSearchSuggestions: ApiRouteSchema;

package/dist/schemas/api-routes.js

@@ -0,0 +1,66 @@
+// [SCHEMA] Centrally-registered API route schemas (W4).
+//
+// Each entry maps an HTTP-verb-and-path key to its `{ body?, query?, params?,
+// response? }` Zod bundle. Consumed by `createRouteHandler` when the route
+// is bound via a key string instead of a direct schema:
+//
+//   export const POST = createRouteHandler({
+//     schema: "POST /api/wishlist",
+//     handler: async ({ body }) => { ... },
+//   });
+//
+// The audit `audit-route-schema-registry` cross-checks this map against
+// `src/app/api/**/route.ts` filesystem and blocks drift (W8).
+//
+// W4 ships a small seed cohort (the routes flagged by the boundary inventory
+// as the highest unknown-leakage offenders). W5–W7 will register the rest.
+import { z } from "zod";
+// ── POST /api/wishlist ────────────────────────────────────────────────────────
+export const postApiWishlist = {
+    body: z.object({
+        productId: z.string().min(1),
+    }),
+};
+// ── POST /api/auth/session ───────────────────────────────────────────────────
+export const postApiAuthSession = {
+    body: z.object({
+        idToken: z.string().min(1),
+    }),
+};
+// ── POST /api/admin/products/[id]/group ──────────────────────────────────────
+export const postApiAdminProductsIdGroup = {
+    body: z.object({
+        groupTitle: z.string().min(1).max(120),
+    }),
+    params: z.object({
+        id: z.string().min(1),
+    }),
+};
+// ── POST /api/media/sign ──────────────────────────────────────────────────────
+export const postApiMediaSign = {
+    body: z.object({
+        contentType: z.string().min(1),
+        filename: z.string().min(1),
+        slug: z.string().min(1),
+        size: z.number().int().positive(),
+    }),
+    response: z.object({
+        uploadUrl: z.string().url(),
+        publicUrl: z.string(),
+    }),
+};
+// ── POST /api/media/finalize ──────────────────────────────────────────────────
+export const postApiMediaFinalize = {
+    body: z.object({
+        slug: z.string().min(1),
+        size: z.number().int().positive(),
+    }),
+};
+// ── GET /api/search/suggestions ──────────────────────────────────────────────
+export const getApiSearchSuggestions = {
+    query: z.object({
+        q: z.string().min(1).max(200),
+        type: z.enum(["products", "stores", "categories", "brands"]).optional(),
+        limit: z.coerce.number().int().min(1).max(50).optional(),
+    }),
+};

package/dist/schemas/firestore-helpers.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+/**
+ * Firestore date — accepts a `Date` instance OR an ISO-8601 string.
+ * Use this for every `createdAt`/`updatedAt`/`*At` field in a Firestore doc.
+ */
+export declare const firestoreDateSchema: z.ZodUnion<[z.ZodDate, z.ZodString, z.ZodObject<{
+    toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+}, z.ZodTypeAny, "passthrough">>]>;
+/** Common audit fields on every Firestore document. */
+export declare const auditTimestampsShape: {
+    readonly createdAt: z.ZodUnion<[z.ZodDate, z.ZodString, z.ZodObject<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">>]>;
+    readonly updatedAt: z.ZodUnion<[z.ZodDate, z.ZodString, z.ZodObject<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+        toDate: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodDate>;
+    }, z.ZodTypeAny, "passthrough">>]>;
+};
+/** Money amount in paise — positive integer. */
+export declare const paiseSchema: z.ZodNumber;
+/** ISO currency code (we use "INR" everywhere). */
+export declare const currencyCodeSchema: z.ZodString;
+/** Slug — kebab-case identifier with prefix. */
+export declare const slugSchema: z.ZodString;

package/dist/schemas/firestore-helpers.js

@@ -0,0 +1,29 @@
+// [SCHEMA] Shared Zod helpers used by every per-feature firestore.ts schema.
+//
+// Firestore reads return field values as `Date` (when using `withConverter`)
+// but seed code and some action surfaces accept ISO strings. Standardising
+// here keeps each per-feature schema lean.
+import { z } from "zod";
+/**
+ * Firestore date — accepts a `Date` instance OR an ISO-8601 string.
+ * Use this for every `createdAt`/`updatedAt`/`*At` field in a Firestore doc.
+ */
+export const firestoreDateSchema = z.union([
+    z.date(),
+    z.string().datetime({ offset: true }),
+    // Firestore Timestamp shape (firebase-admin/firestore).
+    z.object({
+        toDate: z.function().returns(z.date()),
+    }).passthrough(),
+]);
+/** Common audit fields on every Firestore document. */
+export const auditTimestampsShape = {
+    createdAt: firestoreDateSchema,
+    updatedAt: firestoreDateSchema,
+};
+/** Money amount in paise — positive integer. */
+export const paiseSchema = z.number().int().nonnegative();
+/** ISO currency code (we use "INR" everywhere). */
+export const currencyCodeSchema = z.string().length(3);
+/** Slug — kebab-case identifier with prefix. */
+export const slugSchema = z.string().min(1);

package/dist/schemas/index.d.ts

@@ -0,0 +1,3 @@
+export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./registry";
+export type { SchemasShape, RegisteredApiRouteKey, RegisteredFirestoreCollection, RegisteredFormId, RegisteredSieveCollection, RegisteredWebhookProvider, RegisteredRtdbChannel, RegisteredStorageOp, } from "./registry";
+export type { ApiRouteKey, ApiRouteSchema, FirestoreDocument, FirestoreValue, FormFieldValue, FormValues, HttpVerb, JsonArray, JsonObject, JsonObjectWithUndefined, JsonPrimitive, JsonValue, JsonValueWithUndefined, RegistryEntry, SchemaRegistry, WebhookSchemaBucket, } from "./types";

package/dist/schemas/index.js

@@ -0,0 +1,6 @@
+// [SCHEMA] Central schema registry — barrel.
+//
+// Public entry for the `SCHEMAS` registry, registry types, and lookup helpers.
+// Per-feature schemas remain in `features/<f>/schemas/index.ts`; the registry
+// composes them in `./registry.ts`.
+export { SCHEMAS, lookupApiSchema, lookupFirestoreSchema, } from "./registry";