@statezero/core 0.1.8 → 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.js

@@ -77,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@statezero/core",
-  "version": "0.1.8",
+  "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",