@arcaelas/dynamite 1.0.10 → 1.0.13

package/LICENSE.txt

@@ -0,0 +1,32 @@
+Amazon DynamoDB Local License Agreement
+THIS LICENSE AGREEMENT (“LICENSE”) GOVERNS YOUR USE OF THE DYNAMODB LOCAL SOFTWARE (TOGETHER WITH ANY UPDATES AND ENHANCEMENTS TO IT, AND ACCOMPANYING DOCUMENTATION, THE “SOFTWARE”). IF YOU INSTALL OR USE THE SOFTWARE, YOU WILL BE BOUND BY THIS LICENSE. UNLESS OTHERWISE DEFINED IN THIS LICENSE, CAPTIALIZED TERMS WILL HAVE THE SAME MEANING AS SET FORTH IN THE AWS CUSTOMER AGREEMENT POSTED AT AWS.AMAZON.COM/AGREEMENT (THE “AWS AGREEMENT”).
+AWS Licensor
+If the geographic location associated with your AWS account is any country within Europe, the Middle East, or Africa (“EMEA”), then Amazon Web Services EMEA SARL (“AWS Europe”) grants this License.  If the geographic location associated with your AWS account is any country outside of EMEA, then Amazon Web Services, Inc. (“AWS, Inc.”) grants this License.  “AWS Europe” and “AWS, Inc.” are individually referred to herein as an “AWS Licensor”.
+No Agency
+This License forms a separate agreement between you and AWS Licensor without any further action required by the parties.  AWS Licensor grants this License in its own capacity and no other party is acting as agent of AWS Licensor or has capacity to bind AWS Licensor.
+License
+AWS Licensor or its licensors own all right, title, and interest in and to the Software and all related technology and intellectual property rights.   Subject to the terms of this License and the AWS Agreement, AWS Licensor hereby grants you a personal, limited, nonexclusive, non-transferable, non-sublicenseable license to (a) install the Software on computer equipment owned or controlled by you and (b) use the Software solely (i) for your internal business purposes and (ii) in connection with the Services. You may not use the Software if you do not have an AWS account in good standing. Some components of the Software may also be governed by applicable open-source software licenses located in the software component's source code. Your license rights with respect to these individual components are defined by the applicable open-source software license, and nothing in this License will restrict, limit, or otherwise affect any rights or obligations you may have, or conditions to which you may be subject, under such open-source software licenses.
+Limitations
+You may not, and you will not encourage, assist, or authorize any other person to, (a) incorporate any portion of it into your own programs or compile any portion of it in combination with your own programs; or (b) sell, rent, lease, lend, loan, distribute, act as a service bureau, publicly communicate, transform, or sub-license the Software or otherwise assign any rights to the Software in whole or in part; (c) modify, alter, tamper with, repair, or otherwise create derivative works of the Software, or (d) reverse engineer, disassemble, or decompile the Software or apply any other process or procedure to derive the source code of any software included in the Software. All rights granted to you are conditioned on your continued compliance this License, and will immediately and automatically terminate if you do not comply with any term or condition of this License or the AWS Agreement, including any failure to remit timely payment for the Software or the Service.
+Reservation of Rights
+You may not use the Software for any illegal purpose. The Software is the intellectual property of AWS Licensor or its licensors. The structure, organization, and code of the Software are valuable trade secrets and confidential information of AWS Licensor. The Software is protected by law, including without limitation copyright laws and international treaty provisions. Except for the rights explicitly granted to you in this License, all right, title and interest in the Software are reserved and retained by AWS Licensor and its licensors. You do not acquire any intellectual property or other rights in the Software as a result of downloading the Software.
+Updates
+In order to keep the Software up to date, AWS Licensor may offer automatic or manual updates at any time. If AWS Licensor elects to provide maintenance or support of any kind, AWS Licensor may terminate that maintenance or support at any time without notice to you.
+Termination
+You may terminate this License at any time by uninstalling or destroying all copies of the Software that are in your possession or control. Your rights under this License will automatically terminate without notice if you fail to comply with any of its terms or fail to make timely payment. In the case of termination, you must cease all use and destroy all copies of the Software. AWS Licensor may modify, suspend, discontinue, or terminate your right to use part or all of the Software at any time without notice to you, and in that event AWS Licensor may modify the Software to make it inoperable. AWS Licensor will not be liable to you should it exercise those rights. AWS Licensor’s failure to insist upon or enforce your strict compliance with this License will not constitute a waiver of any of its rights.
+Disclaimer of Warranties and Limitation of Liability
+a. YOU EXPRESSLY ACKNOWLEDGE AND AGREE THAT INSTALLATION AND USE OF, AND ANY OTHER ACCESS TO, THE APPLICATION IS AT YOUR SOLE RISK. THE APPLICATION IS DELIVERED TO YOU “AS IS” WITH ALL FAULTS AND WITHOUT WARRANTY OF ANY KIND, AND AWS LICENSOR, ITS LICENSORS AND DISTRIBUTORS, AND EACH OF THEIR RESPECTIVE AFFILIATES AND SUPPLIERS (COLLECTIVELY, THE “RELEASED PARTIES”) DISCLAIM ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, ACCURACY, QUIET ENJOYMENT, AND NON-INFRINGEMENT. NO ORAL OR WRITTEN INFORMATION OR ADVICE GIVEN BY A RELEASED PARTY OR AN AUTHORIZED REPRESENTATIVE OF A RELEASED PARTY WILL CREATE A WARRANTY. THE LAWS OF CERTAIN JURISDICTIONS DO NOT ALLOW THE DISCLAIMER OF IMPLIED WARRANTIES. IF THESE LAWS APPLY TO YOU, SOME OR ALL OF THE ABOVE DISCLAIMERS, EXCLUSIONS, OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.
+b. TO THE EXTENT NOT PROHIBITED BY LAW, NO RELEASED PARTY WILL BE LIABLE TO YOU FOR ANY INCIDENTAL OR CONSEQUENTIAL DAMAGES FOR BREACH OF ANY EXPRESS OR IMPLIED WARRANTY, BREACH OF CONTRACT, NEGLIGENCE, STRICT LIABILITY, OR ANY OTHER LEGAL THEORY RELATED TO THE APPLICATION, INCLUDING WITHOUT LIMITATION ANY DAMAGES ARISING OUT OF LOSS OF PROFITS, REVENUE, DATA, OR USE OF THE APPLICATION, EVEN IF A RELEASED PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. IN ANY CASE, ANY RELEASED PARTY’S AGGREGATE LIABILITY UNDER THIS LICENSE WILL BE LIMITED TO $50.00. THE LAWS OF CERTAIN JURISDICTIONS DO NOT ALLOW THE EXCLUSION OR LIMITATION OF INCIDENTAL OR CONSEQUENTIAL DAMAGES. IF THESE LAWS APPLY TO YOU, SOME OR ALL OF THE ABOVE EXCLUSIONS OR LIMITATIONS MAY NOT APPLY TO YOU, AND YOU MAY HAVE ADDITIONAL RIGHTS.
+Indemnification
+You are liable for and will defend, indemnify, and hold harmless the Released Parties and their officers, directors, agents, and employees, from and against any liability, loss, damage, cost, or expense (including reasonable attorneys’ fees) arising out of your use of the Software, violation of this License, violation of applicable law, or violation of any right of any person or entity, including without limitation intellectual property rights.
+Export Regulations
+You will comply with all export and re-export restrictions and regulations of the United States Department of Commerce and other United States and foreign agencies and authorities that may apply to the Software, and not to transfer, or encourage, assist, or authorize the transfer of the Software to a prohibited country or otherwise in violation of any applicable restrictions or regulations.
+U.S. Government End Users
+The Software is provided to the U.S. Government as “commercial items,” “commercial computer software,” “commercial computer software documentation,” and “technical data” with the same rights and restrictions generally applicable to the Software. If you are using the Software on behalf of the U.S. Government and these terms fail to meet the U.S. Government’s needs or are inconsistent in any respect with federal law, you will immediately discontinue your use of the Software. The terms “commercial item,” “commercial computer software,” “commercial computer software documentation,” and “technical data” are defined in the Federal Acquisition Regulation and the Defense Federal Acquisition Regulation Supplement.
+Amendment
+AWS Licensor may amend this License at its sole discretion by posting the revised terms on the AWS website (aws.amazon.com) or within the Software. Your continued use of the Software after any amendment's effective date evidences your agreement to be bound by it.
+Conflicts
+The terms of this License govern the Software and any updates or upgrades to the Software that AWS Licensor may provide that replace or supplement the original Software, unless the update or upgrade is accompanied by a separate license, in which case the terms of that license will govern.
+
+Note
+Other license terms may apply to certain, identified software files contained within or distributed with the accompanying software if such terms are included in the file THIRD-PARTY-LICENSES.txt. Such other license terms will then apply in lieu of the terms of the software license above.

package/README.txt

@@ -0,0 +1,206 @@
+README
+========
+
+For an overview of DynamoDB Local please refer to the documentation at http://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Tools.DynamoDBLocal.html
+
+
+Release Notes
+-----------------------------
+ 2025-06-26 (3.0.0)
+     * Migrating from AWS SDK Java V1 to V2
+     * Updated package structure from com.amazonaws.services.dynamodbv2 to software.amazon.dynamodb.services
+     * Removed AWS SDK Java V1 dependencies
+
+2025-02-25 (2.6.0)
+    * Added support for using Table ARN as table name in several DynamoDB APIs
+    * Fixing CreateStreamTable bug on high performance machines, such as Mac M3
+    * Upgrading Dependencies to fix vulnerability issues (CVE-2022-49043,CVE-2024-56732, CVE-2020-29582, CVE-2025-21502, CVE-2024-50602, CVE-2025-24970, CVE-2025-25193)
+
+2024-12-12 (2.5.4)
+    * Upgrading to Jetty 12.0.14 (Resolves CVE-2024-6763, CVE-2024-8184, CVE-2024-47535)
+
+2024-11-06 (2.5.3)
+    * Upgrading Jackson Dependencies to 2.17.x in Log4j Core (Resolves CVE-2022-1471)
+
+2024-06-20 (2.5.2)
+    * Bug fix for workflow when update table tries to update table with Billing Mode Ondemand to Provisioned With GSI
+
+2024-06-05 (2.5.1)
+    * Fixing a couple of bugs related to OndemandThroughPut
+
+2024-05-28 (2.5.0)
+    * Adding support for OndemandThroughPut
+    * Adding Telemetry to Embedded Mode
+    * Support for ReturnValuesOnConditionCheckFailure for BatchExecuteStatement and ExecuteTransactionRequest
+    * Fixing the SDKv2 translation for ConditionalCheckException
+
+2024-04-16 (2.4.0)
+    * Support for ReturnValuesOnConditionCheckFailure - Embedded Mode
+    * Fix for TrimmedDataAccessException for Operation on Multiple Streams
+    * Fixing exception transalation for SDKv2 in Embedded Mode
+
+2024-03-14 (2.3.0)
+    * Uprading to Jetty 12.0.2
+    * Upgrading to JDK 17
+    * Upgrading ANTLR4 to 4.10.1
+
+2024-01-04 (2.2.1)
+    * Fixed a bug for Handling of segments in parallel scan
+
+2023-12-14 (2.2.0)
+    * Added support of Table delete protection
+    * Added support for ReturnValuesOnConditionCheckFailure
+    * Added Support for -Version flag
+
+2023-09-28 (2.1.0)
+ * Adding Telemetry to DynamoDB Local
+ * Dynamically Copy SQLLite Native Libraries for Maven projects
+ * Removed io.github.ganadist.sqlite4java library from Maven dependency
+ * Upgrading the GoogleGuava to 32.1.1-jre
+
+2023-06-28 (2.0.0)
+ * Migrating from javax to jakarta namespace and JDK11 Support
+ * Fix for handling invalid access and secret key while server startup
+ * Fixing Maven identified vulnerabilities by updating dependencies
+
+2023-06-28 (1.23.0)
+  * Fix for handling invalid access and secret key while server startup
+  * Fixing Maven identified vulnerabilities by updating dependencies
+
+2023-06-08 (1.22.0)
+* Optimize IN clause for PartiQL
+* Support for Limit Operation
+* M1 support for Maven projects
+
+2023-1-26 (1.21.0)
+* Matching Expection for Duplicate items with Web Service for batch-execute-statement operation
+* Increase max number of actions to 100
+* Upgrading Open JDK on docker to openjdk11
+
+2022-9-12 (1.20.0)
+
+* Fixed path traversal issue
+* Updated Jetty dependency to 9.4.48.v20220622
+* Added M1 support
+
+2022-7-27 (1.19.0)
+
+ * Updated  IonSQLSandbox dependency to version 6.x
+ * Updated  KotlinStdlib dependency to version 1.6.x
+
+2022-1-10 (1.18.0)
+
+ * Updated log4j-core dependency to version 2.17.1.
+ * Updated Jackson-core and related libraries from 2.10.x to 2.12.0
+
+2021-12-16 (1.17.2)
+
+ * Updated log4j-core dependency to version 2.16.
+
+2021-12-10 (1.17.1)
+
+ * Updated log4j-core dependency to patch zero-day exploit to prevent remote code execution - Log4Shell: RCE 0-day. Applied internal patch for 2.13.3 for log4j-core by removing JndiLookup class.
+
+2021-10-08 (1.17.0)
+
+ * Update the AWS SDK dependency to AWS SDK for Java 1.12.x
+ * Update License.txt file
+ * Deprecated Javascript Web Shell
+
+2021-05-03 (1.16.0)
+
+ * Improve the performance of DynamoDbLocal by reducing buffer size to 1KB from 16MB which reduces overall heap memory usage
+ * Add a CORS header to DynamoDB local API responses in the case of error responses, which solves the issue of returning generic ResourceNotFoundException for all errors
+ * Add support for AWS SDK for Java 2.0
+ * Fix wording of the exception messages shown when incorrect attribute definitions are passed in the create table command
+2021-02-08 (1.15.0)
+
+  * Add support for PartiQL Select, Update, Insert, Delete Statements
+  * Add support for batch reads and writes using PartiQL
+  * Add support for transactional reads or writes using PartiQL
+  * Fix the shardIterator format to keep the streamArn as part one and serial number as part two to sync with DynamoDB Streams
+  * Update the Jackson library dependency from 2.6 to 2.10
+  * Fix the error structure difference for message key name in TransactionCanceledException
+  * Suppress “Logging initialized” log message shown at server startup
+
+2020-12-21 (1.13.6)
+
+  * Fix the XSS security issue in the DynamoDB JavaScript shell by sanitizing the input and output data
+  * Add the log4j-core library dependency with the version update from 2.8 to 2.13.3
+  * Fix the describe-stream CLI for the option, —exclusive-start-shard-id, to return basic streaminfo instead of RESOURCE_NOT_FOUND, if the requested shard-id does not match
+  * Fix GSI input to not mutate while creating a table with billing mode set to PAY_PER_REQUEST
+  * Update the Jetty library dependency version to 9.4.18.v20190429
+
+2020-10-13 (1.13.5)
+
+  * Align error message with Amazon DynamoDB service for empty sets attributes, empty value attributes, and when invalid BETWEEN condition operator range is given
+  * Update log4j-api library dependency version to 2.13.3
+  * Remove dependency on log4j-core 2.6.2
+  * Provide support for multi-arch docker images with arm64 and amd64 architectures
+
+2020-09-14 (1.13.4)
+
+  * Fixes an issue where the “begins_with” conditional function was not working correctly with Binary types for Java versions 9 and later.
+
+2020-08-24 (1.13.3)
+
+  * Fix issues in the begins_with function in key conditions for binary range keys in the Query API.
+
+2020-07-22 (1.13.2)
+
+  * Fix notarization issue caused by running DynamoDB local on macOS Catalina.
+  * Bug fix to return only the requested item attributes when a global secondary index is queried with specific attributes.
+
+2020-05-29 (1.13.1)
+
+  * Bugfix to throw validation error when gsi is queried with non projected attribute
+  * Bugfix to throw validation error when gsi with projection type other than ALL is queried with option Select as ALL_ATTRIBUTES
+
+2020-05-20 (1.13.0)
+
+  * Support up to 25 unique items and 4 MB of data per TransactWriteItems and TransactGetItems request
+  * Support empty values for non-key String and Binary attributes
+  * Fix warning log messages when DB is reinitialized
+  * Fix error messaging for inconsistent type validations
+  * Add shutdownNow API for DynamoDB Local embedded mode
+  * Update AWS SDK for Java to version 1.11.780
+
+2020-01-16 (1.12.0)
+
+  * Bugfixes
+  * Notarization for running on MacOS Catalina
+
+2019-02-06 (1.11.477)
+
+  * Bugfixes
+
+2019-02-04 (1.11.475)
+
+  * Add on-demand implementation
+  * Add support for 20 GSIs (up from 5)
+  * Add transaction API implementation
+  * Update AWS SDK for Java to version 1.11.475
+
+2017-04-13 (1.11.119)
+
+  * Add TTL implementation
+  * Update AWS SDK for Java to version 1.11.119
+
+2017-01-24 (1.11.86)
+
+  * Implement waiters() method in LocalDynamoDBClient
+  * Update AWS SDK for Java to version 1.11.86
+  * Enable WARN logging for SQLite
+
+2016-05-17_1.0
+
+  * Bug fix for Query validation preventing primary key attributes in query filter expressions
+
+Running DynamoDB Local
+---------------------------------------------------------------
+
+java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar [options]
+
+For more information on available options, run with the -help option:
+
+  java -Djava.library.path=./DynamoDBLocal_lib -jar DynamoDBLocal.jar -help

package/package.json

@@ -27,14 +27,15 @@
     "typescript": "^5.8.3"
   },
   "files": [
-    "build/",
     "*.md",
     "*.json",
+    "src/**/*.js",
+    "src/**/*.d.ts",
     "!tsconfig.json"
   ],
   "homepage": "https://github.com/arcaelas/dynamite",
   "license": "ISC",
-  "main": "build/index.js",
+  "main": "src/index.js",
   "name": "@arcaelas/dynamite",
   "publishConfig": {
     "access": "public",
@@ -49,7 +50,7 @@
     "build": "tsc && tsc-alias",
     "prepublishOnly": "yarn test && yarn build && npm version patch",
     "commit": "npm publish --access=public",
-    "postpublish": "rm -rf build"
+    "postpublish": "find src __tests__ -type f -name '*.js' -o -name '*.d.ts' -o -name '*.map' | xargs rm"
   },
-  "version": "1.0.10"
+  "version": "1.0.13"
 }

package/src/@types/index.d.ts

@@ -0,0 +1,96 @@
+export declare const HasManyBrand: unique symbol;
+export declare const BelongsToBrand: unique symbol;
+export declare const NonAttributeBrand: unique symbol;
+export declare const CreationOptionalBrand: unique symbol;
+export type HasMany<T> = T[] & {
+    [HasManyBrand]?: true;
+};
+export type BelongsTo<T> = (T | null) & {
+    [BelongsToBrand]?: true;
+};
+export type NonAttribute<T> = T & {
+    [NonAttributeBrand]?: true;
+};
+export type CreationOptional<T> = T & {
+    [CreationOptionalBrand]?: true;
+};
+export type InferAttributes<T> = {
+    [K in keyof T as T[K] extends (...args: any[]) => any ? never : T[K] extends {
+        [HasManyBrand]?: true;
+    } ? never : T[K] extends {
+        [BelongsToBrand]?: true;
+    } ? never : T[K] extends {
+        [NonAttributeBrand]?: true;
+    } ? never : K]: T[K];
+};
+export type FilterableAttributes<T> = {
+    [K in keyof InferAttributes<T>]: InferAttributes<T>[K];
+};
+type SelectResult<T, A extends keyof T> = Pick<T, A>;
+type ResolveIncludeType<T, K extends keyof T> = T[K] extends HasMany<infer U> ? U[] : T[K] extends BelongsTo<infer U> ? U | null : never;
+export type IncludeOptions = {
+    where?: Record<string, any>;
+    attributes?: string[];
+    limit?: number;
+    skip?: number;
+    order?: "ASC" | "DESC";
+};
+export type QueryResult<T, A extends keyof T = keyof T, I extends Record<string, any> = {}> = SelectResult<T & {
+    [K in keyof I]: K extends keyof T ? ResolveIncludeType<T, K> : never;
+}, A>;
+export type WhereOptions<T> = {
+    where?: Partial<FilterableAttributes<T>>;
+    skip?: number;
+    limit?: number;
+    order?: "ASC" | "DESC";
+    attributes?: (keyof FilterableAttributes<T>)[];
+    include?: {
+        [K in keyof T]?: T[K] extends HasMany<any> | BelongsTo<any> ? IncludeOptions | {} : never;
+    };
+};
+export type WhereOptionsWithoutWhere<T> = Omit<WhereOptions<T>, "where">;
+export type QueryOperator = "=" | "!=" | "<" | "<=" | ">" | ">=" | "in" | "not-in" | "contains" | "begins-with";
+export interface Column {
+    name: string;
+    default?: any | (() => any);
+    mutate?: ((value: any) => any)[];
+    validate?: ((value: any) => boolean | string)[];
+    index?: true;
+    indexSort?: true;
+    primaryKey?: boolean;
+    nullable?: boolean;
+    unique?: true;
+    createdAt?: boolean;
+    updatedAt?: boolean;
+}
+export interface RelationMetadata {
+    type: "hasMany" | "belongsTo";
+    targetModel: () => any;
+    foreignKey: string;
+    localKey?: string;
+}
+export interface WrapperEntry {
+    name: string;
+    columns: Map<string | symbol, Column>;
+    relations: Map<string | symbol, RelationMetadata>;
+}
+export type IncludeRelationOptions = {
+    where?: Record<string, any>;
+    attributes?: string[];
+    order?: "ASC" | "DESC";
+    skip?: number;
+    limit?: number;
+    include?: Record<string, IncludeRelationOptions | true>;
+};
+export type WhereQueryOptions<T> = {
+    order?: "ASC" | "DESC";
+    skip?: number;
+    limit?: number;
+    attributes?: (keyof InferAttributes<T>)[];
+    include?: {
+        [K in keyof T]?: T[K] extends HasMany<any> | BelongsTo<any> ? IncludeRelationOptions | true : never;
+    };
+};
+export type Mutate = (value: any) => any;
+export type Validate = (value: any) => boolean | string;
+export {};

package/src/@types/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/*
+@file index.ts
+@descripcion Tipos públicos de Dynamite ORM
+@autor Miguel Alejandro
+@fecha 2025-08-07
+*/
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/{build/src → src}/core/client.d.ts

@@ -63,3 +63,7 @@ export declare const getGlobalClient: () => DynamoDBClient;
  * Check if global client is available
  */
 export declare const hasGlobalClient: () => boolean;
+/**
+ * Require global client for Table operations (throws if not available)
+ */
+export declare const requireClient: () => DynamoDBClient;

package/{build/src → src}/core/client.js

@@ -9,7 +9,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.hasGlobalClient = exports.getGlobalClient = exports.setGlobalClient = exports.Dynamite = void 0;
+exports.requireClient = exports.hasGlobalClient = exports.getGlobalClient = exports.setGlobalClient = exports.Dynamite = void 0;
 const client_dynamodb_1 = require("@aws-sdk/client-dynamodb");
 const wrapper_1 = __importDefault(require("./wrapper"));
 /**
@@ -147,6 +147,18 @@ exports.getGlobalClient = getGlobalClient;
 /**
  * Check if global client is available
  */
-const hasGlobalClient = () => globalClient !== undefined;
+const hasGlobalClient = () => {
+    return globalClient !== undefined;
+};
 exports.hasGlobalClient = hasGlobalClient;
+/**
+ * Require global client for Table operations (throws if not available)
+ */
+const requireClient = () => {
+    if (!globalClient) {
+        throw new Error("DynamoDB client no configurado. Use Dynamite.connect() primero.");
+    }
+    return globalClient;
+};
+exports.requireClient = requireClient;
 //# sourceMappingURL=client.js.map

package/src/core/table.d.ts

@@ -0,0 +1,98 @@
+/**
+ * @file table.ts
+ * @descripcion Clase Table rediseñada con API completa y tipado estricto
+ * @autor Miguel Alejandro
+ * @fecha 2025-07-30
+ */
+import type { InferAttributes, QueryOperator, WrapperEntry, WhereQueryOptions } from "../@types/index";
+import { STORE } from "./wrapper";
+export default class Table<T = any> {
+    protected [STORE]: {
+        [K in keyof T]?: T[K];
+    };
+    constructor(data: InferAttributes<T>);
+    /** Serializar instancia a JSON plano */
+    toJSON(): Record<string, any>;
+    /** Guardar instancia (crear o actualizar) */
+    save(): Promise<this>;
+    /** Actualizar instancia */
+    update(patch: Partial<InferAttributes<T>>): Promise<this>;
+    /** Eliminar instancia */
+    destroy(): Promise<null>;
+    /**
+     * Crear un nuevo registro en la base de datos
+     */
+    static create<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, data: InferAttributes<M>): Promise<M>;
+    /**
+     * Actualizar registros en la base de datos
+     * @param updates - Campos a actualizar. Los campos con valor `undefined` se ignoran.
+     * @param filters - Filtros para seleccionar los registros a actualizar
+     * @returns Número de registros actualizados
+     */
+    static update<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, updates: Partial<InferAttributes<M>>, filters: Partial<InferAttributes<M>>): Promise<number>;
+    /**
+     * Eliminar registros de la base de datos
+     */
+    static delete<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, filters: Partial<InferAttributes<M>>): Promise<number>;
+    /** Filtrar registros por campo igual a valor */
+    static where<M extends Table, K extends keyof InferAttributes<M>>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, field: K, value: InferAttributes<M>[K] | InferAttributes<M>[K][]): Promise<M[]>;
+    /** Filtrar registros por campo con operador específico */
+    static where<M extends Table, K extends keyof InferAttributes<M>>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, field: K, operator: QueryOperator, value: InferAttributes<M>[K] | InferAttributes<M>[K][]): Promise<M[]>;
+    /** Filtrar registros por múltiples campos (AND) */
+    static where<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, filters: Partial<InferAttributes<M>>): Promise<M[]>;
+    /** Filtrar registros con opciones avanzadas */
+    static where<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, filters: Partial<InferAttributes<M>>, options: WhereQueryOptions<M>): Promise<M[]>;
+    /**
+     * Obtener el primer registro que coincida con los filtros
+     */
+    static first<M extends Table, K extends keyof InferAttributes<M>>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, field: K, value: InferAttributes<M>[K]): Promise<M | undefined>;
+    static first<M extends Table, K extends keyof InferAttributes<M>>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, field: K, operator: QueryOperator, value: InferAttributes<M>[K] | InferAttributes<M>[K][]): Promise<M | undefined>;
+    static first<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, filters: Partial<InferAttributes<M>>): Promise<M | undefined>;
+    /**
+     * Obtener el último registro que coincida con los filtros
+     */
+    static last<M extends Table, K extends keyof InferAttributes<M>>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, field: K, value: InferAttributes<M>[K]): Promise<M | undefined>;
+    static last<M extends Table, K extends keyof InferAttributes<M>>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, field: K, operator: QueryOperator, value: InferAttributes<M>[K] | InferAttributes<M>[K][]): Promise<M | undefined>;
+    static last<M extends Table>(this: {
+        new (data: InferAttributes<M>): M;
+        prototype: M;
+    }, filters: Partial<InferAttributes<M>>): Promise<M | undefined>;
+}
+export { STORE };
+export type { WrapperEntry };