@donotdev/crud 0.0.6 → 0.0.7

package/dist/useCrud.d.ts

@@ -1,94 +1,52 @@
-import type { dndevSchema, Entity, FeatureStatus } from '@donotdev/core';
-import { type BackendType } from './CrudStore';
-import { type QueryOptions } from './CrudService';
+import type { dndevSchema, Entity, FeatureStatus, OperationSchemas, CrudAPI } from '@donotdev/core';
+import type { CrudServiceInterface, CacheOptions } from './CrudService';
+import type { BackendType } from './CrudStore';
+export declare const EMPTY_DATA: Record<string, unknown>;
+export declare const EMPTY_OPTIMISTIC: Record<string, unknown>;
+/**
+ * Get the current CrudService instance (for use in callbacks)
+ */
+export declare function getCrudServiceInstance(): CrudServiceInterface | null;
 export interface UseCrudOptions<T> {
     backend?: BackendType;
     schema?: dndevSchema<T>;
     /** Entity definition - auto-generates schema if schema not provided */
     entity?: Entity;
-    /** TanStack Query stale time in ms (default: 5 min) */
+    /** TanStack Query stale time in ms (default: Infinity) */
     staleTime?: number;
     /** Disable caching (bypass TanStack Query) */
     noCache?: boolean;
 }
 /**
- * CRUD API return type - complete interface for useCrud hook
- * Consistent with CrudAPI from @donotdev/types
+ * CRUD API return type - Single Document & Actions
+ */
+/**
+ * CRUD API return type - Single Document & Actions
  */
-export interface UseCrudReturn<T> {
-    /** Feature status: 'initializing' | 'ready' | 'degraded' | 'error' */
-    status: FeatureStatus;
-    /** Current data (from get/subscribe) */
-    data: T | null;
-    /** Loading state for async operations */
-    loading: boolean;
-    /** Last error encountered */
-    error: Error | null;
-    /** Fetch single document by ID */
-    get: (id: string) => Promise<T | null>;
-    /** Set/replace document by ID */
-    set: (id: string, data: T) => Promise<void>;
-    /** Partial update document by ID */
-    update: (id: string, data: Partial<T>) => Promise<void>;
-    /** Delete document by ID */
-    delete: (id: string) => Promise<void>;
-    /** Add new document (auto-generated ID) */
-    add: (data: T) => Promise<string>;
-    /** Query collection with filters */
-    query: (options: QueryOptions) => Promise<T[]>;
-    /** Subscribe to document changes */
-    subscribe: (id: string, callback: (data: T | null, error?: Error) => void) => () => void;
-    /** Subscribe to collection changes */
-    subscribeToCollection: (options: QueryOptions, callback: (data: T[], error?: Error) => void) => () => void;
-    /** Invalidate cache for this collection (TanStack Query) */
-    invalidate: () => Promise<void>;
-    /** Whether CRUD is available and operational (status === 'ready') */
-    isAvailable: boolean;
+export interface UseCrudReturn<T> extends CrudAPI<T> {
+    /** @internal Collection name */
+    _collection: string;
+    /** @internal Generated schemas */
+    _schemas: OperationSchemas | undefined;
+    /** @internal Cache options */
+    _cacheOptions: CacheOptions;
+    /** @internal Store data for collection */
+    _storeData: Record<string, unknown>;
 }
 /**
- * React hook for CRUD operations with lazy-loaded TanStack Query caching
- *
- * Collection-scoped hook that returns full CRUD API for a specific collection.
- * Uses unified FeatureStatus enum for lifecycle management.
- *
- * **Usage:**
- * ```typescript
- * // With entity (auto-generates schema, derives collection, defaults to 'firestore' backend)
- * const { status, data, get, set, query } = useCrud(carEntity);
+ * React hook for CRUD Actions & Single Documents
  *
- * // With entity and explicit backend
- * const { status, data, get, set, query } = useCrud(carEntity, { backend: 'functions' });
- *
- * // With collection string and entity
- * const { status, data, get, set, query } = useCrud('cars', { entity: carEntity });
- *
- * // With explicit schema
- * const { status, data, get, set, query } = useCrud('cars', { schema: CarSchema });
- *
- * // Check availability
- * if (!isAvailable) return <Degraded />;
- * if (status === 'initializing') return <Loader />;
- *
- * // Use CRUD operations
- * const car = await get('car-123');
- * await set('car-123', { make: 'Toyota', model: 'Camry' });
- * ```
- *
- * **Status values:**
- * - `initializing`: CRUD service loading
- * - `ready`: Fully operational
- * - `degraded`: Feature unavailable (no schema, no consent)
- * - `error`: Error occurred
+ * Use this hook for:
+ * - Checking feature status: `const status = useCrud('status');`
+ * - Adding, Updating, Deleting items
+ * - Fetching a single document
  *
  * @template T - Document type for this collection
- * @param entityOrCollection - Entity definition (auto-generates schema) or collection name
- * @param options - Configuration options (required if first param is collection string)
- * @returns Full CRUD API for the collection
- *
- * @version 0.0.5
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
+ * @param entityOrCollection - Entity definition or collection name
+ * @param options - Configuration options
+ * @returns CRUD Actions API
  */
+export declare function useCrud(key: 'status'): FeatureStatus;
 export declare function useCrud<T = unknown>(entity: Entity, options?: UseCrudOptions<T>): UseCrudReturn<T>;
 export declare function useCrud<T = unknown>(collection: string, options?: UseCrudOptions<T>): UseCrudReturn<T>;
 //# sourceMappingURL=useCrud.d.ts.map

package/dist/useCrud.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useCrud.d.ts","sourceRoot":"","sources":["../src/useCrud.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQzE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAoCvB,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;GAGG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC;IAC9B,sEAAsE;IACtE,MAAM,EAAE,aAAa,CAAC;IACtB,wCAAwC;IACxC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,kCAAkC;IAClC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,iCAAiC;IACjC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,oCAAoC;IACpC,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,4BAA4B;IAC5B,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,2CAA2C;IAC3C,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,oCAAoC;IACpC,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,oCAAoC;IACpC,SAAS,EAAE,CACT,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KAC9C,MAAM,IAAI,CAAC;IAChB,sCAAsC;IACtC,qBAAqB,EAAE,CACrB,OAAO,EAAE,YAAY,EACrB,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,KAAK,IAAI,KACzC,MAAM,IAAI,CAAC;IAChB,4DAA4D;IAC5D,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,qEAAqE;IACrE,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAAC;AACpB,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAAC"}
+{"version":3,"file":"useCrud.d.ts","sourceRoot":"","sources":["../src/useCrud.ts"],"names":[],"mappings":"AAwBA,OAAO,KAAK,EACV,WAAW,EACX,MAAM,EACN,aAAa,EACb,gBAAgB,EAChB,OAAO,EACR,MAAM,gBAAgB,CAAC;AAKxB,OAAO,KAAK,EAAE,oBAAoB,EAAgB,YAAY,EAAE,MAAM,eAAe,CAAC;AACtF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAC;AACtD,eAAO,MAAM,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,CAAC;AAM5D;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,oBAAoB,GAAG,IAAI,CAEpE;AAMD,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH;;GAEG;AACH,MAAM,WAAW,aAAa,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAElD,gCAAgC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kCAAkC;IAClC,QAAQ,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACvC,8BAA8B;IAC9B,aAAa,EAAE,YAAY,CAAC;IAC5B,0CAA0C;IAC1C,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACrC;AAMD;;;;;;;;;;;;GAYG;AACH,wBAAgB,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,aAAa,CAAC;AACtD,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAAC;AACpB,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B,aAAa,CAAC,CAAC,CAAC,CAAC"}

package/dist/useCrud.js

@@ -1 +1 @@
-"use client";import{useEffect as U,useMemo as _}from"react";import{DEGRADED_CRUD_API as P,FEATURE_STATUS as y,useFeatureConsent as k}from"@donotdev/core";import{FRAMEWORK_FEATURES as z,handleError as M,isClient as G}from"@donotdev/core";import{useCrudStore as l}from"./CrudStore";import{getCrudService as L}from"./CrudService";import{createEntitySchema as x}from"./forms/utils/createEntitySchema";let t=null,n=null,q=null,C=!1;const F=1e3*60*5;async function K(){if(n)return n;const{QueryClient:a}=await import("@tanstack/react-query");return n=new a({defaultOptions:{queries:{staleTime:F,gcTime:1e3*60*30,retry:1,refetchOnWindowFocus:!1}}}),n}function Z(a,s={}){const f=k(z.CRUD),m=typeof a=="object"?a:s.entity,r=typeof a=="string"?a:a.collection,d=s.backend||"firestore",D=s.staleTime??F,c=s.noCache??!1,u=_(()=>{if(s.schema)return s.schema;if(m)return x(m,"full")},[s.schema,m]);U(()=>{if(!G()||!f||!u)return;const{backend:e}=l.getState();e===d&&t||q||(q=(async()=>{try{const i=L();t=i,i.setStore(l),await i.initialize(d),C=!1}catch(i){C||(M(i,{userMessage:"Failed to initialize CRUD service.",context:{backend:d,collection:r},severity:"error"}),C=!0)}finally{q=null}})())},[f,d,u,r]);const g=async e=>t?c?t.get(r,e,u):(await K()).fetchQuery({queryKey:["crud",r,"get",e],queryFn:()=>t.get(r,e,u),staleTime:D}):null,v=async(e,i)=>{t&&(await t.set(r,e,i,u),!c&&n&&n.invalidateQueries({queryKey:["crud",r]}))},b=async(e,i)=>{t&&(await t.update(r,e,i),!c&&n&&n.invalidateQueries({queryKey:["crud",r]}))},h=async e=>{t&&(await t.delete(r,e),!c&&n&&n.invalidateQueries({queryKey:["crud",r]}))},A=async e=>{if(!t)return"";const i=await t.add(r,e,u);return!c&&n&&n.invalidateQueries({queryKey:["crud",r]}),i},T=async e=>t?c?t.query(r,e,u):(await K()).fetchQuery({queryKey:["crud",r,"query",JSON.stringify(e)],queryFn:()=>t.query(r,e,u),staleTime:D}):[],w=(e,i)=>t?t.subscribe(r,e,(o,E)=>{!c&&n&&o&&n.setQueryData(["crud",r,"get",e],o),i(o,E)},u):()=>{},S=(e,i)=>t?t.subscribeToCollection(r,e,(o,E)=>{!c&&n&&o&&n.setQueryData(["crud",r,"query",JSON.stringify(e)],o),i(o,E)},u):()=>{},R=async()=>{n&&await n.invalidateQueries({queryKey:["crud",r]})},Q=l(e=>e.collections[r]?.data.current||null),I=l(e=>e.collections[r]?.loading||!1),p=l(e=>e.collections[r]?.error||null),N=f?t?y.READY:y.INITIALIZING:y.DEGRADED;return!f||!u||!t?{...P,status:N,data:Q,loading:I,error:p,get:g,set:v,update:b,delete:h,add:A,query:T,subscribe:w,subscribeToCollection:S,invalidate:R,isAvailable:!1}:{status:y.READY,data:Q,loading:I,error:p,get:g,set:v,update:b,delete:h,add:A,query:T,subscribe:w,subscribeToCollection:S,invalidate:R,isAvailable:!0}}export{Z as useCrud};
+"use client";import{useEffect as B,useMemo as y,useCallback as n}from"react";import{useFeatureConsent as L,FRAMEWORK_FEATURES as j,FEATURE_STATUS as f,handleError as V,isClient as W,createSchemas as Z,DEGRADED_CRUD_API as $}from"@donotdev/core";import{getCrudService as H}from"./CrudService";import{useCrudStore as a}from"./CrudStore";const J={},ee={};let U=null,v=null,D=!1;function o(){return U}function te(u,i={}){const m=L(j.CRUD),P=a(e=>e.crudService),E=m&&!P,h=m?E?f.INITIALIZING:f.READY:f.DEGRADED;if(u==="status")return h;const S=typeof u=="object"?u:i.entity,t=typeof u=="string"?u:u.collection,d=i.backend||"functions",g=i.noCache??!1,T=i.staleTime,l=y(()=>({noCache:g,staleTime:T}),[g,T]),s=y(()=>{if(i.schema){const e=i.schema;return{create:e,draft:e,update:e,get:e,list:e,listCard:e,delete:e}}if(S)return Z(S)},[i.schema?"custom":S?.name,t]),b=a(e=>e.collections[t]?.data||J),w=a(e=>e.collections[t]?.loading||!1),A=a(e=>e.collections[t]?.error||null),F=a(e=>e.collections[t]?.data.current||null);B(()=>{if(!W()||!m||!s)return;const{crudService:e,backend:c}=a.getState();e&&c===d||v||(v=(async()=>{try{const r=H();U=r,r.setStore(a),await r.initialize(d),D=!1,a.getState().setBackend(d),a.getState().setCrudService(r)}catch(r){D||(V(r,{userMessage:"Failed to initialize CRUD service.",context:{backend:d,collection:t},severity:"error"}),D=!0)}finally{v=null}})())},[m,d,t,s?"hasSchema":"noSchema"]);const C=E||w,k=h===f.READY,x=n(async e=>{const c=o();return!c||!s?null:c.get(t,e,s.get,l)},[t,s?"hasSchema":"noSchema",l]),M=n(async(e,c)=>{const r=o();if(!r||!s)return;const G=c?.status==="draft"?s.draft:s.create;await r.set(t,e,c,G)},[t,s?"hasSchema":"noSchema"]),N=n(async(e,c)=>{const r=o();r&&await r.update(t,e,c)},[t]),z=n(async e=>{const c=o();c&&await c.delete(t,e)},[t]),Y=n(async e=>{const c=o();if(!c||!s)return"";const R=e?.status==="draft"?s.draft:s.create;return c.add(t,e,R)},[t,s?"hasSchema":"noSchema"]),q=n(async e=>{const c=o();return!c||!s?[]:c.query(t,e,s.list,l)},[t,s?"hasSchema":"noSchema",l]),p=n((e,c)=>{const r=o();return!r||!s?()=>{}:r.subscribe(t,e,c,s.get)},[t,s?"hasSchema":"noSchema"]),_=n((e,c)=>{const r=o();return!r||!s?()=>{}:r.subscribeToCollection(t,e,c,s.list)},[t,s?"hasSchema":"noSchema"]),I=n(async()=>{const e=o();e&&await e.invalidateCollection(t)},[t]);return k?{status:f.READY,data:F,loading:C,error:A,get:x,set:M,update:N,delete:z,add:Y,query:q,subscribe:p,subscribeToCollection:_,invalidate:I,isAvailable:!0,_collection:t,_schemas:s,_cacheOptions:l,_storeData:b}:{...$,status:h,loading:C,error:A,subscribe:p,subscribeToCollection:_,invalidate:I,_collection:t,_schemas:s,_cacheOptions:l,_storeData:b}}export{J as EMPTY_DATA,ee as EMPTY_OPTIMISTIC,o as getCrudServiceInstance,te as useCrud};

package/dist/useCrudCardList.d.ts

@@ -0,0 +1,62 @@
+/**
+ * @fileoverview useCrudCardList Hook - Optimized Card List Management
+ * @description Specialized hook for fetching lists of entities optimized for card views.
+ * Uses TanStack Query for reactive loading states.
+ * Fetches only the fields defined in `listCardFields` (or `listFields`) to reduce payload size.
+ *
+ * @version 0.1.0
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { Entity, FeatureStatus } from '@donotdev/core';
+import type { UseCrudOptions } from './useCrud';
+export interface UseCrudCardListOptions<T> extends UseCrudOptions<T> {
+    /** Automatically fetch data on mount (default: true) */
+    enabled?: boolean;
+}
+export interface UseCrudCardListReturn<T> {
+    status: FeatureStatus;
+    data: {
+        items: T[];
+    } | null;
+    /** True during initial fetch (show skeletons) */
+    loading: boolean;
+    /** True during background refetch (show subtle indicator) */
+    fetching: boolean;
+    error: Error | null;
+    /** Manual refresh function */
+    mutate: () => Promise<void>;
+    isAvailable: boolean;
+}
+/**
+ * React hook for fetching a list of entities optimized for Card views
+ *
+ * Use this hook for:
+ * - Public-facing grids
+ * - Dashboard widgets
+ * - Summary lists
+ *
+ * @template T - Document type
+ * @param entityOrCollection - Entity definition or collection name
+ * @param options - Configuration options
+ * @returns List data and control methods
+ *
+ * @example
+ * ```typescript
+ * const { data, loading, fetching } = useCrudCardList(carEntity);
+ *
+ * if (loading) return <Skeletons />;
+ *
+ * return (
+ *   <Grid>
+ *     {data?.items.map(car => <Card key={car.id} title={car.make} />)}
+ *   </Grid>
+ * );
+ * ```
+ */
+export declare function useCrudCardList<T extends {
+    id: string;
+} = {
+    id: string;
+}>(entityOrCollection: Entity | string, options?: UseCrudCardListOptions<T>): UseCrudCardListReturn<T>;
+//# sourceMappingURL=useCrudCardList.d.ts.map

package/dist/useCrudCardList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCrudCardList.d.ts","sourceRoot":"","sources":["../src/useCrudCardList.ts"],"names":[],"mappings":"AACA;;;;;;;;;GASG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,sBAAsB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAClE,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,qBAAqB,CAAC,CAAC;IACtC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE;QAAE,KAAK,EAAE,CAAC,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,eAAe,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACvE,kBAAkB,EAAE,MAAM,GAAG,MAAM,EACnC,OAAO,GAAE,sBAAsB,CAAC,CAAC,CAAM,GACtC,qBAAqB,CAAC,CAAC,CAAC,CAsF1B"}

package/dist/useCrudCardList.js

@@ -0,0 +1 @@
+import{useMemo as y,useCallback as T}from"react";import{useQuery as _}from"@donotdev/core";import{useCrudStore as I}from"./CrudStore";import{useCrud as h,getCrudServiceInstance as L,EMPTY_OPTIMISTIC as A}from"./useCrud";import{mergeWithOptimistic as D}from"./utils/mergeWithOptimistic";function K(p,n={}){const C=n.enabled??!0,i=h("status"),e=i==="ready",g=h(p,n),{error:c,invalidate:u,_collection:r,_schemas:a,_cacheOptions:l,_storeData:m}=g,d=I(s=>s.collections[r]?.optimistic||A),t=y(()=>{if(!e||!a)return null;const s=L();return s?s.getListQueryOptions(r,{},a.listCard,l,"listCard"):null},[e,r,l,a?"hasSchema":"noSchema"]),{data:o,isLoading:b,isFetching:q,error:v,refetch:f}=_({queryKey:t?.queryKey??["crud",r,"disabled"],queryFn:t?.queryFn??(()=>Promise.resolve([])),staleTime:t?.staleTime,enabled:C&&!!t}),O=y(()=>!o||!e?[]:D(o,d,m),[o,d,m,e]),S=T(async()=>{e&&(await u(),await f())},[u,f,e]);return e?{status:i,data:{items:O},loading:b,fetching:q,error:v??c,mutate:S,isAvailable:!0}:{status:i,data:{items:[]},loading:!1,fetching:!1,error:c,mutate:async()=>{},isAvailable:!1}}export{K as useCrudCardList};

package/dist/useCrudList.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview useCrudList Hook - Collection Management
+ * @description Specialized hook for fetching and managing lists of entities.
+ * Uses TanStack Query for reactive loading states.
+ *
+ * @version 0.2.0
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { Entity, FeatureStatus } from '@donotdev/core';
+import type { UseCrudOptions } from './useCrud';
+export interface UseCrudListOptions<T> extends UseCrudOptions<T> {
+    /** Automatically fetch data on mount (default: true) */
+    enabled?: boolean;
+}
+export interface UseCrudListReturn<T> {
+    status: FeatureStatus;
+    data: {
+        items: T[];
+    } | null;
+    /** True during initial fetch (show skeletons) */
+    loading: boolean;
+    /** True during background refetch (show subtle indicator) */
+    fetching: boolean;
+    error: Error | null;
+    /** Manual refresh function */
+    mutate: () => Promise<void>;
+    isAvailable: boolean;
+}
+/**
+ * React hook for fetching and managing a list of entities
+ *
+ * Use this hook for:
+ * - Admin tables
+ * - Data grids
+ * - Lists of items
+ *
+ * @template T - Document type
+ * @param entityOrCollection - Entity definition or collection name
+ * @param options - Configuration options
+ * @returns List data and control methods
+ *
+ * @example
+ * ```typescript
+ * const { data, loading, mutate } = useCrudList(carEntity);
+ *
+ * if (loading) return <Loader />;
+ *
+ * return (
+ *   <ul>
+ *     {data?.items.map(car => <li key={car.id}>{car.make}</li>)}
+ *   </ul>
+ * );
+ * ```
+ */
+export declare function useCrudList<T extends {
+    id: string;
+} = {
+    id: string;
+}>(entityOrCollection: Entity | string, options?: UseCrudListOptions<T>): UseCrudListReturn<T>;
+//# sourceMappingURL=useCrudList.d.ts.map

package/dist/useCrudList.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useCrudList.d.ts","sourceRoot":"","sources":["../src/useCrudList.ts"],"names":[],"mappings":"AACA;;;;;;;;GAQG;AAKH,OAAO,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAO5D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,MAAM,WAAW,kBAAkB,CAAC,CAAC,CAAE,SAAQ,cAAc,CAAC,CAAC,CAAC;IAC9D,wDAAwD;IACxD,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE;QAAE,KAAK,EAAE,CAAC,EAAE,CAAA;KAAE,GAAG,IAAI,CAAC;IAC5B,iDAAiD;IACjD,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,8BAA8B;IAC9B,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,WAAW,CAAC,CAAC,SAAS;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,EACnE,kBAAkB,EAAE,MAAM,GAAG,MAAM,EACnC,OAAO,GAAE,kBAAkB,CAAC,CAAC,CAAM,GAClC,iBAAiB,CAAC,CAAC,CAAC,CAsFtB"}

package/dist/useCrudList.js

@@ -0,0 +1 @@
+import{useMemo as y,useCallback as T}from"react";import{useQuery as _}from"@donotdev/core";import{useCrudStore as I}from"./CrudStore";import{useCrud as h,getCrudServiceInstance as L,EMPTY_OPTIMISTIC as A}from"./useCrud";import{mergeWithOptimistic as D}from"./utils/mergeWithOptimistic";function K(p,n={}){const g=n.enabled??!0,i=h("status"),e=i==="ready",b=h(p,n),{error:c,invalidate:u,_collection:t,_schemas:a,_cacheOptions:l,_storeData:m}=b,d=I(s=>s.collections[t]?.optimistic||A),r=y(()=>{if(!e||!a)return null;const s=L();return s?s.getListQueryOptions(t,{},a.list,l,"list"):null},[e,t,l,a?"hasSchema":"noSchema"]),{data:o,isLoading:q,isFetching:v,error:C,refetch:f}=_({queryKey:r?.queryKey??["crud",t,"disabled"],queryFn:r?.queryFn??(()=>Promise.resolve([])),staleTime:r?.staleTime,enabled:g&&!!r}),O=y(()=>!o||!e?[]:D(o,d,m),[o,d,m,e]),S=T(async()=>{e&&(await u(),await f())},[u,f,e]);return e?{status:i,data:{items:O},loading:q,fetching:v,error:C??c,mutate:S,isAvailable:!0}:{status:i,data:{items:[]},loading:!1,fetching:!1,error:c,mutate:async()=>{},isAvailable:!1}}export{K as useCrudList};

package/dist/utils/fileStorage.d.ts

@@ -0,0 +1,58 @@
+import type { UploadProgressCallback } from '@donotdev/firebase';
+import type { FileAsset } from '@donotdev/types';
+export type { FileAsset };
+export interface UploadProgress {
+    bytesTransferred: number;
+    totalBytes: number;
+    progress: number;
+}
+export interface UploadFileOptions {
+    /** Storage path (default: 'uploads/files') */
+    storagePath?: string;
+    /** Custom filename (default: timestamp_originalname) */
+    filename?: string;
+    /** Progress callback */
+    onProgress?: UploadProgressCallback;
+}
+/**
+ * Upload a file to Firebase Storage with progress tracking
+ * Generic version for any file type (documents, PDFs, etc.)
+ */
+export declare function uploadFile(file: File, options?: UploadFileOptions): Promise<FileAsset>;
+/**
+ * Upload multiple files to Firebase Storage
+ */
+export declare function uploadFiles(files: File[], options?: UploadFileOptions): Promise<FileAsset[]>;
+/**
+ * Delete a file from Firebase Storage
+ */
+export declare function deleteFile(asset: FileAsset): Promise<void>;
+/**
+ * Generate a unique file ID
+ */
+export declare function generateFileId(): string;
+/**
+ * Get file extension from filename
+ */
+export declare function getFileExtension(filename: string): string;
+/**
+ * Get file icon based on MIME type or extension
+ */
+export declare function getFileIcon(mimeType?: string, filename?: string): string;
+/**
+ * Format file size for display
+ */
+export declare function formatFileSize(bytes: number): string;
+/**
+ * Document MIME types
+ */
+export declare const DOCUMENT_MIME_TYPES: string[];
+/**
+ * Document file extensions
+ */
+export declare const DOCUMENT_EXTENSIONS: string[];
+/**
+ * Get accept string for document inputs
+ */
+export declare function getDocumentAcceptString(): string;
+//# sourceMappingURL=fileStorage.d.ts.map

package/dist/utils/fileStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileStorage.d.ts","sourceRoot":"","sources":["../../src/utils/fileStorage.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,YAAY,EAAE,SAAS,EAAE,CAAC;AAE1B,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAYD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,SAAS,CAAC,CAkCpB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAC/B,KAAK,EAAE,IAAI,EAAE,EACb,OAAO,GAAE,iBAAsB,GAC9B,OAAO,CAAC,SAAS,EAAE,CAAC,CA4BtB;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAWhE;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAGzD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CA4CxE;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAY/B,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,UAY/B,CAAC;AAEF;;GAEG;AACH,wBAAgB,uBAAuB,IAAI,MAAM,CAEhD"}

package/dist/utils/fileStorage.js

@@ -0,0 +1 @@
+"use client";import{handleError as p}from"@donotdev/core";import{uploadFileResumable as u,deleteFileByUrl as d}from"@donotdev/firebase";function f(e){return e.replace(/[^a-zA-Z0-9.-]/g,"_").replace(/_{2,}/g,"_").toLowerCase()}async function x(e,t={}){const{storagePath:r="uploads/files",filename:n,onProgress:a}=t,o=Date.now(),i=f(e.name),c=n||`${o}_${i}`,l=`${r}/${c}`;try{const{promise:s}=u(e,{basePath:r,filename:c,onProgress:a,metadata:{contentType:e.type}});return{url:(await s).url,filename:e.name,size:e.size,mimeType:e.type,uploadedAt:new Date().toISOString()}}catch(s){throw p(s,{userMessage:"Failed to upload file",severity:"error",context:{filename:e.name,fileSize:e.size}})}}async function v(e,t={}){const r=[],n=e.reduce((o,i)=>o+i.size,0);let a=0;for(const o of e){const i=t.onProgress?l=>{const s=l.bytesTransferred/l.totalBytes*o.size;t.onProgress({bytesTransferred:a+s,totalBytes:n,progress:(a+s)/n*100})}:void 0,c=await x(o,{...t,onProgress:i});r.push(c),a+=o.size}return r}async function M(e){try{await d(e.url)}catch(t){throw p(t,{userMessage:"Failed to delete file",severity:"error",context:{url:e.url,filename:e.filename}}),t}}function S(){return`${Date.now()}-${Math.random().toString(36).slice(2,9)}`}function m(e){const t=e.split(".");return t.length>1?t.pop().toLowerCase():""}function P(e,t){const r=t?m(t):"";if(e){if(e.startsWith("image/"))return"image";if(e.startsWith("video/"))return"video";if(e.startsWith("audio/"))return"audio";if(e==="application/pdf")return"pdf";if(e.includes("word")||e.includes("document"))return"doc";if(e.includes("excel")||e.includes("spreadsheet"))return"xls";if(e.includes("powerpoint")||e.includes("presentation"))return"ppt"}switch(r){case"pdf":return"pdf";case"doc":case"docx":return"doc";case"xls":case"xlsx":case"csv":return"xls";case"ppt":case"pptx":return"ppt";case"md":case"txt":return"text";case"html":case"htm":return"html";case"zip":case"rar":case"7z":return"archive";default:return"file"}}function B(e){if(e===0)return"0 B";const t=1024,r=["B","KB","MB","GB"],n=Math.floor(Math.log(e)/Math.log(t));return`${parseFloat((e/Math.pow(t,n)).toFixed(1))} ${r[n]}`}const h=["application/pdf","application/msword","application/vnd.openxmlformats-officedocument.wordprocessingml.document","application/vnd.ms-excel","application/vnd.openxmlformats-officedocument.spreadsheetml.sheet","application/vnd.ms-powerpoint","application/vnd.openxmlformats-officedocument.presentationml.presentation","text/plain","text/markdown","text/html","text/csv"],g=[".pdf",".doc",".docx",".xls",".xlsx",".ppt",".pptx",".txt",".md",".html",".csv"];function E(){return[...h,...g].join(",")}export{g as DOCUMENT_EXTENSIONS,h as DOCUMENT_MIME_TYPES,M as deleteFile,B as formatFileSize,S as generateFileId,E as getDocumentAcceptString,m as getFileExtension,P as getFileIcon,x as uploadFile,v as uploadFiles};

package/dist/utils/imageProcessing.d.ts

@@ -23,7 +23,7 @@ export interface ProcessImageOptions {
     thumbHeight?: number;
     /** Target aspect ratio (default: 4/3) */
     aspectRatio?: number;
-    /** WebP quality (0-1, default: 0.9 for full, 0.8 for thumb) */
+    /** WebP quality (0-1, default: 0.85 for full, 0.65 for thumb) */
     quality?: number;
     /** Add transparent background for non-matching aspect ratios */
     transparentBackground?: boolean;

package/dist/utils/imageProcessing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageProcessing.d.ts","sourceRoot":"","sources":["../../src/utils/imageProcessing.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iEAAiE;IACjE,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,cAAc,CAAC,CAsEzB;AAwHD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBpC"}
+{"version":3,"file":"imageProcessing.d.ts","sourceRoot":"","sources":["../../src/utils/imageProcessing.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,IAAI,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,mBAAmB;IAClC,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yDAAyD;IACzD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iEAAiE;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,gEAAgE;IAChE,qBAAqB,CAAC,EAAE,OAAO,CAAC;IAChC,iEAAiE;IACjE,IAAI,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED;;GAEG;AACH,wBAAsB,YAAY,CAChC,IAAI,EAAE,IAAI,EACV,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,cAAc,CAAC,CAuEzB;AAwHD;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,IAAI,EACV,YAAY,CAAC,EAAE,MAAM,GACpB;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBpC"}

package/dist/utils/imageProcessing.js

@@ -1 +1 @@
-async function x(t,r={}){const{maxWidth:o=1920,maxHeight:a=1440,thumbWidth:d=300,thumbHeight:i=225,aspectRatio:e=4/3,quality:h=.9,transparentBackground:c=!0,crop:l}=r;return new Promise((f,s)=>{const n=new Image,u=new FileReader;u.onload=w=>{n.src=w.target?.result},u.onerror=()=>s(new Error("Failed to read file")),n.onload=async()=>{try{const{width:w,height:F}=g(l?l.width:n.width,l?l.height:n.height,o,a,e),m=await b(n,w,F,e,h,c,l),v=await b(n,d,i,e,.8,c,l);f({fullBlob:m,thumbBlob:v,width:w,height:F})}catch(w){s(w)}},n.onerror=()=>s(new Error("Failed to load image")),u.readAsDataURL(t)})}function g(t,r,o,a,d){let i=t,e=r;i>o&&(e=o/i*e,i=o),e>a&&(i=a/e*i,e=a);const h=i/e;return Math.abs(h-d)>.01&&(h>d?e=i/d:i=e*d),{width:Math.round(i),height:Math.round(e)}}async function b(t,r,o,a,d,i,e){const h=document.createElement("canvas"),c=h.getContext("2d");if(!c)throw new Error("Failed to get canvas context");h.width=r,h.height=o,i?c.clearRect(0,0,r,o):(c.fillStyle="#FFFFFF",c.fillRect(0,0,r,o));let l,f,s,n;if(e)l=e.x,f=e.y,s=e.width,n=e.height;else{const u=t.width/t.height;s=t.width,n=t.height,l=0,f=0,u>a?(s=t.height*a,l=(t.width-s)/2):u<a&&(n=t.width/a,f=(t.height-n)/2)}return c.drawImage(t,l,f,s,n,0,0,r,o),new Promise((u,w)=>{h.toBlob(F=>{F?u(F):w(new Error("Failed to convert canvas to blob"))},"image/webp",d)})}function y(t,r){return t.type.startsWith("image/")?r&&t.size>r?{valid:!1,error:`File size exceeds ${(r/1048576).toFixed(1)}MB limit`}:{valid:!0}:{valid:!1,error:"File must be an image"}}export{x as processImage,y as validateImageFile};
+async function x(t,r={}){const{maxWidth:o=1920,maxHeight:a=1440,thumbWidth:d=300,thumbHeight:i=225,aspectRatio:e=4/3,quality:h=.85,transparentBackground:c=!0,crop:l}=r;return new Promise((f,s)=>{const n=new Image,u=new FileReader;u.onload=w=>{n.src=w.target?.result},u.onerror=()=>s(new Error("Failed to read file")),n.onload=async()=>{try{const{width:w,height:F}=g(l?l.width:n.width,l?l.height:n.height,o,a,e),m=await b(n,w,F,e,h,c,l),v=await b(n,d,i,e,.65,c,l);f({fullBlob:m,thumbBlob:v,width:w,height:F})}catch(w){s(w)}},n.onerror=()=>s(new Error("Failed to load image")),u.readAsDataURL(t)})}function g(t,r,o,a,d){let i=t,e=r;i>o&&(e=o/i*e,i=o),e>a&&(i=a/e*i,e=a);const h=i/e;return Math.abs(h-d)>.01&&(h>d?e=i/d:i=e*d),{width:Math.round(i),height:Math.round(e)}}async function b(t,r,o,a,d,i,e){const h=document.createElement("canvas"),c=h.getContext("2d");if(!c)throw new Error("Failed to get canvas context");h.width=r,h.height=o,i?c.clearRect(0,0,r,o):(c.fillStyle="#FFFFFF",c.fillRect(0,0,r,o));let l,f,s,n;if(e)l=e.x,f=e.y,s=e.width,n=e.height;else{const u=t.width/t.height;s=t.width,n=t.height,l=0,f=0,u>a?(s=t.height*a,l=(t.width-s)/2):u<a&&(n=t.width/a,f=(t.height-n)/2)}return c.drawImage(t,l,f,s,n,0,0,r,o),new Promise((u,w)=>{h.toBlob(F=>{F?u(F):w(new Error("Failed to convert canvas to blob"))},"image/webp",d)})}function y(t,r){return t.type.startsWith("image/")?r&&t.size>r?{valid:!1,error:`File size exceeds ${(r/1048576).toFixed(1)}MB limit`}:{valid:!0}:{valid:!1,error:"File must be an image"}}export{x as processImage,y as validateImageFile};

package/dist/utils/imageStorage.d.ts

@@ -1,13 +1,4 @@
-/**
- * @fileoverview Image Storage Utilities
- * @description Handle image uploads to Firebase Storage with progress tracking, WebP conversion, and thumbnails
- * Uses @donotdev/firebase for storage operations
- *
- * @version 0.0.2
- * @since 0.0.1
- * @author AMBROISE PARK Consulting
- */
-import { type UploadProgressCallback } from '@donotdev/firebase';
+import type { UploadProgressCallback } from '@donotdev/firebase';
 import type { Picture } from '@donotdev/types';
 export type { Picture };
 export interface UploadProgress {

package/dist/utils/imageStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"imageStorage.d.ts","sourceRoot":"","sources":["../../src/utils/imageStorage.ts"],"names":[],"mappings":"AAEA;;;;;;;;GAQG;AAEH,OAAO,EAIL,KAAK,sBAAsB,EAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,OAAO,EAAE,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAYD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,IAAI,EACd,SAAS,EAAE,IAAI,EACf,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAmFlB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjE"}
+{"version":3,"file":"imageStorage.d.ts","sourceRoot":"","sources":["../../src/utils/imageStorage.ts"],"names":[],"mappings":"AAkBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACjE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C,YAAY,EAAE,OAAO,EAAE,CAAC;AAExB,MAAM,WAAW,cAAc;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,wBAAwB;IACxB,UAAU,CAAC,EAAE,sBAAsB,CAAC;CACrC;AAYD;;;GAGG;AACH,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,IAAI,EACd,SAAS,EAAE,IAAI,EACf,gBAAgB,EAAE,MAAM,EACxB,OAAO,GAAE,kBAAuB,GAC/B,OAAO,CAAC,OAAO,CAAC,CAmFlB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAcjE"}

package/dist/utils/imageStorage.js

@@ -1 +1 @@
-import{uploadFileResumable as c,deleteFileByUrl as i,getFileUrl as m}from"@donotdev/firebase";import{handleError as _}from"@donotdev/core";function F(e){return e.replace(/[^a-zA-Z0-9.-]/g,"_").replace(/_{2,}/g,"_").toLowerCase()}async function N(e,l,b,h={}){const{storagePath:r="uploads/images",filename:f,onProgress:s}=h,p=Date.now(),t=(f||`${p}_${F(b)}`).replace(/\.[^/.]+$/,""),w=`${r}/${t}_full.webp`,g=`${r}/${t}_thumb.webp`;try{const u=s?a=>{s({bytesTransferred:a.bytesTransferred,totalBytes:a.totalBytes*2,progress:a.progress*.5})}:void 0,o=new File([e],`${t}_full.webp`,{type:"image/webp"}),{promise:n}=c(o,{basePath:r,filename:`${t}_full.webp`,onProgress:u,metadata:{contentType:"image/webp"}}),d=(await n).url,y=s?a=>{s({bytesTransferred:a.bytesTransferred+e.size,totalBytes:e.size+l.size,progress:50+a.progress*.5})}:void 0,P=new File([l],`${t}_thumb.webp`,{type:"image/webp"}),{promise:U}=c(P,{basePath:r,filename:`${t}_thumb.webp`,onProgress:y,metadata:{contentType:"image/webp"}}),$=(await U).url;return{fullUrl:d,thumbUrl:$}}catch(u){try{const o=await m(w).catch(()=>null),n=await m(g).catch(()=>null);o&&await i(o).catch(()=>{}),n&&await i(n).catch(()=>{})}catch{}throw u}}async function k(e){try{await Promise.all([i(e.fullUrl),i(e.thumbUrl)])}catch(l){throw _(l,{userMessage:"Failed to delete image",severity:"error",context:{fullUrl:e.fullUrl,thumbUrl:e.thumbUrl}}),l}}export{k as deleteImage,N as uploadImage};
+import{handleError as _}from"@donotdev/core";import{uploadFileResumable as c,deleteFileByUrl as i,getFileUrl as m}from"@donotdev/firebase";function F(e){return e.replace(/[^a-zA-Z0-9.-]/g,"_").replace(/_{2,}/g,"_").toLowerCase()}async function N(e,l,b,h={}){const{storagePath:r="uploads/images",filename:f,onProgress:s}=h,p=Date.now(),t=(f||`${p}_${F(b)}`).replace(/\.[^/.]+$/,""),w=`${r}/${t}_full.webp`,g=`${r}/${t}_thumb.webp`;try{const u=s?a=>{s({bytesTransferred:a.bytesTransferred,totalBytes:a.totalBytes*2,progress:a.progress*.5})}:void 0,o=new File([e],`${t}_full.webp`,{type:"image/webp"}),{promise:n}=c(o,{basePath:r,filename:`${t}_full.webp`,onProgress:u,metadata:{contentType:"image/webp"}}),d=(await n).url,y=s?a=>{s({bytesTransferred:a.bytesTransferred+e.size,totalBytes:e.size+l.size,progress:50+a.progress*.5})}:void 0,P=new File([l],`${t}_thumb.webp`,{type:"image/webp"}),{promise:U}=c(P,{basePath:r,filename:`${t}_thumb.webp`,onProgress:y,metadata:{contentType:"image/webp"}}),$=(await U).url;return{fullUrl:d,thumbUrl:$}}catch(u){try{const o=await m(w).catch(()=>null),n=await m(g).catch(()=>null);o&&await i(o).catch(()=>{}),n&&await i(n).catch(()=>{})}catch{}throw u}}async function k(e){try{await Promise.all([i(e.fullUrl),i(e.thumbUrl)])}catch(l){throw _(l,{userMessage:"Failed to delete image",severity:"error",context:{fullUrl:e.fullUrl,thumbUrl:e.thumbUrl}}),l}}export{k as deleteImage,N as uploadImage};

package/dist/utils/mergeWithOptimistic.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fileoverview Optimistic merge utility
+ * @description Merges TanStack Query results with optimistic operations from store
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { OptimisticMeta } from '../CrudStore';
+interface WithId {
+    id: string;
+    [key: string]: unknown;
+}
+/**
+ * Merge query results with optimistic operations.
+ * - Filter out items marked for deletion
+ * - Apply optimistic updates
+ * - Append optimistic adds (temp IDs)
+ *
+ * @param queryData - Data from TanStack Query cache
+ * @param optimistic - Optimistic operation metadata from store
+ * @param storeData - Current store data (for optimistic values)
+ * @returns Merged array with optimistic changes applied
+ */
+export declare function mergeWithOptimistic<T extends WithId>(queryData: T[], optimistic: Record<string, OptimisticMeta>, storeData?: Record<string, unknown>): T[];
+export {};
+//# sourceMappingURL=mergeWithOptimistic.d.ts.map

package/dist/utils/mergeWithOptimistic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeWithOptimistic.d.ts","sourceRoot":"","sources":["../../src/utils/mergeWithOptimistic.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAEnD,UAAU,MAAM;IACd,EAAE,EAAE,MAAM,CAAC;IACX,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,SAAS,MAAM,EAClD,SAAS,EAAE,CAAC,EAAE,EACd,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAC1C,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC,CAAC,EAAE,CA4BL"}

package/dist/utils/mergeWithOptimistic.js

@@ -0,0 +1 @@
+function p(s,t,i){const n=[],d=new Set;for(const e of s){const o=t[e.id];o?.operation!=="delete"&&(o?.operation==="update"&&i?.[e.id]?n.push(i[e.id]):n.push(e),d.add(e.id))}for(const[e,o]of Object.entries(t))o.operation==="add"&&!d.has(e)&&i?.[e]&&n.push(i[e]);return n}export{p as mergeWithOptimistic};

package/dist/utils/uploadValidation.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Upload Validation Utilities
+ * @description Type-safe validation utilities to ensure no blob URLs reach the database.
+ * Provides security checks for Picture objects and form data validation.
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { Picture } from '@donotdev/types';
+/**
+ * Check if a URL is a valid storage URL (not a blob URL)
+ * @param url - URL to check
+ * @returns true if URL is a storage URL (https://), false if blob URL or invalid
+ */
+export declare function isStorageUrl(url: string): boolean;
+/**
+ * Validate that a Picture object has valid storage URLs
+ * @param picture - Picture object to validate
+ * @returns true if both fullUrl and thumbUrl are valid storage URLs
+ */
+export declare function validatePicture(picture: Picture): boolean;
+/**
+ * Recursively check for blob URLs in form data
+ * Returns array of paths where blob URLs were found
+ * @param data - Data to check (can be nested object/array)
+ * @param path - Current path in the data structure (for error messages)
+ * @returns Array of paths where blob URLs were found
+ */
+export declare function checkForBlobUrls(data: any, path?: string): string[];
+/**
+ * Check if form data contains any blob URLs
+ * @param data - Form data to check
+ * @returns true if any blob URLs found, false otherwise
+ */
+export declare function hasBlobUrls(data: any): boolean;
+//# sourceMappingURL=uploadValidation.d.ts.map

package/dist/utils/uploadValidation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadValidation.d.ts","sourceRoot":"","sources":["../../src/utils/uploadValidation.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGjD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAKzD;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,SAAK,GAAG,MAAM,EAAE,CA2C/D;AAED;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAE9C"}

package/dist/utils/uploadValidation.js

@@ -0,0 +1 @@
+"use client";function l(r){return!r||typeof r!="string"?!1:r.startsWith("https://")&&!r.startsWith("blob:")}function i(r){return!r||typeof r!="object"?!1:l(r.fullUrl)&&l(r.thumbUrl)}function f(r,n=""){const e=[];if(r==null)return e;if(typeof r=="string")return r.startsWith("blob:")&&e.push(n||"root"),e;if(typeof r!="object")return e;if(Array.isArray(r))r.forEach((t,o)=>{const s=n?`${n}[${o}]`:`[${o}]`;e.push(...f(t,s))});else if(r.fullUrl!==void 0&&r.thumbUrl!==void 0){if(!l(r.fullUrl)||!l(r.thumbUrl)){const t=n||"root";e.push(`${t}.fullUrl or ${t}.thumbUrl contains blob URL`)}}else Object.entries(r).forEach(([t,o])=>{const s=n?`${n}.${t}`:t;e.push(...f(o,s))});return e}function u(r){return f(r).length>0}export{f as checkForBlobUrls,u as hasBlobUrls,l as isStorageUrl,i as validatePicture};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/crud",
-  "version": "0.0.6",
+  "version": "0.0.7",
   "private": false,
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -49,8 +49,8 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@donotdev/components": "^0.0.12",
-    "@donotdev/core": "^0.0.13",
+    "@donotdev/components": "^0.0.13",
+    "@donotdev/core": "^0.0.14",
     "@hookform/resolvers": "^5.2.2",
     "react-easy-crop": "^5.5.6"
   },
@@ -61,7 +61,24 @@
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
     "react-hook-form": "^7.71.0",
-    "valibot": "^1.2.0"
+    "valibot": "^1.2.0",
+    "@tiptap/react": "^3.16.0",
+    "@tiptap/pm": "^3.16.0",
+    "@tiptap/starter-kit": "^3.16.0",
+    "@tiptap/extension-placeholder": "^3.16.0"
   },
-  "peerDependenciesMeta": {}
+  "peerDependenciesMeta": {
+    "@tiptap/react": {
+      "optional": true
+    },
+    "@tiptap/pm": {
+      "optional": true
+    },
+    "@tiptap/starter-kit": {
+      "optional": true
+    },
+    "@tiptap/extension-placeholder": {
+      "optional": true
+    }
+  }
 }