simple-strapi 1.0.0-alpha.22 → 1.0.0-alpha.24

package/dist/client.d.ts

@@ -6,7 +6,7 @@ import z from "zod";
 import { DynamicField, DynamicOptions, InferDynamic } from "./fields/dynamic";
 import { defaultStrapiFieldsSchema } from "./utils/schema";
 import { ComponentRepeatableField, ComponentRepeatableOptions, ComponentSingleField, ComponentSingleOptions, InferComponentRepeatable, InferComponentSingle } from "./fields/component";
-import { InferMediaSingle, MediaSingleField, MediaSingleOptions } from "./fields/media";
+import { InferMediaSingle, MediaSingleField, MediaSingleOptions, ZodMediaType } from "./fields/media";
 import { EnumerationField, EnumerationOptions, InferEnumeration } from "./fields/enumeration";
 import { InferRichTextBlocks, RichTextBlocksField, RichTextBlocksOptions } from "./fields/richText";
 import { InferJSON, JSONField, JSONOptions } from "./fields/json";
@@ -75,6 +75,7 @@ declare class Client {
     }>);
     private getAuthorizedHeaders;
     private populateFromSchema;
+    private resolveRef;
     getSingle<S extends Schema>(pluralID: string, options: EntityRequest<{
         schema: S;
         populate?: any;
@@ -138,5 +139,31 @@ declare class Client {
         data: any;
         meta: any;
     }>;
+    private getOrCreateFolder;
+    /**
+     * Carica un file sulla Media Library di Strapi.
+     *
+     * @param file - Sorgente del file: `Blob`, `File` (browser) oppure stringa base64
+     *               (data URI `data:mime;base64,...` o raw base64).
+     * @param options.filename - Nome del file nel FormData. Obbligatorio per base64 e
+     *                           Blob senza nome; per `File` viene estratto automaticamente.
+     * @param options.ref - Nome del Content Type (es. `"product"` → `api::product.product`)
+     *                      oppure UID completo (es. `"plugin::users-permissions.user"`).
+     * @param options.refId - `documentId` dell'entità a cui agganciare il file.
+     * @param options.field - Nome del campo top-level dell'entità.
+     *                        ⚠️ I campi annidati (dot-notation) non sono supportati
+     *                        nativamente dall'endpoint `/upload` di Strapi: caricare
+     *                        il file separatamente e aggiornare l'entità con `update`.
+     * @param options.path - Percorso della cartella nella Media Library (es. `"products/2024"`).
+     *                       La cartella viene creata automaticamente se non esiste (mkdir -p).
+     */
+    upload(file: Blob | string, options?: {
+        filename?: string;
+        ref?: string;
+        refId?: string | number;
+        field?: string;
+        path?: string;
+        headers?: Record<string, string>;
+    }): Promise<ZodMediaType[]>;
 }
 export default Client;

package/dist/client.js

@@ -4,6 +4,7 @@ import fetch from "node-fetch";
 import qs from "qs";
 import z from "zod";
 import { defaultStrapiFields, schemaToParser } from "./utils/schema";
+import { zodMediaSchema } from "./fields/media";
 class Client {
     static async create(endpoint, { auth, ...options } = {}) {
         const endpointURL = new URL(endpoint);
@@ -119,6 +120,11 @@ class Client {
             }
             return populate;
         };
+        this.resolveRef = (ref) => {
+            if (ref.includes("::"))
+                return ref;
+            return `api::${ref}.${ref}`;
+        };
         const headers = (() => {
             return { ...Client.headers, ...(this.options.headers || {}) };
         })();
@@ -378,6 +384,164 @@ class Client {
             throw ensureSimpleException(exception);
         }
     }
+    /*
+     * ==========================================
+     * AUTO GENERATED - upload method
+     * ==========================================
+     */
+    async getOrCreateFolder(folderPath) {
+        const segments = folderPath.split("/").filter(Boolean);
+        let currentParentId = null;
+        for (const segment of segments) {
+            const params = currentParentId === null
+                ? { filters: { name: { $eq: segment }, parent: { $null: true } } }
+                : { filters: { name: { $eq: segment }, parent: { id: { $eq: currentParentId } } } };
+            const listURL = Client.getRequestURL({
+                origin: this.origin,
+                pathname: join(this.pathname, "upload/folders"),
+                params,
+            });
+            const listResponse = await fetch(listURL, {
+                method: "GET",
+                headers: this.getAuthorizedHeaders(),
+            });
+            if (!listResponse.ok) {
+                const errorBody = await listResponse.json().catch(() => ({}));
+                throw createSimpleException({
+                    code: listResponse.status,
+                    message: errorBody.error?.message || listResponse.statusText,
+                    type: "error",
+                    source: "strapi-utils/client.ts",
+                });
+            }
+            const { data: folders } = z
+                .object({ data: z.array(z.object({ id: z.number() }).loose()) })
+                .parse(await listResponse.json());
+            if (folders.length > 0) {
+                currentParentId = folders[0].id;
+            }
+            else {
+                const createURL = Client.getRequestURL({
+                    origin: this.origin,
+                    pathname: join(this.pathname, "upload/folders"),
+                    params: {},
+                });
+                const createBody = currentParentId === null
+                    ? { name: segment }
+                    : { name: segment, parent: currentParentId };
+                const createResponse = await fetch(createURL, {
+                    method: "POST",
+                    headers: this.getAuthorizedHeaders(),
+                    body: JSON.stringify(createBody),
+                });
+                if (!createResponse.ok) {
+                    const errorBody = await createResponse.json().catch(() => ({}));
+                    throw createSimpleException({
+                        code: createResponse.status,
+                        message: errorBody.error?.message || createResponse.statusText,
+                        type: "error",
+                        source: "strapi-utils/client.ts",
+                    });
+                }
+                const { data: created } = z
+                    .object({ data: z.object({ id: z.number() }).loose() })
+                    .parse(await createResponse.json());
+                currentParentId = created.id;
+            }
+        }
+        return currentParentId;
+    }
+    /**
+     * Carica un file sulla Media Library di Strapi.
+     *
+     * @param file - Sorgente del file: `Blob`, `File` (browser) oppure stringa base64
+     *               (data URI `data:mime;base64,...` o raw base64).
+     * @param options.filename - Nome del file nel FormData. Obbligatorio per base64 e
+     *                           Blob senza nome; per `File` viene estratto automaticamente.
+     * @param options.ref - Nome del Content Type (es. `"product"` → `api::product.product`)
+     *                      oppure UID completo (es. `"plugin::users-permissions.user"`).
+     * @param options.refId - `documentId` dell'entità a cui agganciare il file.
+     * @param options.field - Nome del campo top-level dell'entità.
+     *                        ⚠️ I campi annidati (dot-notation) non sono supportati
+     *                        nativamente dall'endpoint `/upload` di Strapi: caricare
+     *                        il file separatamente e aggiornare l'entità con `update`.
+     * @param options.path - Percorso della cartella nella Media Library (es. `"products/2024"`).
+     *                       La cartella viene creata automaticamente se non esiste (mkdir -p).
+     */
+    async upload(file, options = {}) {
+        try {
+            const { ref, refId, field, headers = {} } = options;
+            let blob;
+            let fileName;
+            if (typeof file === "string") {
+                let mimeType = "application/octet-stream";
+                let rawBase64 = file;
+                if (file.startsWith("data:")) {
+                    const commaIndex = file.indexOf(",");
+                    mimeType = file.slice(5, file.indexOf(";"));
+                    rawBase64 = file.slice(commaIndex + 1);
+                }
+                const bytes = typeof Buffer !== "undefined"
+                    ? new Uint8Array(Buffer.from(rawBase64, "base64"))
+                    : (() => {
+                        const bin = atob(rawBase64);
+                        const arr = new Uint8Array(bin.length);
+                        for (let i = 0; i < bin.length; i++)
+                            arr[i] = bin.charCodeAt(i);
+                        return arr;
+                    })();
+                blob = new Blob([bytes], { type: mimeType });
+                fileName = options.filename ?? "upload";
+            }
+            else {
+                blob = file;
+                fileName = options.filename ?? ("name" in file ? file.name : "upload");
+            }
+            let folderId;
+            if (options.path) {
+                folderId = await this.getOrCreateFolder(options.path);
+            }
+            const formData = new FormData();
+            formData.append("files", blob, fileName);
+            if (ref !== undefined)
+                formData.append("ref", this.resolveRef(ref));
+            if (refId !== undefined)
+                formData.append("refId", String(refId));
+            if (field !== undefined)
+                formData.append("field", field);
+            if (folderId !== undefined) {
+                formData.append("fileInfo", JSON.stringify({ folder: folderId }));
+            }
+            const requestURL = Client.getRequestURL({
+                origin: this.origin,
+                pathname: join(this.pathname, "upload"),
+                params: {},
+            });
+            const { "Content-Type": _ct, ...headersWithoutContentType } = this.getAuthorizedHeaders();
+            const response = await fetch(requestURL, {
+                method: "POST",
+                headers: {
+                    ...headersWithoutContentType,
+                    ...headers,
+                },
+                body: formData,
+            });
+            if (!response.ok) {
+                const errorBody = await response.json().catch(() => ({}));
+                throw createSimpleException({
+                    code: response.status,
+                    message: errorBody.error?.message || response.statusText,
+                    type: "error",
+                    source: "strapi-utils/client.ts",
+                });
+            }
+            const data = await response.json();
+            return z.array(zodMediaSchema).parse(data);
+        }
+        catch (exception) {
+            throw ensureSimpleException(exception);
+        }
+    }
 }
 // #region STATIC
 Client.headers = {

package/dist/fields/media.d.ts

@@ -6,7 +6,7 @@ export declare const zodMediaSchema: z.ZodObject<{
     caption: z.ZodNullable<z.ZodString>;
     width: z.ZodNullable<z.ZodNumber>;
     height: z.ZodNullable<z.ZodNumber>;
-    formats: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+    formats: z.ZodOptional<z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodObject<{
         name: z.ZodString;
         hash: z.ZodOptional<z.ZodString>;
         ext: z.ZodOptional<z.ZodString>;
@@ -16,7 +16,7 @@ export declare const zodMediaSchema: z.ZodObject<{
         url: z.ZodString;
         width: z.ZodNumber;
         height: z.ZodNumber;
-    }, z.core.$strip>>>;
+    }, z.core.$strip>>>>;
     hash: z.ZodString;
     ext: z.ZodString;
     mime: z.ZodString;
@@ -28,7 +28,7 @@ export declare const zodMediaSchema: z.ZodObject<{
     createdAt: z.ZodISODateTime;
     updatedAt: z.ZodISODateTime;
 }, z.core.$strip>;
-type ZodMediaType = z.output<typeof zodMediaSchema>;
+export type ZodMediaType = z.output<typeof zodMediaSchema>;
 export type MediaSingleOptions = {
     required?: boolean;
 };
@@ -38,4 +38,3 @@ export type MediaSingleField = readonly ["media.single", MediaSingleOptions];
 export declare const media: {
     single: <O extends MediaSingleOptions = {}>(options?: O) => ["media.single", O];
 };
-export {};

package/dist/fields/media.js

@@ -18,6 +18,7 @@ export const zodMediaSchema = z.object({
         width: z.number(),
         height: z.number(),
     }))
+        .nullable()
         .optional(),
     hash: z.string(),
     ext: z.string(),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "simple-strapi",
-  "version": "1.0.0-alpha.22",
+  "version": "1.0.0-alpha.24",
   "type": "module",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",