@warlock.js/core 4.0.174 → 4.1.2

package/esm/resource/resource-field-builder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-field-builder.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/resource-field-builder.ts"],"sourcesContent":["import { isObject } from \"@mongez/supportive-is\";\nimport dayjs from \"dayjs\";\nimport relativeTime from \"dayjs/plugin/relativeTime.js\";\nimport { storage } from \"../storage\";\n\n// `humanTime` date options call dayjs(...).fromNow(), which lives in the\n// relativeTime plugin. dayjs.extend is idempotent (a plugin registers itself\n// once), so extending here at module load is safe to repeat.\ndayjs.extend(relativeTime);\nimport { uploadsUrl, url } from \"../utils/urls\";\nimport { type LocalizedObject } from \"./../utils/get-localized\";\nimport { ResourceFieldBuilderDateOutputOptions, type ResourceOutputValueCastType } from \"./types\";\n\nexport class ResourceFieldBuilder {\n  /**\n   * Field value\n   */\n  protected fieldValue?: unknown;\n\n  /**\n   * Whether the value is nullable\n   * If set to false and value is null, it will be returned as undefined\n   */\n  protected isNullable = false;\n\n  /**\n   * Whether this field is an array\n   * When true, transform() maps over each element using the base type\n   */\n  protected isArrayField = false;\n\n  /**\n   * Default value\n   */\n  protected defaultValue?: unknown;\n\n  /**\n   * Date format\n   */\n  protected dateFormat = \"DD-MM-YYYY hh:mm:ss A\";\n\n  /**\n   * Input key\n   */\n  protected inputKeyToUse?: string;\n\n  /**\n   * Add a condition before transforming the value\n   */\n  protected condition?: () => boolean;\n\n  /**\n   * Define how date fields are returned\n   * If type of the date options is string then it will be returned as a string\n   * otherwise it will be returned as an object contains the date options\n   */\n  protected dateOptionsInput: ResourceFieldBuilderDateOutputOptions = {\n    format: true,\n    timestamp: true,\n    timezone: false,\n    locale: false,\n    offset: false,\n    humanTime: true,\n    iso: true,\n  };\n\n  /**\n   * Constructor\n   */\n  public constructor(protected readonly type: ResourceOutputValueCastType) {\n    //\n  }\n\n  /**\n   * Parse a cast type string (including suffixes) into a configured builder.\n   * Suffix order: [] before ? (e.g. \"string[]?\")\n   * Parsing strips right-to-left: ? first, then [].\n   */\n  public static fromCastType(castType: string): ResourceFieldBuilder {\n    let baseType = castType;\n    let nullable = false;\n    let isArray = false;\n\n    if (baseType.endsWith(\"?\")) {\n      nullable = true;\n      baseType = baseType.slice(0, -1);\n    }\n\n    if (baseType.endsWith(\"[]\")) {\n      isArray = true;\n      baseType = baseType.slice(0, -2);\n    }\n\n    const builder = new ResourceFieldBuilder(baseType as ResourceOutputValueCastType);\n    if (nullable) builder.nullable();\n    if (isArray) builder.array();\n    return builder;\n  }\n\n  /**\n   * Set input key\n   * Will be used in transformation if provided\n   */\n  public setInputKey(key: string) {\n    this.inputKeyToUse = key;\n\n    return this;\n  }\n\n  /**\n   * Add a condition before transforming the value\n   */\n  public when(condition: () => boolean) {\n    this.condition = condition;\n    return this;\n  }\n\n  /**\n   * Set whether the value is nullable\n   */\n  public nullable() {\n    this.isNullable = true;\n    return this;\n  }\n\n  /**\n   * Mark this field as an array\n   * transform() will map over each element using the base type\n   */\n  public array() {\n    this.isArrayField = true;\n    return this;\n  }\n\n  /**\n   * Get input key\n   */\n  public getInputKey() {\n    return this.inputKeyToUse;\n  }\n\n  /**\n   * Set default value\n   */\n  public default(value: unknown) {\n    this.defaultValue = value;\n\n    return this;\n  }\n\n  /**\n   * Set field format\n   */\n  public format(format: string) {\n    this.dateFormat = format;\n\n    return this;\n  }\n\n  /**\n   * Set date options\n   * This will override current date options\n   */\n  public dateOptions(options: ResourceFieldBuilderDateOutputOptions) {\n    this.dateOptionsInput = options;\n\n    return this;\n  }\n\n  /**\n   * Transform the value.\n   * When isArrayField is true, maps over each element using transformSingleValue.\n   */\n  public transform(value: any, locale?: string) {\n    if (this.isArrayField) {\n      if (!Array.isArray(value)) {\n        return this.isNullable ? null : [];\n      }\n\n      return value\n        .map((item) => this.transformSingleValue(item, locale))\n        .filter((v) => v !== undefined);\n    }\n\n    return this.transformSingleValue(value, locale);\n  }\n\n  /**\n   * Transform a single value according to the base type.\n   */\n  protected transformSingleValue(value: any, locale?: string) {\n    if (value === undefined || value === null) {\n      return this.isNullable ? null : this.defaultValue;\n    }\n\n    if (this.condition && !this.condition()) {\n      return this.isNullable ? null : this.defaultValue;\n    }\n\n    switch (this.type) {\n      case \"string\":\n        return String(value);\n      case \"number\": {\n        const num = Number(value);\n        return isNaN(num) ? (this.isNullable ? null : undefined) : num;\n      }\n      case \"boolean\":\n        return Boolean(value);\n      case \"float\": {\n        const float = parseFloat(value);\n        return isNaN(float) ? (this.isNullable ? null : undefined) : float;\n      }\n\n      case \"int\": {\n        const int = parseInt(value);\n        return isNaN(int) ? (this.isNullable ? null : undefined) : int;\n      }\n\n      case \"date\":\n        return this.transformDate(value as string | Date, locale);\n      case \"localized\":\n        return this.transformLocalized(value as LocalizedObject[], locale);\n      case \"url\":\n        return url(value as string);\n      case \"uploadsUrl\":\n        return uploadsUrl(value as string);\n      case \"storageUrl\":\n        return storage.url(value as string);\n      case \"object\":\n        return isObject(value) && !Array.isArray(value) && Object.keys(value).length > 0\n          ? value\n          : this.isNullable\n            ? null\n            : undefined;\n      case \"array\":\n        return Array.isArray(value) ? value : this.isNullable ? null : undefined;\n    }\n  }\n\n  /**\n   * Transform date value\n   */\n  protected transformDate(value: string | Date, locale?: string) {\n    if (typeof this.dateOptionsInput === \"string\") {\n      if (this.dateOptionsInput === \"format\") {\n        return dayjs(value).format(this.dateFormat);\n      }\n\n      if (this.dateOptionsInput === \"iso\") {\n        return dayjs(value).toISOString();\n      }\n\n      if (this.dateOptionsInput === \"timestamp\") {\n        return dayjs(value).valueOf();\n      }\n\n      if (this.dateOptionsInput === \"humanTime\") {\n        return (dayjs as any)(value).fromNow();\n      }\n\n      if (this.dateOptionsInput === \"locale\") {\n        if (!locale) {\n          return dayjs(value).format(this.dateFormat);\n        }\n\n        return dayjs(value).locale(locale).format(this.dateFormat);\n      }\n    }\n\n    // now manage it as an object based on date options what's marked as true\n    const output: {\n      format?: string;\n      timestamp?: number;\n      humanTime?: string;\n      locale?: string;\n      iso?: string;\n    } = {};\n\n    let dayjsObject = dayjs((value as any)?.iso || value);\n\n    if (locale) {\n      dayjsObject = dayjsObject.locale(locale);\n    }\n\n    if (this.dateOptionsInput.iso) {\n      output.iso = dayjsObject.toISOString();\n    }\n\n    if (this.dateOptionsInput.format) {\n      output.format = dayjsObject.format(this.dateFormat);\n    }\n\n    if (this.dateOptionsInput.timestamp) {\n      output.timestamp = dayjsObject.valueOf();\n    }\n\n    if (this.dateOptionsInput.humanTime) {\n      output.humanTime = (dayjsObject as any).fromNow();\n    }\n\n    if (this.dateOptionsInput.locale) {\n      output.locale = dayjsObject.format(this.dateFormat);\n    }\n\n    if (this.dateOptionsInput.iso) {\n      output.iso = dayjsObject.toISOString();\n    }\n\n    return output;\n  }\n\n  /**\n   * Transform localized value\n   */\n  protected transformLocalized(value: LocalizedObject[] | string, locale?: string) {\n    if (typeof value === \"string\") {\n      return value;\n    }\n\n    if (!locale) {\n      return value[0]?.value || value;\n    }\n\n    return value.find((item) => item.localeCode === locale)?.value;\n  }\n}\n"],"mappings":"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"}

package/esm/resource/resource.d.mts

@@ -0,0 +1,221 @@
+import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
+import { ResourceArraySchema, ResourceFieldConfig, ResourceOutputValueCastType, ResourceSchema } from "./types.mjs";
+import { Model } from "@warlock.js/cascade";
+import { GenericObject } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/core/src/resource/resource.d.ts
+/**
+ * Resource contract
+ */
+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
+ */
+interface ResourceConstructor {
+  new (originalData: GenericObject | Resource | Model): ResourceContract;
+}
+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;
+}
+//#endregion
+export { Resource, ResourceConstructor, ResourceContract };
+//# sourceMappingURL=resource.d.mts.map

package/esm/resource/resource.d.mts.map

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

package/esm/resource/resource.mjs

@@ -0,0 +1,239 @@
+import { useRequestStore } from "../http/context/request-context.mjs";
+import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
+import { Model } from "@warlock.js/cascade";
+import { get, isLazy, set } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/core/src/resource/resource.ts
+/**
+* Maximum recursion depth for self-referencing fields.
+* Prevents runaway serialization on deep trees or circular data.
+*/
+const MAX_SELF_DEPTH = 10;
+var Resource = class Resource {
+	static {
+		this.schema = {};
+	}
+	static {
+		this.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[]") parsed[key] = value;
+		else if (isLazy(value)) 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;
+		this.resource = {};
+		this.data = {};
+		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 !== void 0) 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 (isLazy(outputSettings)) return this.transformValue(value, outputSettings.resolve(), locale);
+		if (outputSettings === "self" || outputSettings === "self[]") outputValue = this.transformSelfReference(value, outputSettings === "self[]");
+		else if (typeof outputSettings === "function" && outputSettings.prototype instanceof Resource) {
+			if (!value) return;
+			if (Array.isArray(value)) {
+				if (value.length === 0) return;
+				outputValue = value.map((item) => new outputSettings(item).toJSON()).filter((v) => v !== void 0);
+			} else outputValue = new outputSettings(value).toJSON();
+		} else if (typeof outputSettings === "function") outputValue = outputSettings.call(this, value, this);
+		else if (outputSettings instanceof ResourceFieldBuilder) {
+			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") if (Array.isArray(value)) outputValue = value.map((item) => this.transformArrayItem(item, outputSettings.schema, locale)).filter((v) => v !== void 0);
+		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 !== void 0) : void 0;
+		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 void 0;
+		const identity = value.id ?? value._id ?? value;
+		const seen = this._selfSeen ?? /* @__PURE__ */ new Set();
+		if (seen.has(identity) || seen.size >= MAX_SELF_DEPTH) return;
+		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 !== void 0) 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;
+	}
+};
+
+//#endregion
+export { Resource };
+//# sourceMappingURL=resource.mjs.map

package/esm/resource/resource.mjs.map

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

package/esm/resource/types.d.mts

@@ -0,0 +1,77 @@
+import { ResponseStatus } from "../http/response.mjs";
+import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
+import { ResourceConstructor, ResourceContract } from "./resource.mjs";
+import { Lazy } from "@mongez/reinforcements";
+
+//#region ../../@warlock.js/core/src/resource/types.d.ts
+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
+ */
+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[]?")
+ */
+type ResourceCastType = ResourceOutputValueCastType | `${ResourceOutputValueCastType}[]` | `${ResourceOutputValueCastType}?` | `${ResourceOutputValueCastType}[]?`;
+type ResourceArraySchema = {
+  __type: "arrayOf";
+  schema: Record<string, ResourceFieldConfig>;
+};
+type ResourceFieldConfig = ResourceCastType | ResourceConstructor | ResourceSelfReference | Lazy<ResourceConstructor> | [string, ResourceCastType] | ResourceFieldBuilder | ResourceArraySchema | ((value: any, resource: ResourceContract) => any);
+type ResourceSchema = Record<string, ResourceFieldConfig>;
+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
+ */
+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.
+ */
+type ResponseSchema = { [statusCode in ResponseStatus]?: {
+  body: Record<string, ResponseBodyValue>;
+} };
+//#endregion
+export { ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyValue, ResponseSchema };
+//# sourceMappingURL=types.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/types.ts"],"mappings":";;;;;;KAKY,2BAAA;;;AAAZ;;;;AAAuC;AAsBvC;;KAAY,qBAAA;;AAAqB;AAQjC;;;;KAAY,gBAAA,GACR,2BAAA,MACG,2BAAA,UACA,2BAAA,SACA,2BAAA;AAAA,KAEK,mBAAA;EACV,MAAA;EACA,MAAA,EAAQ,MAAM,SAAS,mBAAA;AAAA;AAAA,KAGb,mBAAA,GACR,gBAAA,GACA,mBAAA,GACA,qBAAA,GACA,IAAA,CAAK,mBAAA,aACI,gBAAA,IACT,oBAAA,GACA,mBAAA,KACE,KAAA,OAAY,QAAA,EAAU,gBAAA;AAAA,KAEhB,cAAA,GAAiB,MAAM,SAAS,mBAAA;AAAA,KAEhC,qCAAA;EAnBL;;AAA2B;EAwB5B,MAAA;EAtByB;;;EA0BzB,SAAA;EAxBJ;;;EA4BI,SAAA;EA5BsC;AAG5C;;EA6BM,QAAA;EA5BF;;;EAgCE,MAAA;EA7BF;;;EAiCE,MAAA;EA7BsB;;;EAiCtB,GAAA;AAAA;;;;;;;KAcM,iBAAA,GACR,2BAAA,GACA,mBAAA,IACC,mBAAA;;;;AAlDuC;KAwDhC,cAAA,oBACK,cAAA;EACb,IAAA,EAAM,MAAA,SAAe,iBAAA;AAAA"}

package/esm/restful/index.d.mts

@@ -0,0 +1 @@
+import { Restful } from "./restful.mjs";

package/esm/restful/index.mjs

@@ -0,0 +1,3 @@
+import { Restful } from "./restful.mjs";
+
+export {  };