@warlock.js/core 4.0.174 → 4.1.2

package/esm/repositories/repository.manager.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"repository.manager.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/repositories/repository.manager.ts"],"sourcesContent":["import { cache, CacheKey, type CacheDriver } from \"@warlock.js/cache\";\nimport { config } from \"../config\";\nimport { CascadeAdapter } from \"./adapters/cascade\";\nimport type {\n  AllRepositoryOptions,\n  ChunkCallback,\n  CursorPaginationResult,\n  FilterRules,\n  PaginationResult,\n  QueryBuilderContract,\n  RepositoryAdapterContract,\n  RepositoryOptions,\n  SaveMode,\n  TypedAllRepositoryOptions,\n  TypedRepositoryOptions,\n  TypedRepositoryOptionsWithCursor,\n  TypedRepositoryOptionsWithPages,\n} from \"./contracts\";\n\n/**\n * Base repository manager class\n * Provides ORM-agnostic data access layer with support for listing, filtering,\n * caching, pagination, and CRUD operations\n *\n * @template T - The type of records managed by this repository\n *\n * @example\n * // Extend with source\n * class UserRepository extends RepositoryManager<User> {\n *   protected source = User;\n *   protected filterBy = { email: \"=\", role: [\"in\", \"role\"] };\n * }\n *\n * @example\n * // Direct instantiation with adapter\n * const userRepo = new RepositoryManager<User>(new PrismaAdapter(prisma.user));\n */\nexport class RepositoryManager<T = unknown, F = Record<string, any>> {\n  /**\n   * Adapter instance (lazy-loaded)\n   * @private\n   */\n  protected _adapter?: RepositoryAdapterContract<T>;\n\n  /**\n   * Data source reference (Model, Prisma client, table name, etc.)\n   * Used by createDefaultAdapter to instantiate the appropriate adapter\n   * @protected\n   */\n  protected source?: any;\n\n  // ============================================================================\n  // CONFIGURATION PROPERTIES\n  // ============================================================================\n\n  /**\n   * Filter definitions\n   * Maps filter keys to filter rules\n   * @protected\n   */\n  protected filterBy: FilterRules = {};\n\n  /**\n   * Get adapter instance (lazy-loaded)\n   * Resolution order:\n   * 1. Use injected adapter from constructor\n   * 2. Use config-based resolver if available\n   * 3. Use createDefaultAdapter\n   *\n   * @returns Adapter instance\n   * @protected\n   */\n  protected get adapter(): RepositoryAdapterContract<T> {\n    if (this._adapter) {\n      return this._adapter;\n    }\n\n    // Try config-based resolver\n    const resolver = config.key(\"repository.adapterResolver\");\n\n    if (resolver) {\n      this._adapter = resolver(this);\n    } else {\n      this._adapter = config.get(\"repository.defaultAdapter\") || this.createDefaultAdapter();\n    }\n\n    // Adapter is guaranteed to be set at this point\n    return this._adapter!;\n  }\n\n  /**\n   * Default repository options\n   * @protected\n   */\n  protected defaultOptions: Partial<RepositoryOptions> =\n    config.get(\"repository.defaultOptions\") || {};\n\n  /**\n   * Simple select columns (used with simple filter)\n   * @protected\n   */\n  protected simpleSelectColumns: string[] = [];\n\n  /**\n   * Active column name\n   * @default \"isActive\"\n   * @protected\n   */\n  protected isActiveColumn?: string;\n\n  /**\n   * Active column value\n   * @default true\n   * @protected\n   */\n  protected isActiveValue?: any;\n\n  /**\n   * Repository name (for events)\n   * @protected\n   */\n  protected name?: string;\n\n  /**\n   * Whether caching is enabled\n   * @default true\n   * @protected\n   */\n  protected isCacheable = config.get(\"repository.isCacheable\") ?? true;\n\n  /**\n   * Cache driver instance\n   * @protected\n   */\n  protected cacheDriver: CacheDriver<any, any> = config.get(\"repository.cacheDriver\") || cache;\n\n  /**\n   * List of all events callbacks\n   */\n  protected eventsCallbacks: any[] = [];\n\n  /**\n   * Constructor\n   * @param adapter - Optional adapter instance for direct injection\n   */\n  public constructor(adapter?: RepositoryAdapterContract<T>) {\n    if (adapter) {\n      this._adapter = adapter;\n    }\n\n    // Wait for constructor to finish and all properties are properly registered\n    // specially for adapter to get instanciated\n    setTimeout(() => {\n      this.registerEvents();\n    }, 0);\n  }\n\n  /**\n   * Register events\n   */\n  public registerEvents() {\n    this.eventsCallbacks.push(\n      ...this.adapter.registerEvents((source: any) => {\n        // this.clearCache({ id: source.id });\n        this.clearCache();\n      }),\n    );\n  }\n\n  /**\n   * Unregister events\n   */\n  public cleanuEvents() {\n    this.eventsCallbacks.forEach((callback) => {\n      callback();\n    });\n    this.eventsCallbacks = [];\n  }\n\n  /**\n   * Create default adapter instance\n   * Override this method to provide custom adapter creation logic\n   *\n   * @returns Adapter instance\n   * @throws Error if no source is configured\n   * @protected\n   */\n  protected createDefaultAdapter(): RepositoryAdapterContract<T> {\n    if (!this.source) {\n      throw new Error(\n        \"No adapter or source configured. Either pass an adapter to the constructor, \" +\n          \"set the 'source' property, or configure 'repository.adapterResolver' in config.\",\n      );\n    }\n\n    // Default: assume source is a Cascade Model\n    if (typeof this.source === \"function\") {\n      // Lazy import to avoid circular dependencies\n      return new CascadeAdapter(this.source) as unknown as RepositoryAdapterContract<T>;\n    }\n\n    throw new Error(\n      \"Cannot create default adapter for this source type. \" +\n        \"Please provide an adapter or configure repository.adapterResolver.\",\n    );\n  }\n\n  // ============================================================================\n  // UTILITY METHODS\n  // ============================================================================\n\n  /**\n   * Get repository name\n   * @returns Repository name\n   * @public\n   */\n  public getName(): string {\n    if (this.name) {\n      return this.name;\n    }\n\n    // Try to get collection name from source\n    this.name = this.adapter.resolveRepositoryName() || \"unknown\";\n\n    return this.name;\n  }\n\n  /**\n   * Get is active column\n   */\n  protected getIsActiveColumn(): string {\n    return this.isActiveColumn || config.key(\"repository.isActiveColumn\") || \"isActive\";\n  }\n\n  /**\n   * Get is active value\n   */\n  protected getIsActiveValue(): any {\n    return this.isActiveValue ?? config.key(\"repository.isActiveValue\") ?? true;\n  }\n\n  /**\n   * Create new query builder instance\n   * @returns Query builder\n   * @public\n   */\n  public newQuery() {\n    return this.adapter.query();\n  }\n\n  /**\n   * Create new model instance\n   * @param data - Model data\n   * @returns Model instance\n   * @public\n   */\n  public newModel(data?: any): T {\n    return this.adapter.createModel(data);\n  }\n\n  /**\n   * Get active filter object\n   * @returns Filter object for active records\n   * @protected\n   */\n  protected getIsActiveFilter() {\n    return {\n      [this.getIsActiveColumn()]: this.getIsActiveValue(),\n    };\n  }\n\n  // ============================================================================\n  // FINDING METHODS\n  // ============================================================================\n\n  /**\n   * Find a record by ID\n   * @param id - Record ID or model instance\n   * @returns Promise resolving to record or null\n   * @public\n   */\n  public async find(id: string | number | T): Promise<T | null> {\n    return this.adapter.find(id);\n  }\n\n  /**\n   * Find a record by column value\n   * @param column - Column name\n   * @param value - Value to search for\n   * @returns Promise resolving to record or null\n   * @public\n   */\n  public async findBy(column: string, value: any): Promise<T | null> {\n    return this.adapter.findBy(column, value);\n  }\n\n  /**\n   * Find active record by ID\n   * @param id - Record ID or model instance\n   * @returns Promise resolving to active record or null\n   * @public\n   */\n  public async findActive(id: string | number | T): Promise<T | null> {\n    return this.newQuery()\n      .where({\n        id,\n        ...this.getIsActiveFilter(),\n      })\n      .first();\n  }\n\n  /**\n   * Find active record by column value\n   * @param column - Column name\n   * @param value - Value to search for\n   * @returns Promise resolving to active record or null\n   * @public\n   */\n  public async findByActive(column: string, value: any): Promise<T | null> {\n    return this.newQuery()\n      .where({\n        [column]: value,\n        ...this.getIsActiveFilter(),\n      })\n      .first();\n  }\n\n  /**\n   * Get first record matching options\n   * @param options - Repository options\n   * @returns Promise resolving to first record or null\n   * @public\n   */\n  public async first(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return query.limit(1).first();\n  }\n\n  /**\n   * Get id by the given filter\n   */\n  public async firstId(options?: TypedRepositoryOptions<F>): Promise<string | number | undefined> {\n    const record = await this.first(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first active id\n   */\n  public async firstActiveId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstActive(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first cached id\n   */\n  public async firstCachedId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstCached(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first active cached id\n   */\n  public async firstActiveCachedId(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | number | undefined> {\n    const record = await this.firstActiveCached(options);\n    return (record as any)?.id;\n  }\n\n  /**\n   * Get first uuid\n   */\n  public async firstUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.first(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first active uuid\n   */\n  public async firstActiveUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.firstActive(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first cached uuid\n   */\n  public async firstCachedUuid(options?: TypedRepositoryOptions<F>): Promise<string | undefined> {\n    const record = await this.firstCached(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first active cached uuid\n   */\n  public async firstActiveCachedUuid(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<string | undefined> {\n    const record = await this.firstActiveCached(options);\n    return (record as any)?.uuid;\n  }\n\n  /**\n   * Get first cached record\n   */\n  public async firstCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const results = await this.allCached({\n      ...options,\n      limit: 1,\n    } as TypedAllRepositoryOptions<F>);\n\n    return results[0] || null;\n  }\n\n  /**\n   * Get first active record\n   * @param options - Repository options\n   * @returns Promise resolving to first active record or null\n   * @public\n   */\n  public async firstActive(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.first({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get first active cached record\n   * @param options - Repository options\n   * @returns Promise resolving to first active cached record or null\n   * @public\n   */\n  public async firstActiveCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.firstCached({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last record matching options\n   * @param options - Repository options\n   * @returns Promise resolving to last record or null\n   * @public\n   */\n  public async last(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.first({\n      orderBy: {\n        id: \"desc\",\n      },\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last cached record\n   */\n  public async lastCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    const results = await this.allCached(\n      this.asTypedAll({\n        ...options,\n        limit: 1,\n        orderBy: { id: \"desc\" },\n      }),\n    );\n\n    return results[0] || null;\n  }\n\n  /**\n   * Get last active record\n   * @param options - Repository options\n   * @returns Promise resolving to last active record or null\n   * @public\n   */\n  public async lastActive(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.last({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  /**\n   * Get last active cached record\n   * @param options - Repository options\n   * @returns Promise resolving to last active cached record or null\n   * @public\n   */\n  public async lastActiveCached(options?: TypedRepositoryOptions<F>): Promise<T | null> {\n    return this.lastCached({\n      ...this.getIsActiveFilter(),\n      ...options,\n    } as TypedRepositoryOptions<F>);\n  }\n\n  // ============================================================================\n  // LISTING METHODS\n  // ============================================================================\n\n  /**\n   * List records with pagination\n   * Supports both traditional page-based and cursor-based pagination\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   *\n   * @example\n   * // Traditional pagination (default)\n   * const result = await repo.list({ page: 2, limit: 10 });\n   *\n   * @example\n   * // Cursor pagination\n   * const result = await repo.list({\n   *   paginationMode: \"cursor\",\n   *   limit: 20,\n   *   cursor: lastId,\n   *   direction: \"next\"\n   * });\n   *\n   * @public\n   */\n  public async list(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async list(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async list(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl(options);\n  }\n\n  /**\n   * Internal list implementation - no overloads, handles union type\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @private\n   */\n  private async _listImpl(\n    options?: RepositoryOptions,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options as TypedRepositoryOptions<F>);\n    const paginationMode = opts.paginationMode || \"pages\";\n\n    // applyOptionsToQuery handles cursor phase 1 (WHERE + ORDER BY) internally\n    // when paginationMode === \"cursor\", ensuring the cursor column is always\n    // the primary sort key before any other options are applied.\n    this.applyOptionsToQuery(query, opts);\n\n    if (paginationMode === \"cursor\") {\n      return query.cursorPaginate({\n        limit: opts.limit || opts.defaultLimit || 15,\n        cursor: opts.cursor,\n        direction: opts.direction,\n        cursorColumn: opts.cursorColumn,\n      });\n    }\n\n    // Traditional page-based pagination (default)\n    const page = opts.page || 1;\n    const limit = opts.limit || opts.defaultLimit || 15;\n\n    return query.paginate(page, limit);\n  }\n\n  /**\n   * List all records without pagination\n   * @param options - Repository options\n   * @returns Promise resolving to array of records\n   * @public\n   */\n  public async all(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    const query = this.newQuery();\n\n    // Apply options\n    const opts = this.prepareOptions(options);\n    this.applyOptionsToQuery(query, opts);\n\n    return query.get();\n  }\n\n  /**\n   * List active records with pagination\n   * Supports both page-based and cursor-based pagination\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async listActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async listActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async listActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  /**\n   * List all active records without pagination\n   * @param options - Repository options\n   * @returns Promise resolving to array of active records\n   * @public\n   */\n  public async allActive(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    return this.all(this.asTypedAll({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // EXISTENCE CHECKS\n  // ============================================================================\n\n  /**\n   * Check if record exists matching filter\n   * @param filter - Repository options\n   * @returns Promise resolving to true if exists\n   * @public\n   */\n  public async exists(filter?: TypedRepositoryOptions<F>): Promise<boolean> {\n    return !!(await this.first(filter));\n  }\n\n  /**\n   * Check if active record exists matching filter\n   * @param filter - Repository options\n   * @returns Promise resolving to true if active record exists\n   * @public\n   */\n  public async existsActive(filter?: TypedRepositoryOptions<F>): Promise<boolean> {\n    return !!(await this.firstActive(filter));\n  }\n\n  /**\n   * Check if record exists by ID\n   * @param id - Record ID\n   * @returns Promise resolving to true if exists\n   * @public\n   */\n  public async idExists(id: number | string): Promise<boolean> {\n    return !!(await this.find(id));\n  }\n\n  /**\n   * Check if active record exists by ID\n   * @param id - Record ID\n   * @returns Promise resolving to true if active record exists\n   * @public\n   */\n  public async idExistsActive(id: number | string): Promise<boolean> {\n    return !!(await this.findActive(id));\n  }\n\n  /**\n   * Prepare options — merges defaultOptions with caller options.\n   * Returning as TypedRepositoryOptions<F> ensures internal composition\n   * (spread + forward) satisfies the typed public API without per-call casts.\n   */\n  protected prepareOptions(options?: TypedRepositoryOptions<F>): TypedRepositoryOptions<F> {\n    return { ...(this.defaultOptions || {}), ...(options || {}) } as TypedRepositoryOptions<F>;\n  }\n\n  /**\n   * Cast a plain `RepositoryOptions` spread to the typed variant.\n   * Used internally when composing options across method calls where the\n   * spread breaks the F-generic inference chain.\n   */\n  protected asTyped(opts: RepositoryOptions): TypedRepositoryOptions<F> {\n    return opts as TypedRepositoryOptions<F>;\n  }\n\n  protected asTypedAll(opts: AllRepositoryOptions): TypedAllRepositoryOptions<F> {\n    return opts as TypedAllRepositoryOptions<F>;\n  }\n\n  // ============================================================================\n  // HELPER METHODS\n  // ============================================================================\n\n  /**\n   * Apply repository options to query\n   * @param query - Query builder instance\n   * @param options - Repository options\n   * @protected\n   */\n  protected applyOptionsToQuery(\n    query: QueryBuilderContract<T>,\n    options: RepositoryOptions,\n  ): RepositoryOptions {\n    // ── Cursor phase 1: WHERE + ORDER BY ──────────────────────────────────────\n    // Must run first so the cursor column is always the PRIMARY sort key.\n    // Any orderBy appended below becomes a harmless secondary sort key.\n    if (options.paginationMode === \"cursor\") {\n      const cursorColumn = options.cursorColumn ?? \"id\";\n      const direction = options.direction ?? \"next\";\n\n      if (options.cursor) {\n        query.where(cursorColumn, direction === \"next\" ? \">\" : \"<\", options.cursor);\n      }\n\n      query.orderBy(cursorColumn, direction === \"next\" ? \"asc\" : \"desc\");\n\n      // Warn and strip orderBy that targets the same column as the cursor —\n      // it would produce a duplicate / conflicting sort clause.\n      if (options.orderBy) {\n        const conflictingKeys = Array.isArray(options.orderBy)\n          ? [options.orderBy[0]]\n          : typeof options.orderBy === \"object\"\n            ? Object.keys(options.orderBy)\n            : [];\n\n        if (conflictingKeys.includes(cursorColumn)) {\n          console.warn(\n            `[Repository] orderBy on \"${cursorColumn}\" conflicts with cursorColumn and will be ignored. ` +\n              `Cursor pagination owns the sort order for its cursor column.`,\n          );\n          options = { ...options, orderBy: undefined };\n        }\n      }\n    }\n\n    // Apply filters\n    if (this.filterBy && Object.keys(this.filterBy).length > 0) {\n      query.applyFilters(this.filterBy, options, {\n        dateFormat: \"DD-MM-YYYY\",\n        dateTimeFormat: \"DD-MM-YYYY HH:mm:ss\",\n      });\n    }\n\n    // Apply select\n    if (options.select) {\n      query.select(options.select);\n    }\n\n    // Apply deselect\n    if (options.deselect) {\n      query.deselect(options.deselect);\n    }\n\n    if (options.simpleSelect && this.simpleSelectColumns.length > 0) {\n      query.select(this.simpleSelectColumns);\n    }\n\n    // Apply ordering\n    if (options.orderBy) {\n      if (options.orderBy === \"random\") {\n        query.random();\n      } else if (Array.isArray(options.orderBy)) {\n        query.orderBy(options.orderBy[0], options.orderBy[1]);\n      } else if (typeof options.orderBy === \"object\") {\n        query.sortBy(options.orderBy);\n      }\n    }\n\n    // Apply limit (for non-paginated queries)\n    if (options.limit && options.paginate === false) {\n      query.limit(options.limit);\n    }\n\n    // Apply custom perform function\n    if (options?.perform) {\n      options.perform(query, options);\n    }\n\n    return options;\n  }\n\n  // ============================================================================\n  // CRUD OPERATIONS\n  // ============================================================================\n\n  /**\n   * Create a new record\n   * @param data - Record data\n   * @returns Promise resolving to created record\n   * @public\n   */\n  public async create(data: any): Promise<T> {\n    return this.adapter.create(data);\n  }\n\n  /**\n   * Update a record by ID\n   * @param id - Record ID\n   * @param data - Updated data\n   * @returns Promise resolving to updated record\n   * @public\n   */\n  public async update(id: string | number | any, data: any): Promise<T> {\n    return this.adapter.update(id, data);\n  }\n\n  /**\n   * Delete a record by ID\n   * @param id - Record ID\n   * @returns Promise that resolves when deletion is complete\n   * @public\n   */\n  public async delete(id: string | number): Promise<void> {\n    return this.adapter.delete(id);\n  }\n\n  // ============================================================================\n  // BULK OPERATIONS\n  // ============================================================================\n\n  /**\n   * Update multiple records matching filter\n   * @param filter - Filter criteria\n   * @param data - Updated data\n   * @returns Promise resolving to number of updated records\n   * @public\n   */\n  public async updateMany(filter: any, data: any): Promise<number> {\n    return this.adapter.updateMany(filter, data);\n  }\n\n  /**\n   * Delete multiple records matching filter\n   * @param filter - Filter criteria\n   * @returns Promise resolving to number of deleted records\n   * @public\n   */\n  public async deleteMany(filter: any): Promise<number> {\n    return this.adapter.deleteMany(filter);\n  }\n\n  // ============================================================================\n  // CHUNKING\n  // ============================================================================\n\n  /**\n   * Process records in chunks\n   * @param size - Chunk size\n   * @param callback - Function called for each chunk\n   * @param options - Repository options\n   * @returns Promise that resolves when chunking is complete\n   * @public\n   */\n  public async chunk(\n    size: number,\n    callback: ChunkCallback<T>,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<void> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return query.chunk(size, callback);\n  }\n\n  /**\n   * Process active records in chunks\n   * @param size - Chunk size\n   * @param callback - Function called for each chunk\n   * @param options - Repository options\n   * @returns Promise that resolves when chunking is complete\n   * @public\n   */\n  public async chunkActive(\n    size: number,\n    callback: ChunkCallback<T>,\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<void> {\n    return this.chunk(size, callback, this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // CONVENIENCE METHODS\n  // ============================================================================\n\n  /**\n   * Get latest records (ordered by ID descending)\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async latest(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async latest(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async latest(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"desc\"],\n      ...options,\n    });\n  }\n\n  /**\n   * Get oldest records (ordered by ID ascending)\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async oldest(options?: TypedRepositoryOptionsWithPages<F>): Promise<PaginationResult<T>>;\n  public async oldest(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async oldest(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"asc\"],\n      ...options,\n    });\n  }\n\n  /**\n   * Get latest active records\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async latestActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async latestActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async latestActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"desc\"],\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  /**\n   * Get oldest active records\n   * Supports both pagination modes\n   *\n   * @param options - Repository options\n   * @returns Promise resolving to pagination result\n   * @public\n   */\n  public async oldestActive(\n    options?: TypedRepositoryOptionsWithPages<F>,\n  ): Promise<PaginationResult<T>>;\n  public async oldestActive(\n    options: TypedRepositoryOptionsWithCursor<F>,\n  ): Promise<CursorPaginationResult<T>>;\n  public async oldestActive(\n    options?: TypedRepositoryOptions<F>,\n  ): Promise<PaginationResult<T> | CursorPaginationResult<T>> {\n    return this._listImpl({\n      orderBy: [\"id\", \"asc\"],\n      ...this.getIsActiveFilter(),\n      ...options,\n    });\n  }\n\n  // ============================================================================\n  // LIFECYCLE HOOKS (Override these in child classes)\n  // ============================================================================\n\n  /**\n   * Called before listing records\n   * @param options - Repository options\n   * @protected\n   */\n  protected async beforeListing(options: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after listing records\n   * @param result - Pagination result\n   * @param options - Repository options\n   * @protected\n   */\n  protected async onList(result: PaginationResult<T>, options: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before creating a record\n   * @param data - Record data\n   * @protected\n   */\n  protected async onCreating(data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after creating a record\n   * @param record - Created record\n   * @param data - Original data\n   * @protected\n   */\n  protected async onCreate(record: T, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before updating a record\n   * @param id - Record ID\n   * @param data - Updated data\n   * @protected\n   */\n  protected async onUpdating(id: string | number, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after updating a record\n   * @param record - Updated record\n   * @param data - Original data\n   * @protected\n   */\n  protected async onUpdate(record: T, data: any): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before saving a record (create or update)\n   * @param data - Record data\n   * @param mode - Save mode\n   * @protected\n   */\n  protected async onSaving(data: any, mode: SaveMode): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after saving a record (create or update)\n   * @param record - Saved record\n   * @param data - Original data\n   * @param mode - Save mode\n   * @protected\n   */\n  protected async onSave(record: T, data: any, mode: SaveMode): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called before deleting a record\n   * @param id - Record ID\n   * @protected\n   */\n  protected async onDeleting(id: string | number): Promise<void> {\n    // Override in child class\n  }\n\n  /**\n   * Called after deleting a record\n   * @param id - Record ID\n   * @protected\n   */\n  protected async onDelete(id: string | number): Promise<void> {\n    // Override in child class\n  }\n\n  // ============================================================================\n  // COUNT METHODS\n  // ============================================================================\n\n  /**\n   * Count total records matching options\n   * @param options - Repository options\n   * @returns Promise resolving to count\n   * @public\n   */\n  public async count(options?: TypedRepositoryOptions<F>): Promise<number> {\n    const query = this.newQuery();\n    const opts = this.prepareOptions(options);\n\n    this.applyOptionsToQuery(query, opts);\n\n    return await query.count();\n  }\n\n  /**\n   * Count total active records\n   * @param options - Repository options\n   * @returns Promise resolving to count of active records\n   * @public\n   */\n  public async countActive(options?: TypedRepositoryOptions<F>): Promise<number> {\n    return await this.count(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * Count records with caching\n   * @param options - Repository options\n   * @returns Promise resolving to cached count\n   * @public\n   */\n  public async countCached(options?: TypedRepositoryOptions<F>): Promise<number> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.count(options);\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"count\", opts);\n    let count = await this.cacheDriver.get(cacheKey);\n\n    if (count !== undefined) return count;\n\n    count = await this.count(options);\n    await this.cache(cacheKey, count);\n    return count;\n  }\n\n  /**\n   * Count active records with caching\n   * @param options - Repository options\n   * @returns Promise resolving to cached count of active records\n   * @public\n   */\n  public async countActiveCached(options?: TypedRepositoryOptions<F>): Promise<number> {\n    return await this.countCached(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  // ============================================================================\n  // CACHING METHODS\n  // ============================================================================\n\n  /**\n   * Set cache driver\n   * @param driver - Cache driver instance\n   * @returns This repository for chaining\n   * @public\n   */\n  public setCacheDriver(driver: any): this {\n    this.cacheDriver = driver;\n    return this;\n  }\n\n  /**\n   * Get cache driver\n   * @returns Cache driver instance\n   * @public\n   */\n  public getCacheDriver(): any {\n    return this.cacheDriver;\n  }\n\n  /**\n   * Generate cache key\n   * @param key - Base key or object\n   * @param moreOptions - Additional options for key\n   * @returns Generated cache key\n   * @protected\n   */\n  protected cacheKey(key: string | Record<string, any>, moreOptions?: Record<string, any>): string {\n    let cacheKey = `repositories.${this.getName()}`;\n\n    if (key) {\n      cacheKey += \".\" + (typeof key === \"string\" ? key : JSON.stringify(key));\n    }\n\n    if (moreOptions) {\n      cacheKey += \".\" + JSON.stringify(moreOptions);\n    }\n\n    return cacheKey;\n  }\n\n  /**\n   * Cache a value\n   * @param key - Cache key\n   * @param value - Value to cache\n   * @protected\n   */\n  protected async cache(key: string, value: any): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n    await this.cacheDriver.set(key, value);\n  }\n\n  /**\n   * Get cached record by ID\n   * @param id - Record ID\n   * @returns Promise resolving to cached record or null\n   * @public\n   */\n  public async getCached(id: string | number): Promise<T | null> {\n    return await this.getCachedBy(\"id\", id);\n  }\n\n  /**\n   * @alias getCached\n   */\n  public async findCached(id: string | number): Promise<T | null> {\n    return await this.getCachedBy(\"id\", id);\n  }\n\n  /**\n   * Get cached record by column value\n   * @param column - Column name\n   * @param value - Column value\n   * @param cacheKeyOptions - Additional cache key options\n   * @returns Promise resolving to cached record or undefined\n   * @public\n   */\n  public async getCachedBy(\n    column: string,\n    value: any,\n    cacheKeyOptions?: Record<string, any>,\n  ): Promise<T | null> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.findBy(column, value);\n    }\n\n    const cacheKey = this.cacheKey(`${column}.${value}`, cacheKeyOptions);\n    const cachedData = await this.cacheDriver.get(cacheKey);\n\n    if (cachedData) {\n      return this.adapter.deserializeModel(cachedData);\n    }\n\n    const model = await this.findBy(column, value);\n\n    if (!model) return null;\n\n    this.cache(cacheKey, this.adapter.serializeModel(model));\n    return model;\n  }\n\n  /**\n   * Get all cached records\n   * @param options - Repository options\n   * @returns Promise resolving to array of cached records\n   * @public\n   */\n  public async allCached(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return await this.all(options);\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"all\", opts);\n    const cachedData = await this.cacheDriver.get<T[]>(cacheKey);\n\n    if (cachedData) {\n      return cachedData.map((record) => this.adapter.deserializeModel(record));\n    }\n\n    const records = await this.all(options);\n    await this.cache(\n      cacheKey,\n      records.map((record) => this.adapter.serializeModel(record)),\n    );\n    return records;\n  }\n\n  /**\n   * Get all active cached records\n   * @param options - Repository options\n   * @returns Promise resolving to array of cached active records\n   * @public\n   */\n  public async allActiveCached(options?: TypedAllRepositoryOptions<F>): Promise<T[]> {\n    return await this.allCached(this.asTypedAll({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * List cached records with pagination\n   * @param options - Repository options\n   * @returns Promise resolving to cached pagination result\n   * @public\n   */\n  public async listCached(options?: TypedRepositoryOptions<F>): Promise<PaginationResult<T>> {\n    if (!this.isCacheable || !this.cacheDriver) {\n      return (await this._listImpl(options)) as PaginationResult<T>;\n    }\n\n    const opts = this.prepareOptions(options);\n\n    const cacheKey = this.cacheKey(\"list\", opts);\n    const cachedData = await this.cacheDriver.get(cacheKey);\n\n    if (cachedData) {\n      return {\n        data: (cachedData?.data || []).map((record: T) => this.adapter.deserializeModel(record)),\n        pagination: cachedData.pagination,\n      };\n    }\n\n    const result = (await this._listImpl(options)) as PaginationResult<T>;\n\n    await this.cache(cacheKey, {\n      data: result.data.map((record) => this.adapter.serializeModel(record)),\n      pagination: result.pagination,\n    });\n    return result;\n  }\n\n  /**\n   * List active cached records with pagination\n   * @param options - Repository options\n   * @returns Promise resolving to cached pagination result of active records\n   * @public\n   */\n  public async listActiveCached(options?: TypedRepositoryOptions<F>): Promise<PaginationResult<T>> {\n    return await this.listCached(this.asTyped({ ...this.getIsActiveFilter(), ...options }));\n  }\n\n  /**\n   * Get active cached record by ID\n   * @param id - Record ID\n   * @returns Promise resolving to cached active record or undefined\n   * @public\n   */\n  public async getActiveCached(id: string | number): Promise<T | undefined> {\n    const model = await this.getCached(id);\n    if (!model) return undefined;\n\n    if (typeof (model as any).get === \"function\") {\n      return (model as any).get(this.getIsActiveColumn()) === this.getIsActiveValue()\n        ? model\n        : undefined;\n    }\n\n    // Check if model is active\n    const isActive = (model as any)[this.getIsActiveColumn()] === this.getIsActiveValue();\n    return isActive ? model : undefined;\n  }\n\n  /**\n   * Cache a model\n   * @param model - Model to cache\n   * @public\n   */\n  public async cacheModel(model: T): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    const id = (model as any).id;\n    if (!id) return;\n\n    const cacheKey = this.cacheKey(`id.${id}`);\n    await this.cache(cacheKey, this.adapter.serializeModel(model));\n  }\n\n  /**\n   * Cleanup all events and cache as well\n   * Please note this is mostly used with development server to be\n   * exported as cleanup\n   *\n   * @example\n   * ```typescript\n   */\n  public cleanup() {\n    this.clearCache();\n    this.cleanuEvents();\n  }\n\n  /**\n   * Cleanup all events and cache as well\n   * Please note this is mostly used with development server to be\n   * exported as cleanup\n   * export const cleanup = usersRepository.cleanup.bind(usersRepository);\n   */\n  public $cleanup() {\n    this.cleanup();\n    this.cacheDriver.flush();\n  }\n\n  /**\n   * Clear all cache for this repository\n   * @public\n   */\n  public async clearCache(key?: CacheKey): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    await this.cacheDriver.removeNamespace(this.cacheKey(key || \"\"));\n  }\n\n  /**\n   * Clear cache for specific model\n   * @param model - Model to clear cache for\n   * @public\n   */\n  public async clearModelCache(model: T): Promise<void> {\n    if (!this.isCacheable || !this.cacheDriver) return;\n\n    const id = (model as any).id;\n    if (!id) return;\n\n    const cacheKey = this.cacheKey(`id.${id}`);\n    await this.cacheDriver.removeNamespace(cacheKey);\n  }\n\n  /**\n   * Map documents to models\n   * @param documents - Array of document data\n   * @returns Array of model instances\n   * @protected\n   */\n  protected mapModels(documents: any[]): T[] {\n    return documents.map((doc) => this.newModel(doc));\n  }\n\n  // ============================================================================\n  // CONVENIENCE METHODS\n  // ============================================================================\n\n  /**\n   * Find or create a record\n   * @param where - Conditions to find by\n   * @param data - Data to create if not found\n   * @returns Promise resolving to found or created record\n   * @public\n   */\n  public async findOrCreate(\n    where: TypedRepositoryOptions<F>,\n    data: Record<string, any>,\n  ): Promise<T> {\n    const model = await this.first(where);\n    return model || (await this.create(data));\n  }\n\n  /**\n   * Update or create a record\n   * @param where - Conditions to find by\n   * @param data - Data to update or create\n   * @returns Promise resolving to updated or created record\n   * @public\n   */\n  public async updateOrCreate(\n    where: TypedRepositoryOptions<F>,\n    data: Record<string, any>,\n  ): Promise<T> {\n    const model = await this.first(where);\n    if (model) {\n      return await this.update(model, data);\n    }\n    return await this.create(data);\n  }\n}\n"],"mappings":"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"}

package/esm/resource/define-resource.d.mts

@@ -0,0 +1,69 @@
+import { ResourceConstructor, ResourceContract } from "./resource.mjs";
+import { ResourceSchema } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/resource/define-resource.d.ts
+/**
+ * Options for defining a resource
+ */
+type DefineResourceOptions = {
+  /**
+   * Resource schema - field mapping configuration
+   */
+  schema: ResourceSchema;
+  /**
+   * Optional: Boot hook - called before transformation
+   */
+  boot?: (resource?: ResourceContract) => void;
+  /**
+   * Optional: Extend hook - called after transformation
+   */
+  extend?: (resource?: ResourceContract) => void;
+  /**
+   * Optional: Transform hook - modify final output
+   */
+  transform?: (data: Record<string, any>, resource: ResourceContract) => Record<string, any>;
+};
+/**
+ * Define a resource with a clean, shorthand API.
+ *
+ * This utility creates a Resource class without the boilerplate,
+ * perfect for simple use cases.
+ *
+ * @param options - Resource configuration
+ * @returns A Resource class
+ *
+ * @example
+ * ```typescript
+ * // Simple resource
+ * export const UserResource = defineResource({
+ *   schema: {
+ *     id: "number",
+ *     name: "string",
+ *     email: "string",
+ *   },
+ * });
+ *
+ * // With hooks
+ * export const CategoryResource = defineResource({
+ *   schema: {
+ *     id: "number",
+ *     name: "localized",
+ *     children: CategoryResource,
+ *   },
+ *   transform: (data) => {
+ *     // Filter inactive children
+ *     if (data.children) {
+ *       data.children = data.children.filter(c => c.isActive);
+ *     }
+ *     return data;
+ *   },
+ * });
+ *
+ * // Usage
+ * const json = new UserResource(user).toJSON();
+ * ```
+ */
+declare function defineResource(options: DefineResourceOptions): ResourceConstructor;
+//#endregion
+export { DefineResourceOptions, defineResource };
+//# sourceMappingURL=define-resource.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"define-resource.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/define-resource.ts"],"mappings":";;;;;;AAMA;KAAY,qBAAA;;;;EAIV,MAAA,EAAQ,cAAA;EAeW;;;EAVnB,IAAA,IAAQ,QAAA,GAAW,gBAAA;EAU0D;;;EAL7E,MAAA,IAAU,QAAA,GAAW,gBAAA;EALF;;;EAUnB,SAAA,IAAa,IAAA,EAAM,MAAA,eAAqB,QAAA,EAAU,gBAAA,KAAqB,MAAA;AAAA;;;;;;;;AAAM;AA2C/E;;;;;;;;AAAmF;;;;;;;;;;;;;;;;;;;;;;;;iBAAnE,cAAA,CAAe,OAAA,EAAS,qBAAA,GAAwB,mBAAmB"}

package/esm/resource/define-resource.mjs

@@ -0,0 +1,63 @@
+import { Resource } from "./resource.mjs";
+
+//#region ../../@warlock.js/core/src/resource/define-resource.ts
+/**
+* Define a resource with a clean, shorthand API.
+*
+* This utility creates a Resource class without the boilerplate,
+* perfect for simple use cases.
+*
+* @param options - Resource configuration
+* @returns A Resource class
+*
+* @example
+* ```typescript
+* // Simple resource
+* export const UserResource = defineResource({
+*   schema: {
+*     id: "number",
+*     name: "string",
+*     email: "string",
+*   },
+* });
+*
+* // With hooks
+* export const CategoryResource = defineResource({
+*   schema: {
+*     id: "number",
+*     name: "localized",
+*     children: CategoryResource,
+*   },
+*   transform: (data) => {
+*     // Filter inactive children
+*     if (data.children) {
+*       data.children = data.children.filter(c => c.isActive);
+*     }
+*     return data;
+*   },
+* });
+*
+* // Usage
+* const json = new UserResource(user).toJSON();
+* ```
+*/
+function defineResource(options) {
+	const resource = class AnonymousResource extends Resource {
+		static {
+			this.schema = options.schema;
+		}
+		boot() {
+			if (options.boot) options.boot.call(this, this);
+		}
+		extend() {
+			if (options.extend) options.extend.call(this, this);
+			if (options.transform) options.transform.call(this, this.data, this);
+		}
+	};
+	resource.parsedSchema = Resource.normalizeSchema(resource.schema);
+	return resource;
+}
+
+//#endregion
+export { defineResource };
+//# sourceMappingURL=define-resource.mjs.map

package/esm/resource/define-resource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-resource.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/define-resource.ts"],"sourcesContent":["import { Resource, type ResourceConstructor, type ResourceContract } from \"./resource\";\nimport type { ResourceSchema } from \"./types\";\n\n/**\n * Options for defining a resource\n */\nexport type DefineResourceOptions = {\n  /**\n   * Resource schema - field mapping configuration\n   */\n  schema: ResourceSchema;\n\n  /**\n   * Optional: Boot hook - called before transformation\n   */\n  boot?: (resource?: ResourceContract) => void;\n\n  /**\n   * Optional: Extend hook - called after transformation\n   */\n  extend?: (resource?: ResourceContract) => void;\n\n  /**\n   * Optional: Transform hook - modify final output\n   */\n  transform?: (data: Record<string, any>, resource: ResourceContract) => Record<string, any>;\n};\n\n/**\n * Define a resource with a clean, shorthand API.\n *\n * This utility creates a Resource class without the boilerplate,\n * perfect for simple use cases.\n *\n * @param options - Resource configuration\n * @returns A Resource class\n *\n * @example\n * ```typescript\n * // Simple resource\n * export const UserResource = defineResource({\n *   schema: {\n *     id: \"number\",\n *     name: \"string\",\n *     email: \"string\",\n *   },\n * });\n *\n * // With hooks\n * export const CategoryResource = defineResource({\n *   schema: {\n *     id: \"number\",\n *     name: \"localized\",\n *     children: CategoryResource,\n *   },\n *   transform: (data) => {\n *     // Filter inactive children\n *     if (data.children) {\n *       data.children = data.children.filter(c => c.isActive);\n *     }\n *     return data;\n *   },\n * });\n *\n * // Usage\n * const json = new UserResource(user).toJSON();\n * ```\n */\nexport function defineResource(options: DefineResourceOptions): ResourceConstructor {\n  const resource = class AnonymousResource extends Resource {\n    static schema = options.schema;\n\n    protected boot() {\n      if (options.boot) {\n        options.boot.call(this, this as unknown as ResourceContract);\n      }\n    }\n\n    protected extend() {\n      if (options.extend) {\n        options.extend.call(this, this as unknown as ResourceContract);\n      }\n\n      if (options.transform) {\n        options.transform.call(this, this.data, this);\n      }\n    }\n  };\n\n  // Normalize schema once at definition time — converts string cast types\n  // (including [] and ? suffixes) into pre-built ResourceFieldBuilder instances\n  resource.parsedSchema = Resource.normalizeSchema(resource.schema);\n\n  return resource as any as ResourceConstructor;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,eAAe,SAAqD;CAClF,MAAM,WAAW,MAAM,0BAA0B,SAAS;;iBACxC,QAAQ;;EAExB,AAAU,OAAO;GACf,IAAI,QAAQ,MACV,QAAQ,KAAK,KAAK,MAAM,IAAmC;EAE/D;EAEA,AAAU,SAAS;GACjB,IAAI,QAAQ,QACV,QAAQ,OAAO,KAAK,MAAM,IAAmC;GAG/D,IAAI,QAAQ,WACV,QAAQ,UAAU,KAAK,MAAM,KAAK,MAAM,IAAI;EAEhD;CACF;CAIA,SAAS,eAAe,SAAS,gBAAgB,SAAS,MAAM;CAEhE,OAAO;AACT"}

package/esm/resource/index.d.mts

@@ -0,0 +1,5 @@
+import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
+import { Resource, ResourceConstructor, ResourceContract } from "./resource.mjs";
+import { ResourceArraySchema, ResourceCastType, ResourceFieldBuilderDateOutputOptions, ResourceFieldConfig, ResourceOutputValueCastType, ResourceSchema, ResourceSelfReference, ResponseBodyValue, ResponseSchema } from "./types.mjs";
+import { DefineResourceOptions, defineResource } from "./define-resource.mjs";
+import { RegisterResource } from "./register-resource.mjs";

package/esm/resource/index.mjs

@@ -0,0 +1,6 @@
+import { ResourceFieldBuilder } from "./resource-field-builder.mjs";
+import { Resource } from "./resource.mjs";
+import { defineResource } from "./define-resource.mjs";
+import { RegisterResource } from "./register-resource.mjs";
+
+export {  };

package/esm/resource/register-resource.d.mts

@@ -0,0 +1,25 @@
+import { Resource } from "./resource.mjs";
+
+//#region ../../@warlock.js/core/src/resource/register-resource.d.ts
+/**
+ * Decorator for hand-written Resource classes.
+ * Triggers one-time schema normalization (converts string cast types into
+ * pre-built ResourceFieldBuilder instances) so transformOutput runs against
+ * builders without per-call overhead.
+ *
+ * @example
+ * ```typescript
+ * @RegisterResource()
+ * class PostResource extends Resource {
+ *   static schema = {
+ *     id: "number",
+ *     title: "string",
+ *     keywords: "string[]",
+ *   };
+ * }
+ * ```
+ */
+declare function RegisterResource(): (target: typeof Resource) => void;
+//#endregion
+export { RegisterResource };
+//# sourceMappingURL=register-resource.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"register-resource.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/register-resource.ts"],"mappings":";;;;;AAoBA;;;;AAC0C;;;;;;;;;;;;iBAD1B,gBAAA,CAAA,IACG,MAAuB,SAAR,QAAQ"}

package/esm/resource/register-resource.mjs

@@ -0,0 +1,30 @@
+import { Resource } from "./resource.mjs";
+
+//#region ../../@warlock.js/core/src/resource/register-resource.ts
+/**
+* Decorator for hand-written Resource classes.
+* Triggers one-time schema normalization (converts string cast types into
+* pre-built ResourceFieldBuilder instances) so transformOutput runs against
+* builders without per-call overhead.
+*
+* @example
+* ```typescript
+* @RegisterResource()
+* class PostResource extends Resource {
+*   static schema = {
+*     id: "number",
+*     title: "string",
+*     keywords: "string[]",
+*   };
+* }
+* ```
+*/
+function RegisterResource() {
+	return function(target) {
+		target.parsedSchema = Resource.normalizeSchema(target.schema);
+	};
+}
+
+//#endregion
+export { RegisterResource };
+//# sourceMappingURL=register-resource.mjs.map

package/esm/resource/register-resource.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-resource.mjs","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/register-resource.ts"],"sourcesContent":["import { Resource } from \"./resource\";\n\n/**\n * Decorator for hand-written Resource classes.\n * Triggers one-time schema normalization (converts string cast types into\n * pre-built ResourceFieldBuilder instances) so transformOutput runs against\n * builders without per-call overhead.\n *\n * @example\n * ```typescript\n * @RegisterResource()\n * class PostResource extends Resource {\n *   static schema = {\n *     id: \"number\",\n *     title: \"string\",\n *     keywords: \"string[]\",\n *   };\n * }\n * ```\n */\nexport function RegisterResource() {\n  return function (target: typeof Resource) {\n    target.parsedSchema = Resource.normalizeSchema(target.schema);\n  };\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAoBA,SAAgB,mBAAmB;CACjC,OAAO,SAAU,QAAyB;EACxC,OAAO,eAAe,SAAS,gBAAgB,OAAO,MAAM;CAC9D;AACF"}

package/esm/resource/resource-field-builder.d.mts

@@ -0,0 +1,108 @@
+import { LocalizedObject } from "../utils/get-localized.mjs";
+import { ResourceFieldBuilderDateOutputOptions, ResourceOutputValueCastType } from "./types.mjs";
+
+//#region ../../@warlock.js/core/src/resource/resource-field-builder.d.ts
+declare class ResourceFieldBuilder {
+  protected readonly type: ResourceOutputValueCastType;
+  /**
+   * Field value
+   */
+  protected fieldValue?: unknown;
+  /**
+   * Whether the value is nullable
+   * If set to false and value is null, it will be returned as undefined
+   */
+  protected isNullable: boolean;
+  /**
+   * Whether this field is an array
+   * When true, transform() maps over each element using the base type
+   */
+  protected isArrayField: boolean;
+  /**
+   * Default value
+   */
+  protected defaultValue?: unknown;
+  /**
+   * Date format
+   */
+  protected dateFormat: string;
+  /**
+   * Input key
+   */
+  protected inputKeyToUse?: string;
+  /**
+   * Add a condition before transforming the value
+   */
+  protected condition?: () => boolean;
+  /**
+   * Define how date fields are returned
+   * If type of the date options is string then it will be returned as a string
+   * otherwise it will be returned as an object contains the date options
+   */
+  protected dateOptionsInput: ResourceFieldBuilderDateOutputOptions;
+  /**
+   * Constructor
+   */
+  constructor(type: ResourceOutputValueCastType);
+  /**
+   * Parse a cast type string (including suffixes) into a configured builder.
+   * Suffix order: [] before ? (e.g. "string[]?")
+   * Parsing strips right-to-left: ? first, then [].
+   */
+  static fromCastType(castType: string): ResourceFieldBuilder;
+  /**
+   * Set input key
+   * Will be used in transformation if provided
+   */
+  setInputKey(key: string): this;
+  /**
+   * Add a condition before transforming the value
+   */
+  when(condition: () => boolean): this;
+  /**
+   * Set whether the value is nullable
+   */
+  nullable(): this;
+  /**
+   * Mark this field as an array
+   * transform() will map over each element using the base type
+   */
+  array(): this;
+  /**
+   * Get input key
+   */
+  getInputKey(): string | undefined;
+  /**
+   * Set default value
+   */
+  default(value: unknown): this;
+  /**
+   * Set field format
+   */
+  format(format: string): this;
+  /**
+   * Set date options
+   * This will override current date options
+   */
+  dateOptions(options: ResourceFieldBuilderDateOutputOptions): this;
+  /**
+   * Transform the value.
+   * When isArrayField is true, maps over each element using transformSingleValue.
+   */
+  transform(value: any, locale?: string): any;
+  /**
+   * Transform a single value according to the base type.
+   */
+  protected transformSingleValue(value: any, locale?: string): any;
+  /**
+   * Transform date value
+   */
+  protected transformDate(value: string | Date, locale?: string): any;
+  /**
+   * Transform localized value
+   */
+  protected transformLocalized(value: LocalizedObject[] | string, locale?: string): any;
+}
+//#endregion
+export { ResourceFieldBuilder };
+//# sourceMappingURL=resource-field-builder.d.mts.map

package/esm/resource/resource-field-builder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource-field-builder.d.mts","names":[],"sources":["../../../../../../@warlock.js/core/src/resource/resource-field-builder.ts"],"mappings":";;;;cAaa,oBAAA;EAAA,mBAwD2B,IAAA,EAAM,2BAAA;EAxDjC;;;EAAA,UAID,UAAA;EAuCkB;;;;EAAA,UAjClB,UAAA;EAmS0B;;;;EAAA,UA7R1B,YAAA;EAZA;;;EAAA,UAiBA,YAAA;EAKA;;;EAAA,UAAA,UAAA;EAiBkB;;;EAAA,UAZlB,aAAA;EAkCI;;;EAAA,UA7BJ,SAAA;EAsDS;;;;;EAAA,UA/CT,gBAAA,EAAkB,qCAAA;EAwFrB;;;cA3E+B,IAAA,EAAM,2BAAA;EA8FrC;;;;;EAAA,OArFO,YAAA,CAAa,QAAA,WAAmB,oBAAA;EAgHpC;;;;EAvFH,WAAA,CAAY,GAAA;EA2IK;;;EAlIjB,IAAA,CAAK,SAAA;EA0MiB;;;EAlMtB,QAAA,CAAA;;;;;EASA,KAAA,CAAA;;;;EAQA,WAAA,CAAA;;;;EAOA,OAAA,CAAQ,KAAA;;;;EASR,MAAA,CAAO,MAAA;;;;;EAUP,WAAA,CAAY,OAAA,EAAS,qCAAA;;;;;EAUrB,SAAA,CAAU,KAAA,OAAY,MAAA;;;;YAiBnB,oBAAA,CAAqB,KAAA,OAAY,MAAA;;;;YAoDjC,aAAA,CAAc,KAAA,WAAgB,IAAA,EAAM,MAAA;;;;YAwEpC,kBAAA,CAAmB,KAAA,EAAO,eAAA,aAA4B,MAAA;AAAA"}

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

@@ -0,0 +1,187 @@
+import { uploadsUrl, url } from "../utils/urls.mjs";
+import { storage } from "../storage/storage.mjs";
+import "../storage/index.mjs";
+import { isObject } from "@mongez/supportive-is";
+import dayjs from "dayjs";
+import relativeTime from "dayjs/plugin/relativeTime.js";
+
+//#region ../../@warlock.js/core/src/resource/resource-field-builder.ts
+dayjs.extend(relativeTime);
+var ResourceFieldBuilder = class ResourceFieldBuilder {
+	/**
+	* Constructor
+	*/
+	constructor(type) {
+		this.type = type;
+		this.isNullable = false;
+		this.isArrayField = false;
+		this.dateFormat = "DD-MM-YYYY hh:mm:ss A";
+		this.dateOptionsInput = {
+			format: true,
+			timestamp: true,
+			timezone: false,
+			locale: false,
+			offset: false,
+			humanTime: true,
+			iso: true
+		};
+	}
+	/**
+	* Parse a cast type string (including suffixes) into a configured builder.
+	* Suffix order: [] before ? (e.g. "string[]?")
+	* Parsing strips right-to-left: ? first, then [].
+	*/
+	static fromCastType(castType) {
+		let baseType = castType;
+		let nullable = false;
+		let isArray = false;
+		if (baseType.endsWith("?")) {
+			nullable = true;
+			baseType = baseType.slice(0, -1);
+		}
+		if (baseType.endsWith("[]")) {
+			isArray = true;
+			baseType = baseType.slice(0, -2);
+		}
+		const builder = new ResourceFieldBuilder(baseType);
+		if (nullable) builder.nullable();
+		if (isArray) builder.array();
+		return builder;
+	}
+	/**
+	* Set input key
+	* Will be used in transformation if provided
+	*/
+	setInputKey(key) {
+		this.inputKeyToUse = key;
+		return this;
+	}
+	/**
+	* Add a condition before transforming the value
+	*/
+	when(condition) {
+		this.condition = condition;
+		return this;
+	}
+	/**
+	* Set whether the value is nullable
+	*/
+	nullable() {
+		this.isNullable = true;
+		return this;
+	}
+	/**
+	* Mark this field as an array
+	* transform() will map over each element using the base type
+	*/
+	array() {
+		this.isArrayField = true;
+		return this;
+	}
+	/**
+	* Get input key
+	*/
+	getInputKey() {
+		return this.inputKeyToUse;
+	}
+	/**
+	* Set default value
+	*/
+	default(value) {
+		this.defaultValue = value;
+		return this;
+	}
+	/**
+	* Set field format
+	*/
+	format(format) {
+		this.dateFormat = format;
+		return this;
+	}
+	/**
+	* Set date options
+	* This will override current date options
+	*/
+	dateOptions(options) {
+		this.dateOptionsInput = options;
+		return this;
+	}
+	/**
+	* Transform the value.
+	* When isArrayField is true, maps over each element using transformSingleValue.
+	*/
+	transform(value, locale) {
+		if (this.isArrayField) {
+			if (!Array.isArray(value)) return this.isNullable ? null : [];
+			return value.map((item) => this.transformSingleValue(item, locale)).filter((v) => v !== void 0);
+		}
+		return this.transformSingleValue(value, locale);
+	}
+	/**
+	* Transform a single value according to the base type.
+	*/
+	transformSingleValue(value, locale) {
+		if (value === void 0 || value === null) return this.isNullable ? null : this.defaultValue;
+		if (this.condition && !this.condition()) return this.isNullable ? null : this.defaultValue;
+		switch (this.type) {
+			case "string": return String(value);
+			case "number": {
+				const num = Number(value);
+				return isNaN(num) ? this.isNullable ? null : void 0 : num;
+			}
+			case "boolean": return Boolean(value);
+			case "float": {
+				const float = parseFloat(value);
+				return isNaN(float) ? this.isNullable ? null : void 0 : float;
+			}
+			case "int": {
+				const int = parseInt(value);
+				return isNaN(int) ? this.isNullable ? null : void 0 : int;
+			}
+			case "date": return this.transformDate(value, locale);
+			case "localized": return this.transformLocalized(value, locale);
+			case "url": return url(value);
+			case "uploadsUrl": return uploadsUrl(value);
+			case "storageUrl": return storage.url(value);
+			case "object": return isObject(value) && !Array.isArray(value) && Object.keys(value).length > 0 ? value : this.isNullable ? null : void 0;
+			case "array": return Array.isArray(value) ? value : this.isNullable ? null : void 0;
+		}
+	}
+	/**
+	* Transform date value
+	*/
+	transformDate(value, locale) {
+		if (typeof this.dateOptionsInput === "string") {
+			if (this.dateOptionsInput === "format") return dayjs(value).format(this.dateFormat);
+			if (this.dateOptionsInput === "iso") return dayjs(value).toISOString();
+			if (this.dateOptionsInput === "timestamp") return dayjs(value).valueOf();
+			if (this.dateOptionsInput === "humanTime") return dayjs(value).fromNow();
+			if (this.dateOptionsInput === "locale") {
+				if (!locale) return dayjs(value).format(this.dateFormat);
+				return dayjs(value).locale(locale).format(this.dateFormat);
+			}
+		}
+		const output = {};
+		let dayjsObject = dayjs(value?.iso || value);
+		if (locale) dayjsObject = dayjsObject.locale(locale);
+		if (this.dateOptionsInput.iso) output.iso = dayjsObject.toISOString();
+		if (this.dateOptionsInput.format) output.format = dayjsObject.format(this.dateFormat);
+		if (this.dateOptionsInput.timestamp) output.timestamp = dayjsObject.valueOf();
+		if (this.dateOptionsInput.humanTime) output.humanTime = dayjsObject.fromNow();
+		if (this.dateOptionsInput.locale) output.locale = dayjsObject.format(this.dateFormat);
+		if (this.dateOptionsInput.iso) output.iso = dayjsObject.toISOString();
+		return output;
+	}
+	/**
+	* Transform localized value
+	*/
+	transformLocalized(value, locale) {
+		if (typeof value === "string") return value;
+		if (!locale) return value[0]?.value || value;
+		return value.find((item) => item.localeCode === locale)?.value;
+	}
+};
+
+//#endregion
+export { ResourceFieldBuilder };
+//# sourceMappingURL=resource-field-builder.mjs.map