@statezero/core 0.1.7 → 0.1.9

package/dist/config.d.ts

@@ -29,6 +29,10 @@ export function initializeAllEventReceivers(): Object;
  * @param {Function} getterFn - The getModelClass function imported from model-registry.js
  */
 export function registerModelGetter(getterFn: Function): void;
+/**
+ * Helper function to build file URLs
+ */
+export function buildFileUrl(fileUrl: any, backendKey?: string): any;
 /**
  * Get a model class by name using the registered getter.
  *
@@ -47,6 +51,7 @@ export namespace configInstance {
     export { initializeEventReceiver };
     export { registerModelGetter };
     export { getModelClass };
+    export { buildFileUrl };
 }
 export default configInstance;
 import { PusherEventReceiver } from './core/eventReceivers.js';

package/dist/config.js

@@ -47,6 +47,7 @@ const backendSchema = z.object({
     API_URL: z.string().url('API_URL must be a valid URL'),
     GENERATED_TYPES_DIR: z.string({ required_error: 'GENERATED_TYPES_DIR is required' }),
     BACKEND_TZ: z.string().optional(),
+    fileRootURL: z.string().url('fileRootURL must be a valid URL').optional(),
     fileUploadMode: z.enum(['server', 's3']).default('server'),
     getAuthHeaders: z.function().optional()
         .refine((fn) => fn === undefined || typeof fn === 'function', 'getAuthHeaders must be a function if provided'),
@@ -212,6 +213,26 @@ export function registerModelGetter(getterFn) {
     }
     modelGetter = getterFn;
 }
+/**
+ * Helper function to build file URLs
+ */
+export function buildFileUrl(fileUrl, backendKey = 'default') {
+    // If URL is already absolute (cloud storage), use it as-is
+    if (fileUrl && fileUrl.startsWith('http')) {
+        return fileUrl;
+    }
+    const cfg = getConfig();
+    const backend = cfg.backendConfigs[backendKey];
+    if (!backend) {
+        throw new ConfigError(`Backend "${backendKey}" not found in configuration.`);
+    }
+    // If no fileRootURL provided, return relative URL as-is
+    if (!backend.fileRootURL) {
+        return fileUrl;
+    }
+    // Construct full URL
+    return backend.fileRootURL.replace(/\/$/, '') + fileUrl;
+}
 /**
  * Get a model class by name using the registered getter.
  *
@@ -237,6 +258,7 @@ export const configInstance = {
     setBackendConfig,
     initializeEventReceiver,
     registerModelGetter,
-    getModelClass
+    getModelClass,
+    buildFileUrl
 };
 export default configInstance;

package/dist/flavours/django/files.d.ts

@@ -5,10 +5,10 @@ export class FileObject {
     static configKey: string;
     static MIN_CHUNK_SIZE: number;
     constructor(file: any, options?: {});
-    name: string;
-    size: number;
-    type: string;
-    lastModified: number;
+    name: any;
+    size: any;
+    type: any;
+    lastModified: number | null;
     uploaded: boolean;
     uploading: boolean;
     uploadResult: any;
@@ -21,6 +21,7 @@ export class FileObject {
     chunkSize: any;
     maxConcurrency: any;
     uploadPromise: any;
+    get isStoredFile(): any;
     get status(): "failed" | "uploading" | "uploaded" | "pending";
     get filePath(): any;
     get fileUrl(): any;
@@ -59,9 +60,9 @@ export class FileObject {
     getBlob(): Blob;
     waitForUpload(): Promise<any>;
     toJSON(): {
-        name: string;
-        size: number;
-        type: string;
+        name: any;
+        size: any;
+        type: any;
         status: string;
         uploaded: boolean;
         filePath: any;

package/dist/flavours/django/files.js

@@ -5,9 +5,37 @@ import PQueue from "p-queue";
  * FileObject - A file wrapper that handles uploads to StateZero backend
  */
 export class FileObject {
+    // Simple changes to FileObject constructor
     constructor(file, options = {}) {
+        // Handle stored file data (from API)
+        if (file &&
+            typeof file === "object" &&
+            file.file_path &&
+            !(file instanceof File)) {
+            // This is stored file data from the backend
+            this.name = file.file_name;
+            this.size = file.size;
+            this.type = file.mime_type; // Now coming from backend
+            this.lastModified = null;
+            // Mark as already uploaded
+            this.uploaded = true;
+            this.uploading = false;
+            this.uploadResult = file; // Store the entire response
+            this.uploadError = null;
+            this.fileData = null;
+            // No upload properties needed
+            this.uploadType = null;
+            this.uploadId = null;
+            this.totalChunks = 0;
+            this.completedChunks = 0;
+            this.chunkSize = null;
+            this.maxConcurrency = null;
+            this.uploadPromise = Promise.resolve(this.uploadResult);
+            return;
+        }
+        // Handle File objects (for upload) - existing code
         if (!file || !(file instanceof File)) {
-            throw new Error("FileObject requires a File object");
+            throw new Error("FileObject requires a File object or stored file data");
         }
         // Store file metadata directly
         this.name = file.name;
@@ -33,6 +61,9 @@ export class FileObject {
         this.maxConcurrency = options.maxConcurrency || 3;
         this.uploadPromise = this._initializeAndStartUpload(file, options);
     }
+    get isStoredFile() {
+        return this.uploaded && !this.fileData && this.uploadResult?.file_path;
+    }
     get status() {
         if (this.uploadError)
             return "failed";
@@ -46,7 +77,10 @@ export class FileObject {
         return this.uploadResult?.file_path;
     }
     get fileUrl() {
-        return this.uploadResult?.file_url;
+        if (!this.uploadResult?.file_url) {
+            return null;
+        }
+        return configInstance.buildFileUrl(this.uploadResult.file_url, this.constructor.configKey);
     }
     async _initializeAndStartUpload(file, options) {
         const config = configInstance.getConfig();

package/dist/flavours/django/model.js

@@ -83,6 +83,17 @@ export class Model {
             if (storedValue)
                 value = storedValue[field]; // if stops null -> undefined
         }
+        // File fields need special handling - wrap as FileObject
+        if (ModelClass.fileFields && ModelClass.fileFields.has(field) && value) {
+            // Check if it's already a FileObject
+            if (value instanceof FileObject) {
+                return value;
+            }
+            // If it's stored file data from API, wrap it as FileObject
+            if (typeof value === "object" && value.file_path) {
+                return new FileObject(value);
+            }
+        }
         // relationship fields need special handling
         if (ModelClass.relationshipFields.has(field) && value) {
             // fetch the stored value

package/dist/syncEngine/metrics/metricOptCalcs.d.ts

@@ -48,8 +48,8 @@ export class MaxStrategy extends MetricCalculationStrategy {
  * Factory class for creating the appropriate strategy
  */
 export class MetricStrategyFactory {
-    static "__#7@#customStrategies": Map<any, any>;
-    static "__#7@#defaultStrategies": Map<string, () => CountStrategy>;
+    static "__#5@#customStrategies": Map<any, any>;
+    static "__#5@#defaultStrategies": Map<string, () => CountStrategy>;
     /**
      * Clear all custom strategy overrides
      */
@@ -61,7 +61,7 @@ export class MetricStrategyFactory {
      * @param {Function} ModelClass - The model class
      * @returns {string} A unique key
      */
-    private static "__#7@#generateStrategyKey";
+    private static "__#5@#generateStrategyKey";
     /**
      * Override a strategy for a specific metric type and model class
      * @param {string} metricType - The type of metric (count, sum, min, max)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statezero/core",
-  "version": "0.1.7",
+  "version": "0.1.9",
   "type": "module",
   "module": "ESNext",
   "description": "The type-safe frontend client for StateZero - connect directly to your backend models with zero boilerplate",