@warlock.js/core 4.0.161 → 4.0.163

package/esm/resource/resource.d.ts

@@ -0,0 +1,217 @@
+import { type GenericObject } from "@mongez/reinforcements";
+import { Model } from "@warlock.js/cascade";
+import { ResourceFieldBuilder } from "./resource-field-builder";
+import { ResourceArraySchema, ResourceFieldConfig, ResourceOutputValueCastType, ResourceSchema } from "./types";
+/**
+ * Resource contract
+ */
+export interface ResourceContract {
+    /**
+     * Resource data
+     */
+    resource: GenericObject;
+    /**
+     * Resource final output
+     */
+    data: GenericObject;
+    /**
+     * Original data
+     */
+    originalData: GenericObject;
+    /**
+     * Convert resource to JSON
+     */
+    toJSON(): GenericObject;
+    /**
+     * Transform the given value with given type
+     */
+    transform(value: any, type: ResourceOutputValueCastType, locale?: string): any;
+    /**
+     * Get a input value for the given key
+     */
+    get(key: string, defaultValue?: any): any;
+    /**
+     * Set the given value for the given field
+     */
+    set(key: string, value: any): ResourceContract;
+    /**
+     * Create an array schema for transforming array items
+     */
+    arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema;
+    /**
+     * Get a string field builder
+     */
+    string(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a date field builder
+     */
+    date(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a localized field builder
+     */
+    localized(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a url field builder
+     */
+    url(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a uploadsUrl field builder
+     */
+    uploadsUrl(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a number field builder
+     */
+    number(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a boolean field builder
+     */
+    boolean(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a float field builder
+     */
+    float(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a int field builder
+     */
+    int(inputKey?: string): ResourceFieldBuilder;
+}
+/**
+ * Resource constructor
+ */
+export interface ResourceConstructor {
+    new (originalData: GenericObject | Resource | Model): ResourceContract;
+}
+export declare class Resource implements ResourceContract {
+    originalData: GenericObject | Resource | Model;
+    /**
+     * Resource data
+     */
+    resource: GenericObject;
+    /**
+     * Resource final output
+     */
+    data: GenericObject;
+    /**
+     * Tracks visited object identities during self-reference recursion.
+     * Prevents infinite loops on circular data (e.g. A.parent → B, B.parent → A).
+     */
+    protected _selfSeen?: Set<unknown>;
+    /**
+     * Raw resource schema — field declarations as written by the developer.
+     * Used by doc generators for introspection.
+     */
+    static schema: ResourceSchema;
+    /**
+     * Normalized schema — all string cast types and tuples converted to
+     * ResourceFieldBuilder instances at definition time. Used by transformOutput at runtime.
+     */
+    static parsedSchema: Record<string, ResourceFieldConfig>;
+    /**
+     * Normalize a raw schema into parsedSchema.
+     * Converts string cast types (including suffixes) and tuples into pre-built builders.
+     * Other entry types (ResourceConstructor, resolver functions, ResourceArraySchema) are kept as-is.
+     */
+    static normalizeSchema(schema: ResourceSchema): Record<string, ResourceFieldConfig>;
+    /**
+     * Constructor
+     */
+    constructor(originalData: GenericObject | Resource | Model);
+    /**
+     * Convert resource to JSON
+     */
+    toJSON(): GenericObject;
+    /**
+     * Boot method
+     * Called before transforming the resource
+     */
+    protected boot(): void;
+    /**
+     * Transform resource to output using the pre-normalized parsedSchema.
+     * Builders handle their own array/nullable logic internally.
+     * ResourceConstructor and ResourceArraySchema handle arrays in transformValue.
+     */
+    protected transformOutput(): void;
+    /**
+     * Transform the given value with given type
+     */
+    transform(value: any, type: ResourceOutputValueCastType, locale?: string): any;
+    /**
+     * Transform the given value for the given output setting.
+     * After normalization, string cast types no longer reach here — they are pre-converted to builders.
+     */
+    protected transformValue(value: any, outputSettings: ResourceFieldConfig, locale?: string): any;
+    /**
+     * Extend the resource output
+     */
+    protected extend(): void;
+    /**
+     * Transform a self-referencing field value.
+     *
+     * @example
+     * // Single: parent: "self"
+     * // Array:  children: "self[]"
+     */
+    protected transformSelfReference(value: any, isArray: boolean): any;
+    /**
+     * Resolve a single self-reference value.
+     * Uses identity-based cycle detection (id/_id) and a max depth guard.
+     */
+    protected resolveSelf(value: any): any;
+    /**
+     * Transform a single array item according to the given schema
+     */
+    protected transformArrayItem(item: any, schema: Record<string, ResourceFieldConfig>, locale?: string): GenericObject;
+    /**
+     * Get a input value for the given key
+     */
+    get(key: string, defaultValue?: any): any;
+    /**
+     * Set the given value for the given field
+     */
+    set(key: string, value: any): ResourceContract;
+    /**
+     * Create an array schema for transforming array items
+     */
+    arrayOf(schema: Record<string, ResourceFieldConfig>): ResourceArraySchema;
+    /**
+     * Get a string field builder
+     */
+    string(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a date field builder
+     */
+    date(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a localized field builder
+     */
+    localized(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a url field builder
+     */
+    url(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a uploadsUrl field builder
+     */
+    uploadsUrl(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a number field builder
+     */
+    number(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a boolean field builder
+     */
+    boolean(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a float field builder
+     */
+    float(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * Get a int field builder
+     */
+    int(inputKey?: string): ResourceFieldBuilder;
+    /**
+     * New field builder
+     */
+    protected fieldBuilder(type: ResourceOutputValueCastType, inputKey?: string): ResourceFieldBuilder;
+}
+//# sourceMappingURL=resource.d.ts.map

package/esm/resource/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../../src/resource/resource.ts"],"names":[],"mappings":"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"}

package/esm/resource/resource.js

@@ -0,0 +1,307 @@
+import {get,set}from'@mongez/reinforcements';import {Model}from'@warlock.js/cascade';import {useRequestStore}from'../http/context/request-context.js';import {ResourceFieldBuilder}from'./resource-field-builder.js';/**
+ * Maximum recursion depth for self-referencing fields.
+ * Prevents runaway serialization on deep trees or circular data.
+ */
+const MAX_SELF_DEPTH = 10;
+class Resource {
+    originalData;
+    /**
+     * Resource data
+     */
+    resource = {};
+    /**
+     * Resource final output
+     */
+    data = {};
+    /**
+     * Tracks visited object identities during self-reference recursion.
+     * Prevents infinite loops on circular data (e.g. A.parent → B, B.parent → A).
+     */
+    _selfSeen;
+    /**
+     * Raw resource schema — field declarations as written by the developer.
+     * Used by doc generators for introspection.
+     */
+    static schema = {};
+    /**
+     * Normalized schema — all string cast types and tuples converted to
+     * ResourceFieldBuilder instances at definition time. Used by transformOutput at runtime.
+     */
+    static parsedSchema = {};
+    /**
+     * Normalize a raw schema into parsedSchema.
+     * Converts string cast types (including suffixes) and tuples into pre-built builders.
+     * Other entry types (ResourceConstructor, resolver functions, ResourceArraySchema) are kept as-is.
+     */
+    static normalizeSchema(schema) {
+        const parsed = {};
+        for (const [key, value] of Object.entries(schema)) {
+            if (value === "self" || value === "self[]") {
+                // Keep self-references as-is — resolved lazily in transformValue
+                parsed[key] = value;
+            }
+            else if (typeof value === "string") {
+                parsed[key] = ResourceFieldBuilder.fromCastType(value);
+            }
+            else if (Array.isArray(value) && value.length === 2 && typeof value[0] === "string") {
+                const builder = ResourceFieldBuilder.fromCastType(value[1]);
+                builder.setInputKey(value[0]);
+                parsed[key] = builder;
+            }
+            else {
+                parsed[key] = value;
+            }
+        }
+        return parsed;
+    }
+    /**
+     * Constructor
+     */
+    constructor(originalData) {
+        this.originalData = originalData;
+        if (this.originalData instanceof Model) {
+            this.resource = this.originalData.data;
+        }
+        else if (this.originalData instanceof Resource) {
+            this.resource = this.originalData.data;
+        }
+        else {
+            this.resource = this.originalData;
+        }
+    }
+    /**
+     * Convert resource to JSON
+     */
+    toJSON() {
+        this.boot();
+        this.transformOutput();
+        this.extend();
+        return this.data;
+    }
+    /**
+     * Boot method
+     * Called before transforming the resource
+     */
+    boot() {
+        //
+    }
+    /**
+     * Transform resource to output using the pre-normalized parsedSchema.
+     * Builders handle their own array/nullable logic internally.
+     * ResourceConstructor and ResourceArraySchema handle arrays in transformValue.
+     */
+    transformOutput() {
+        const localeCode = useRequestStore()?.request?.locale;
+        const parsedSchema = this.constructor.parsedSchema;
+        for (const [outputKey, outputSettings] of Object.entries(parsedSchema)) {
+            const inputValue = this.get(outputKey);
+            const outputValue = this.transformValue(inputValue, outputSettings, localeCode);
+            if (outputValue !== undefined) {
+                this.set(outputKey, outputValue);
+            }
+        }
+    }
+    /**
+     * Transform the given value with given type
+     */
+    transform(value, type, locale) {
+        return new ResourceFieldBuilder(type).transform(value, locale);
+    }
+    /**
+     * Transform the given value for the given output setting.
+     * After normalization, string cast types no longer reach here — they are pre-converted to builders.
+     */
+    transformValue(value, outputSettings, locale) {
+        let outputValue;
+        if (outputSettings === "self" || outputSettings === "self[]") {
+            // Self-reference — resolve using the same resource class with cycle detection
+            outputValue = this.transformSelfReference(value, outputSettings === "self[]");
+        }
+        else if (typeof outputSettings === "function" &&
+            outputSettings.prototype instanceof Resource) {
+            if (!value)
+                return;
+            // Nested resource — handle both single and array values
+            if (Array.isArray(value)) {
+                if (value.length === 0)
+                    return;
+                outputValue = value
+                    .map((item) => new outputSettings(item).toJSON())
+                    .filter((v) => v !== undefined);
+            }
+            else {
+                outputValue = new outputSettings(value).toJSON();
+            }
+        }
+        else if (typeof outputSettings === "function") {
+            // Resolver function - bind to Resource instance for access to this.get(), etc.
+            outputValue = outputSettings.call(this, value, this);
+        }
+        else if (outputSettings instanceof ResourceFieldBuilder) {
+            // Builder — handles array mapping and nullable internally via isArrayField
+            const inputKey = outputSettings.getInputKey();
+            outputValue = outputSettings.transform(inputKey ? this.get(inputKey) : value, locale);
+        }
+        else if (typeof outputSettings === "object" &&
+            outputSettings !== null &&
+            "__type" in outputSettings &&
+            outputSettings.__type === "arrayOf") {
+            // ResourceArraySchema — structured array items with their own sub-schema
+            if (Array.isArray(value)) {
+                outputValue = value
+                    .map((item) => this.transformArrayItem(item, outputSettings.schema, locale))
+                    .filter((v) => v !== undefined);
+            }
+            else {
+                outputValue = this.transformArrayItem(value, outputSettings.schema, locale);
+            }
+        }
+        return outputValue;
+    }
+    /**
+     * Extend the resource output
+     */
+    extend() {
+        //
+    }
+    /**
+     * Transform a self-referencing field value.
+     *
+     * @example
+     * // Single: parent: "self"
+     * // Array:  children: "self[]"
+     */
+    transformSelfReference(value, isArray) {
+        if (isArray) {
+            return Array.isArray(value)
+                ? value.map((item) => this.resolveSelf(item)).filter((v) => v !== undefined)
+                : undefined;
+        }
+        return this.resolveSelf(value);
+    }
+    /**
+     * Resolve a single self-reference value.
+     * Uses identity-based cycle detection (id/_id) and a max depth guard.
+     */
+    resolveSelf(value) {
+        if (!value)
+            return undefined;
+        const identity = value.id ?? value._id ?? value;
+        const seen = this._selfSeen ?? new Set();
+        // Circular reference or depth limit reached — stop recursion
+        if (seen.has(identity) || seen.size >= MAX_SELF_DEPTH) {
+            return undefined;
+        }
+        seen.add(identity);
+        const SelfConstructor = this.constructor;
+        const child = new SelfConstructor(value);
+        child._selfSeen = seen;
+        return child.toJSON();
+    }
+    /**
+     * Transform a single array item according to the given schema
+     */
+    transformArrayItem(item, schema, locale) {
+        const transformedItem = {};
+        for (const [outputKey, outputSettings] of Object.entries(schema)) {
+            let fieldKey = outputKey;
+            let valueTransformType = outputSettings;
+            if (Array.isArray(outputSettings)) {
+                fieldKey = outputSettings[0];
+                valueTransformType = outputSettings[1];
+            }
+            const inputValue = get(item, fieldKey);
+            const outputValue = this.transformValue(inputValue, valueTransformType, locale);
+            if (outputValue !== undefined) {
+                set(transformedItem, outputKey, outputValue);
+            }
+        }
+        return transformedItem;
+    }
+    /**
+     * Get a input value for the given key
+     */
+    get(key, defaultValue) {
+        return get(this.resource, key, defaultValue);
+    }
+    /**
+     * Set the given value for the given field
+     */
+    set(key, value) {
+        set(this.data, key, value);
+        return this;
+    }
+    /**
+     * Create an array schema for transforming array items
+     */
+    arrayOf(schema) {
+        return {
+            __type: "arrayOf",
+            schema,
+        };
+    }
+    /**
+     * Get a string field builder
+     */
+    string(inputKey) {
+        return this.fieldBuilder("string", inputKey);
+    }
+    /**
+     * Get a date field builder
+     */
+    date(inputKey) {
+        return this.fieldBuilder("date", inputKey);
+    }
+    /**
+     * Get a localized field builder
+     */
+    localized(inputKey) {
+        return this.fieldBuilder("localized", inputKey);
+    }
+    /**
+     * Get a url field builder
+     */
+    url(inputKey) {
+        return this.fieldBuilder("url", inputKey);
+    }
+    /**
+     * Get a uploadsUrl field builder
+     */
+    uploadsUrl(inputKey) {
+        return this.fieldBuilder("uploadsUrl", inputKey);
+    }
+    /**
+     * Get a number field builder
+     */
+    number(inputKey) {
+        return this.fieldBuilder("number", inputKey);
+    }
+    /**
+     * Get a boolean field builder
+     */
+    boolean(inputKey) {
+        return this.fieldBuilder("boolean", inputKey);
+    }
+    /**
+     * Get a float field builder
+     */
+    float(inputKey) {
+        return this.fieldBuilder("float", inputKey);
+    }
+    /**
+     * Get a int field builder
+     */
+    int(inputKey) {
+        return this.fieldBuilder("int", inputKey);
+    }
+    /**
+     * New field builder
+     */
+    fieldBuilder(type, inputKey) {
+        const builder = new ResourceFieldBuilder(type);
+        if (inputKey) {
+            builder.setInputKey(inputKey);
+        }
+        return builder;
+    }
+}export{Resource};//# sourceMappingURL=resource.js.map

package/esm/resource/resource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.js","sources":["../../src/resource/resource.ts"],"sourcesContent":[null],"names":[],"mappings":"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"}

package/esm/resource/types.d.ts

@@ -0,0 +1,74 @@
+import { ResponseStatus } from "../http";
+import { type ResourceConstructor, type ResourceContract } from "./resource";
+import { type ResourceFieldBuilder } from "./resource-field-builder";
+export type ResourceOutputValueCastType = "string" | "number" | "date" | "localized" | "boolean" | "url" | "float" | "int" | "object" | "array" | "uploadsUrl"
+/**
+ * Storage url means the value will be generated using current storage.url method
+ */
+ | "storageUrl";
+/**
+ * Self-referencing type — resolves the field using the same resource class.
+ * - `"self"` for a single nested self-reference
+ * - `"self[]"` for an array of self-references
+ */
+export type ResourceSelfReference = "self" | "self[]";
+/**
+ * Cast type with modifier suffixes for use in resource schemas.
+ * - `[]` suffix declares the field as an array (e.g. "string[]")
+ * - `?` suffix declares the field as nullable — always present in output, value or null (e.g. "number?")
+ * - Combined: `[]` must come before `?` (e.g. "string[]?")
+ */
+export type ResourceCastType = ResourceOutputValueCastType | `${ResourceOutputValueCastType}[]` | `${ResourceOutputValueCastType}?` | `${ResourceOutputValueCastType}[]?`;
+export type ResourceArraySchema = {
+    __type: "arrayOf";
+    schema: Record<string, ResourceFieldConfig>;
+};
+export type ResourceFieldConfig = ResourceCastType | ResourceConstructor | ResourceSelfReference | [string, ResourceCastType] | ResourceFieldBuilder | ResourceArraySchema | ((value: any, resource: ResourceContract) => any);
+export type ResourceSchema = Record<string, ResourceFieldConfig>;
+export type ResourceFieldBuilderDateOutputOptions = {
+    /**
+     * If set to true, then it will be returned as a formatted date
+     */
+    format?: boolean;
+    /**
+     * Return unix timestamp (Milliseconds)
+     */
+    timestamp?: boolean;
+    /**
+     * Return human readable date
+     */
+    humanTime?: boolean;
+    /**
+     * Return timezone
+     */
+    timezone?: boolean;
+    /**
+     * Return timezone offset
+     */
+    offset?: boolean;
+    /**
+     * Return date in current locale
+     */
+    locale?: boolean;
+    /**
+     * Return date in iso format
+     */
+    iso?: boolean;
+} | "format" | "timestamp" | "humanTime" | "locale" | "iso";
+/**
+ * Allowed value types in a response schema body.
+ * - Cast type string for primitive fields (e.g. "string", "number")
+ * - ResourceConstructor for a single nested resource object
+ * - [ResourceConstructor] (tuple) for an array of a nested resource
+ */
+export type ResponseBodyValue = ResourceOutputValueCastType | ResourceConstructor | [ResourceConstructor];
+/**
+ * Response schema for a controller — used for documentation / OpenAPI generation.
+ * Keyed by HTTP status code, each entry declares the expected response body shape.
+ */
+export type ResponseSchema = {
+    [statusCode in ResponseStatus]?: {
+        body: Record<string, ResponseBodyValue>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/esm/resource/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resource/types.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAC7E,OAAO,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAErE,MAAM,MAAM,2BAA2B,GACnC,QAAQ,GACR,QAAQ,GACR,MAAM,GACN,WAAW,GACX,SAAS,GACT,KAAK,GACL,OAAO,GACP,KAAK,GACL,QAAQ,GACR,OAAO,GACP,YAAY;AACd;;GAEG;GACD,YAAY,CAAC;AAEjB;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAEtD;;;;;GAKG;AACH,MAAM,MAAM,gBAAgB,GACxB,2BAA2B,GAC3B,GAAG,2BAA2B,IAAI,GAClC,GAAG,2BAA2B,GAAG,GACjC,GAAG,2BAA2B,KAAK,CAAC;AAExC,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;CAC7C,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B,gBAAgB,GAChB,mBAAmB,GACnB,qBAAqB,GACrB,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC1B,oBAAoB,GACpB,mBAAmB,GACnB,CAAC,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,gBAAgB,KAAK,GAAG,CAAC,CAAC;AAEtD,MAAM,MAAM,cAAc,GAAG,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;AAEjE,MAAM,MAAM,qCAAqC,GAC7C;IACE;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB;;OAEG;IACH,GAAG,CAAC,EAAE,OAAO,CAAC;CACf,GACD,QAAQ,GACR,WAAW,GACX,WAAW,GACX,QAAQ,GACR,KAAK,CAAC;AAEV;;;;;GAKG;AACH,MAAM,MAAM,iBAAiB,GACzB,2BAA2B,GAC3B,mBAAmB,GACnB,CAAC,mBAAmB,CAAC,CAAC;AAE1B;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG;KAC1B,UAAU,IAAI,cAAc,CAAC,CAAC,EAAE;QAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;KACzC;CACF,CAAC"}

package/esm/restful/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./restful";
+//# sourceMappingURL=index.d.ts.map

package/esm/restful/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/restful/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAC"}