dynoquery 0.1.9 → 0.1.11

package/README.md

@@ -33,7 +33,8 @@ const db = new DynoQuery({
   },
   findBy: {
     //  TENANT#A#CAT#
-    Category: { indexName: 'GSI1', pkPrefix: 'CAT#' } // pkName defaults to GSI1PK, skName defaults to GSI1SK
+    Category: { indexName: 'GSI1', pkPrefix: 'CAT#' }, // pkName defaults to GSI1PK, skName defaults to GSI1SK
+    Date: { indexName: 'GSI2', pkPrefix: 'DATE#' }
   }
 });
 
@@ -68,13 +69,13 @@ async function example() {
   await john.create('PROFILE', { name: 'John Doe', email: 'john@example.com' });
   
   // Resulting GSI1PK: TENANT#A#CAT#USER
-  const cat = db.findByCategory('USER');
+  const cat = db.findByCategory('USER', '1');
+  const date = db.findByDate('2026-10-11', '2');
+  console.log(cat.getSkValue()); // '1'
   await john.create('PROFILE', { 
     name: 'John Doe', 
     email: 'john@example.com', 
-    GSI1PK: cat.getPkValue(), 
-    GSI1SK: 'john@example.com' 
-  });
+  }, [cat, date]);
 
   // Update the item (updates both DB and partition cache)
   await john.update('PROFILE', { theme: 'dark' });
@@ -111,7 +112,7 @@ A way to manage data within a specific partition.
 - `getPkValue()`: Returns the generated partition key value.
 - `get(sk)`: Fetches data for a specific sort key (returns a Promise).
 - `getAll()`: Fetches all items in the partition and caches them. Returns the items.
-- `create(sk, data)`: Creates an item in the partition.
+- `create(sk, data, indices?)`: Creates an item in the partition. If `indices` (array of `IndexQuery`) are provided, it automatically adds the index PK and SK to the item.
 - `update(sk, data)`: Updates an existing item (partial update).
 - `delete(sk)`: Deletes an item.
 - `deleteAll()`: Deletes all items in the partition.
@@ -119,8 +120,9 @@ A way to manage data within a specific partition.
 ### IndexQuery
 A way to query Global Secondary Indexes.
 - `getPkValue()`: Returns the generated partition key value for this index.
-- `get(skValue | options)`: Query items in the index. Supports `skValue` (string) for `begins_with` search, or an options object with `skValue`, `limit`, and `scanIndexForward`.
-- `getAll()`: Fetches all items in the index for the given partition key.
+- `getSkValue()`: Returns the sort key value if it was provided when calling the index query method.
+- `get(skValue | options)`: Query items in the index. Supports `skValue` (string) for `begins_with` search, or an options object with `skValue`, `limit`, and `scanIndexForward`. If `skValue` was provided when the `IndexQuery` was created, it will be used as the default if no `skValue` is passed here.
+- `getAll()`: Fetches all items in the index for the given partition key. If `skValue` was provided when the `IndexQuery` was created, it will filter by it using `begins_with`.
 - Automatically identifies the model name in results using `__model` (based on registered models) and provides `getPartition()` helper.
 
 ## License

package/dist/index-query.d.ts

@@ -6,6 +6,7 @@ export interface IndexQueryConfig {
     skName?: string;
     pkPrefix?: string;
     pkValue: string;
+    skValue?: string;
 }
 export declare class IndexQuery {
     protected db: DynoQuery;
@@ -14,6 +15,7 @@ export declare class IndexQuery {
     protected pkName: string;
     protected skName: string;
     protected pkValue: string;
+    protected skValue?: string;
     constructor(db: DynoQuery, config: IndexQueryConfig);
     get<T = any>(skValueOrOptions?: string | {
         skValue?: string;
@@ -22,5 +24,8 @@ export declare class IndexQuery {
     }): Promise<T[]>;
     getAll<T = any>(): Promise<T[]>;
     getPkValue(): string;
+    getPkName(): string;
+    getSkName(): string;
+    getSkValue(): string | undefined;
     private mapItemToModel;
 }

package/dist/index-query.js

@@ -18,6 +18,7 @@ class IndexQuery {
         this.indexName = config.indexName;
         this.pkName = config.pkName || (this.indexName + "PK");
         this.skName = config.skName || (this.indexName + "SK");
+        this.skValue = config.skValue;
         const globalPrefix = db.getPkPrefix();
         const indexPrefix = config.pkPrefix || "";
         let finalPrefix = indexPrefix;
@@ -38,6 +39,9 @@ class IndexQuery {
             else if (typeof skValueOrOptions === 'object') {
                 options = skValueOrOptions;
             }
+            else if (this.skValue) {
+                options.skValue = this.skValue;
+            }
             let keyCondition = "#pk = :pk";
             const expressionAttributeNames = {
                 "#pk": this.pkName,
@@ -71,6 +75,15 @@ class IndexQuery {
     getPkValue() {
         return this.pkValue;
     }
+    getPkName() {
+        return this.pkName;
+    }
+    getSkName() {
+        return this.skName;
+    }
+    getSkValue() {
+        return this.skValue;
+    }
     mapItemToModel(item) {
         const pkName = this.db.getPkName();
         const pkValue = item[pkName];

package/dist/index.js

@@ -64,13 +64,14 @@ class DynoQuery {
             const { IndexQuery } = require("./index-query");
             Object.entries(findBy).forEach(([name, def]) => {
                 const methodName = `findBy${name}`;
-                this[methodName] = (id) => {
+                this[methodName] = (id, skValue) => {
                     return new IndexQuery(this, {
                         indexName: def.indexName,
                         pkName: def.pkName,
                         skName: def.skName,
                         pkPrefix: def.pkPrefix,
-                        pkValue: id
+                        pkValue: id,
+                        skValue: skValue
                     });
                 };
             });

package/dist/partition.d.ts

@@ -1,4 +1,5 @@
 import { DynoQuery } from "./index";
+import { IndexQuery } from "./index-query";
 export interface PartitionConfig {
     tableName?: string;
     pk?: string;
@@ -21,7 +22,7 @@ export declare class Partition {
     /**
      * Create an item in this partition.
      */
-    create<T = any>(sk: string, data: T): Promise<void>;
+    create<T = any>(sk: string, data: T, indices?: IndexQuery[]): Promise<void>;
     /**
      * Update an existing item in this partition.
      */

package/dist/partition.js

@@ -79,9 +79,17 @@ class Partition {
     /**
      * Create an item in this partition.
      */
-    create(sk, data) {
+    create(sk, data, indices) {
         return __awaiter(this, void 0, void 0, function* () {
             const item = Object.assign({ [this.pkName]: this.pkValue, [this.skName]: sk }, data);
+            if (indices) {
+                indices.forEach((index) => {
+                    item[index.getPkName()] = index.getPkValue();
+                    if (index.getSkValue() !== undefined) {
+                        item[index.getSkName()] = index.getSkValue();
+                    }
+                });
+            }
             yield this.db.create({
                 TableName: this.tableName,
                 Item: item,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dynoquery",
-  "version": "0.1.9",
+  "version": "0.1.11",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/devspikejs/dynoquery.git"