@donotdev/crud 0.0.4 → 0.0.6

package/dist/useCrud.d.ts

@@ -1,42 +1,94 @@
-import type { dndevSchema, FeatureStatus } from '@donotdev/core';
+import type { dndevSchema, Entity, FeatureStatus } from '@donotdev/core';
 import { type BackendType } from './CrudStore';
 import { type QueryOptions } from './CrudService';
 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) */
     staleTime?: number;
     /** Disable caching (bypass TanStack Query) */
     noCache?: boolean;
 }
 /**
- * Selector type for useCrud hook
+ * CRUD API return type - complete interface for useCrud hook
+ * Consistent with CrudAPI from @donotdev/types
  */
-export type CrudSelector = 'isAvailable';
-/**
- * React hook for CRUD operations
- *
- * @overload Selector mode - get global CRUD state
- */
-export declare function useCrud(selector: 'isAvailable'): boolean;
-/**
- * @overload Collection mode - full CRUD operations
- */
-export declare function useCrud<T = unknown>(collection: string, options?: UseCrudOptions<T>): {
+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 */
+    /** Invalidate cache for this collection (TanStack Query) */
     invalidate: () => Promise<void>;
+    /** Whether CRUD is available and operational (status === 'ready') */
     isAvailable: boolean;
-};
+}
+/**
+ * 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);
+ *
+ * // 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
+ *
+ * @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
+ */
+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,aAAa,EAAE,MAAM,gBAAgB,CAAC;AAQjE,OAAO,EAAgB,KAAK,WAAW,EAAE,MAAM,aAAa,CAAC;AAE7D,OAAO,EAGL,KAAK,YAAY,EAClB,MAAM,eAAe,CAAC;AAmCvB,MAAM,WAAW,cAAc,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,WAAW,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACxB,uDAAuD;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,aAAa,CAAC;AAEzC;;;;GAIG;AACH,wBAAgB,OAAO,CAAC,QAAQ,EAAE,aAAa,GAAG,OAAO,CAAC;AAE1D;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,GAAG,OAAO,EACjC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GAC1B;IACD,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACvC,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC,KAAK,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAC/C,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,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,2CAA2C;IAC3C,UAAU,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAChC,WAAW,EAAE,OAAO,CAAC;CACtB,CAAC"}
+{"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"}

package/dist/useCrud.js

@@ -1 +1 @@
-"use client";import{useEffect as N}from"react";import{DEGRADED_CRUD_API as I,FEATURE_STATUS as d,useFeatureConsent as k}from"@donotdev/core";import{FRAMEWORK_FEATURES as z,handleError as G,isClient as L}from"@donotdev/core";import{useCrudStore as c}from"./CrudStore";import{getCrudService as M}from"./CrudService";let r=null,i=null,C=null,q=!1;const K=1e3*60*5;async function U(){if(i)return i;const{QueryClient:o}=await import("@tanstack/react-query");return i=new o({defaultOptions:{queries:{staleTime:K,gcTime:1e3*60*30,retry:1,refetchOnWindowFocus:!1}}}),i}function B(o,f={}){const l=k(z.CRUD),_=c(e=>e.crudService!==null);if(o==="isAvailable")return l?_:I.isAvailable;const t=o,y=f.backend||"firestore",u=f.schema,v=f.staleTime??K,a=f.noCache??!1;N(()=>{if(!L()||!l||!u)return;const{backend:e}=c.getState();e===y&&r||C||(C=(async()=>{try{const n=M();r=n,n.setStore(c),await n.initialize(y),q=!1}catch(n){q||(G(n,{userMessage:"Failed to initialize CRUD service.",context:{backend:y,collection:t},severity:"error"}),q=!0)}finally{C=null}})())},[l,y,u]);const E=async e=>r?a?r.get(t,e,u):(await U()).fetchQuery({queryKey:["crud",t,"get",e],queryFn:()=>r.get(t,e,u),staleTime:v}):null,A=async(e,n)=>{r&&(await r.set(t,e,n,u),!a&&i&&i.invalidateQueries({queryKey:["crud",t]}))},b=async(e,n)=>{r&&(await r.update(t,e,n),!a&&i&&i.invalidateQueries({queryKey:["crud",t]}))},D=async e=>{r&&(await r.delete(t,e),!a&&i&&i.invalidateQueries({queryKey:["crud",t]}))},g=async e=>{if(!r)return"";const n=await r.add(t,e,u);return!a&&i&&i.invalidateQueries({queryKey:["crud",t]}),n},T=async e=>r?a?r.query(t,e,u):(await U()).fetchQuery({queryKey:["crud",t,"query",JSON.stringify(e)],queryFn:()=>r.query(t,e,u),staleTime:v}):[],S=(e,n)=>r?r.subscribe(t,e,(s,m)=>{!a&&i&&s&&i.setQueryData(["crud",t,"get",e],s),n(s,m)},u):()=>{},R=(e,n)=>r?r.subscribeToCollection(t,e,(s,m)=>{!a&&i&&s&&i.setQueryData(["crud",t,"query",JSON.stringify(e)],s),n(s,m)},u):()=>{},w=async()=>{i&&await i.invalidateQueries({queryKey:["crud",t]})},Q=c(e=>e.collections[t]?.data.current||null),h=c(e=>e.collections[t]?.loading||!1),F=c(e=>e.collections[t]?.error||null),p=l?r?d.READY:d.INITIALIZING:d.DEGRADED;return!l||!u||!r?{...I,status:p,data:Q,loading:h,error:F,get:E,set:A,update:b,delete:D,add:g,query:T,subscribe:S,subscribeToCollection:R,invalidate:w,isAvailable:!1}:{status:d.READY,data:Q,loading:h,error:F,get:E,set:A,update:b,delete:D,add:g,query:T,subscribe:S,subscribeToCollection:R,invalidate:w,isAvailable:!0}}export{B as useCrud};
+"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};

package/dist/utils/imageProcessing.d.ts

@@ -0,0 +1,49 @@
+/**
+ * @fileoverview Image Processing Utilities
+ * @description Client-side image processing for WebP conversion, resizing, and thumbnail generation
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+export interface ProcessedImage {
+    fullBlob: Blob;
+    thumbBlob: Blob;
+    width: number;
+    height: number;
+}
+export interface ProcessImageOptions {
+    /** Maximum width for full-size image (default: 1920) */
+    maxWidth?: number;
+    /** Maximum height for full-size image (default: 1440) */
+    maxHeight?: number;
+    /** Thumbnail width (default: 300) */
+    thumbWidth?: number;
+    /** Thumbnail height (default: 225) */
+    thumbHeight?: number;
+    /** Target aspect ratio (default: 4/3) */
+    aspectRatio?: number;
+    /** WebP quality (0-1, default: 0.9 for full, 0.8 for thumb) */
+    quality?: number;
+    /** Add transparent background for non-matching aspect ratios */
+    transparentBackground?: boolean;
+    /** Crop region (if provided, overrides automatic center crop) */
+    crop?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+/**
+ * Resize and convert image to WebP with 4:3 aspect ratio
+ */
+export declare function processImage(file: File, options?: ProcessImageOptions): Promise<ProcessedImage>;
+/**
+ * Validate image file
+ */
+export declare function validateImageFile(file: File, maxSizeBytes?: number): {
+    valid: boolean;
+    error?: string;
+};
+//# sourceMappingURL=imageProcessing.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/imageProcessing.js

@@ -0,0 +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};

package/dist/utils/imageStorage.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @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 { Picture } from '@donotdev/types';
+export type { Picture };
+export interface UploadProgress {
+    bytesTransferred: number;
+    totalBytes: number;
+    progress: number;
+}
+export interface UploadImageOptions {
+    /** Storage path (default: 'uploads/images') */
+    storagePath?: string;
+    /** Custom filename (default: timestamp_originalname) */
+    filename?: string;
+    /** Progress callback */
+    onProgress?: UploadProgressCallback;
+}
+/**
+ * Upload full and thumbnail images to Firebase Storage with progress tracking
+ * Uses @donotdev/firebase uploadFileResumable for progress callbacks
+ */
+export declare function uploadImage(fullBlob: Blob, thumbBlob: Blob, originalFilename: string, options?: UploadImageOptions): Promise<Picture>;
+/**
+ * Delete image from Firebase Storage using @donotdev/firebase utilities
+ */
+export declare function deleteImage(picture: Picture): Promise<void>;
+//# sourceMappingURL=imageStorage.d.ts.map

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

@@ -0,0 +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"}

package/dist/utils/imageStorage.js

@@ -0,0 +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};

package/dist/utils/imageUtils.d.ts

@@ -0,0 +1,86 @@
+/**
+ * @fileoverview Image Utility Functions
+ * @description Hash generation, FLIP rotation, deduplication, and local preview management
+ *
+ * @version 0.0.1
+ * @since 0.0.1
+ * @author AMBROISE PARK Consulting
+ */
+import type { Picture } from '@donotdev/types';
+/**
+ * Generate SHA-256 hash of file for deduplication
+ */
+export declare function generateFileHash(file: File): Promise<string>;
+/**
+ * Create local preview URL from File
+ */
+export declare function createPreviewURL(file: File): string;
+/**
+ * Cleanup preview URL to prevent memory leaks
+ */
+export declare function revokePreviewURL(url: string): void;
+/**
+ * Rotate image by 90 degrees clockwise
+ */
+export declare function rotateImage90(file: File): Promise<File>;
+/**
+ * Image metadata for local state management
+ */
+export interface ImageMetadata {
+    /** Unique ID for this image instance */
+    id: string;
+    /** Original or rotated File object */
+    file: File;
+    /** Local preview URL (blob:...) */
+    previewURL: string;
+    /** SHA-256 hash for deduplication */
+    hash: string;
+    /** Number of 90° rotations applied (0-3) */
+    rotation: number;
+    /** Upload progress (0-100), null if not uploading */
+    uploadProgress: number | null;
+    /** Uploaded Picture URLs, null if not uploaded */
+    uploaded: Picture | null;
+    /** Error message if upload failed */
+    error: string | null;
+}
+/**
+ * Action for undo/redo stack
+ */
+export type ImageAction = {
+    type: 'add';
+    images: ImageMetadata[];
+} | {
+    type: 'remove';
+    indices: number[];
+} | {
+    type: 'reorder';
+    from: number;
+    to: number;
+} | {
+    type: 'rotate';
+    index: number;
+};
+/**
+ * Undo/redo stack manager
+ */
+export declare class UndoRedoManager {
+    private undoStack;
+    private redoStack;
+    private maxStackSize;
+    push(action: ImageAction): void;
+    undo(): ImageAction | null;
+    redo(): ImageAction | null;
+    canUndo(): boolean;
+    canRedo(): boolean;
+    clear(): void;
+}
+/**
+ * Check for duplicate files by hash (within current set)
+ */
+export declare function findDuplicatesByHash(images: ImageMetadata[], newHash: string): ImageMetadata[];
+/**
+ * Generate unique ID for image
+ */
+export declare function generateImageId(): string;
+//# sourceMappingURL=imageUtils.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"imageUtils.d.ts","sourceRoot":"","sources":["../../src/utils/imageUtils.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE/C;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAKlE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM,CAEnD;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAIlD;AAED;;GAEG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAyD7D;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,IAAI,CAAC;IACX,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,kDAAkD;IAClD,QAAQ,EAAE,OAAO,GAAG,IAAI,CAAC;IACzB,qCAAqC;IACrC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,aAAa,EAAE,CAAA;CAAE,GACxC;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GACrC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAEtC;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,SAAS,CAAqB;IACtC,OAAO,CAAC,YAAY,CAAM;IAE1B,IAAI,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAS/B,IAAI,IAAI,WAAW,GAAG,IAAI;IAS1B,IAAI,IAAI,WAAW,GAAG,IAAI;IAS1B,OAAO,IAAI,OAAO;IAIlB,OAAO,IAAI,OAAO;IAIlB,KAAK,IAAI,IAAI;CAId;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,aAAa,EAAE,EACvB,OAAO,EAAE,MAAM,GACd,aAAa,EAAE,CAEjB;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC"}

package/dist/utils/imageUtils.js

@@ -0,0 +1 @@
+async function d(e){const t=await e.arrayBuffer(),r=await crypto.subtle.digest("SHA-256",t);return Array.from(new Uint8Array(r)).map(o=>o.toString(16).padStart(2,"0")).join("")}function h(e){return URL.createObjectURL(e)}function u(e){e.startsWith("blob:")&&URL.revokeObjectURL(e)}async function l(e){return new Promise((t,r)=>{const a=new Image,o=new FileReader;o.onload=n=>{if(!n.target?.result){r(new Error("Failed to read file"));return}a.src=n.target.result},o.onerror=()=>r(new Error("Failed to read file")),a.onload=()=>{const n=document.createElement("canvas"),i=n.getContext("2d");if(!i){r(new Error("Failed to get canvas context"));return}n.width=a.height,n.height=a.width,i.translate(n.width/2,n.height/2),i.rotate(Math.PI/2),i.drawImage(a,-a.width/2,-a.height/2),n.toBlob(s=>{if(s){const c=new File([s],e.name,{type:e.type,lastModified:Date.now()});t(c)}else r(new Error("Failed to create blob from canvas"))},e.type,.95)},a.onerror=()=>r(new Error("Failed to load image")),o.readAsDataURL(e)})}class f{undoStack=[];redoStack=[];maxStackSize=50;push(t){this.undoStack.push(t),this.undoStack.length>this.maxStackSize&&this.undoStack.shift(),this.redoStack=[]}undo(){const t=this.undoStack.pop();return t?(this.redoStack.push(t),t):null}redo(){const t=this.redoStack.pop();return t?(this.undoStack.push(t),t):null}canUndo(){return this.undoStack.length>0}canRedo(){return this.redoStack.length>0}clear(){this.undoStack=[],this.redoStack=[]}}function g(e,t){return e.filter(r=>r.hash===t)}function p(){return`img_${Date.now()}_${Math.random().toString(36).substr(2,9)}`}export{f as UndoRedoManager,h as createPreviewURL,g as findDuplicatesByHash,d as generateFileHash,p as generateImageId,u as revokePreviewURL,l as rotateImage90};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@donotdev/crud",
-  "version": "0.0.4",
+  "version": "0.0.6",
   "private": false,
   "type": "module",
   "license": "SEE LICENSE IN LICENSE.md",
@@ -14,7 +14,9 @@
       "default": "./dist/index.js"
     }
   },
-  "sideEffects": false,
+  "sideEffects": [
+    "./src/builtinFieldTypes.tsx"
+  ],
   "files": [
     "dist",
     "package.json",
@@ -47,17 +49,18 @@
     "type-check": "tsc --noEmit"
   },
   "dependencies": {
-    "@donotdev/components": "0.0.4",
-    "@donotdev/core": "0.0.4"
+    "@donotdev/components": "^0.0.12",
+    "@donotdev/core": "^0.0.13",
+    "@hookform/resolvers": "^5.2.2",
+    "react-easy-crop": "^5.5.6"
   },
   "peerDependencies": {
-    "@donotdev/firebase": "0.0.4",
-    "@hookform/resolvers": "^5.2.2",
+    "@donotdev/firebase": "^0.0.5",
     "firebase": "^12.5.0",
     "lucide-react": "^0.562.0",
     "react": "^19.2.3",
     "react-dom": "^19.2.3",
-    "react-hook-form": "^7.68.0",
+    "react-hook-form": "^7.71.0",
     "valibot": "^1.2.0"
   },
   "peerDependenciesMeta": {}