@jaypie/constructs 1.2.42 → 1.2.44

package/dist/cjs/index.d.ts

@@ -10,7 +10,7 @@ export { JaypieDatadogSecret } from "./JaypieDatadogSecret";
 export { JaypieDistribution, JaypieDistributionProps, JaypieWafConfig, SecurityHeadersOverrides, } from "./JaypieDistribution";
 export { JaypieDnsRecord, JaypieDnsRecordProps } from "./JaypieDnsRecord";
 export { JaypieDynamoDb, JaypieDynamoDbProps } from "./JaypieDynamoDb";
-export type { IndexDefinition } from "@jaypie/fabric";
+export type { IndexDefinition } from "./types/IndexDefinition";
 export { JaypieEnvSecret } from "./JaypieEnvSecret";
 export { JaypieEventsRule, JaypieEventsRuleProps } from "./JaypieEventsRule";
 export { JaypieExpressLambda } from "./JaypieExpressLambda";

package/dist/cjs/types/IndexDefinition.d.ts

@@ -0,0 +1,22 @@
+/**
+ * GSI index definition for JaypieDynamoDb.
+ *
+ * Shape mirrors `@jaypie/fabric`'s IndexDefinition so a single object can be
+ * shared between CDK provisioning (here) and runtime model code (fabric).
+ * The type is owned locally so `@jaypie/constructs` does not take a runtime
+ * dependency on the pre-1.0 `@jaypie/fabric` package.
+ *
+ * - `pk` fields are combined with a separator to form the partition key attribute
+ * - `sk` with one field uses that field directly as the GSI sort key
+ * - `sk` with multiple fields produces a composite `{indexName}Sk` attribute
+ */
+export interface IndexDefinition {
+    /** Name of the index (auto-generated from pk fields if not provided) */
+    name?: string;
+    /** Partition key fields - combined with separator */
+    pk: string[];
+    /** Sort key fields - combined with separator when composite */
+    sk?: string[];
+    /** Advisory: index key is only written when all pk/sk fields are present */
+    sparse?: boolean;
+}

package/dist/esm/JaypieDynamoDb.d.ts

@@ -1,10 +1,10 @@
 import { Construct } from "constructs";
 import { RemovalPolicy } from "aws-cdk-lib";
 import * as dynamodb from "aws-cdk-lib/aws-dynamodb";
-import { type IndexDefinition } from "@jaypie/fabric";
+import type { IndexDefinition } from "./types/IndexDefinition";
 export interface JaypieDynamoDbProps extends Omit<dynamodb.TablePropsV2, "globalSecondaryIndexes" | "partitionKey" | "sortKey"> {
     /**
-     * Configure GSIs for the table using @jaypie/fabric IndexDefinition format.
+     * Configure GSIs for the table using the IndexDefinition format.
      * - `undefined`: No GSIs (default)
      * - Array of IndexDefinition: Use the specified indexes
      *
@@ -13,18 +13,18 @@ export interface JaypieDynamoDbProps extends Omit<dynamodb.TablePropsV2, "global
      * new JaypieDynamoDb(this, "myTable");
      *
      * @example
-     * // With custom indexes
+     * // Inline indexes
      * new JaypieDynamoDb(this, "myTable", {
      *   indexes: [
-     *     { pk: ["scope", "model"], sk: ["sequence"] },
-     *     { pk: ["scope", "model", "type"], sk: ["sequence"], sparse: true },
+     *     { name: "indexModel", pk: ["model"], sk: ["scope", "updatedAt"] },
+     *     { name: "indexModelAlias", pk: ["model", "alias"], sk: ["scope", "updatedAt"], sparse: true },
      *   ],
      * });
      */
     indexes?: IndexDefinition[];
     /**
      * Partition key attribute definition.
-     * @default { name: "model", type: AttributeType.STRING }
+     * @default { name: "id", type: AttributeType.STRING }
      */
     partitionKey?: dynamodb.Attribute;
     /**
@@ -40,8 +40,8 @@ export interface JaypieDynamoDbProps extends Omit<dynamodb.TablePropsV2, "global
      */
     service?: string;
     /**
-     * Sort key attribute definition.
-     * @default { name: "id", type: AttributeType.STRING }
+     * Sort key attribute definition. Defaults to `undefined` (no sort key) —
+     * the Jaypie single-table pattern uses `id` as a unique partition key.
      */
     sortKey?: dynamodb.Attribute;
     /**
@@ -53,8 +53,7 @@ export interface JaypieDynamoDbProps extends Omit<dynamodb.TablePropsV2, "global
  * DynamoDB table with Jaypie single-table design patterns.
  *
  * Creates a table with:
- * - Partition key: `model` (String)
- * - Sort key: `id` (String)
+ * - Partition key: `id` (String), no sort key
  * - Billing: PAY_PER_REQUEST (on-demand)
  * - Removal policy: RETAIN in production, DESTROY otherwise
  * - No GSIs by default (use `indexes` prop to add them)
@@ -65,12 +64,12 @@ export interface JaypieDynamoDbProps extends Omit<dynamodb.TablePropsV2, "global
  * const table = new JaypieDynamoDb(this, "myApp");
  *
  * @example
- * // With explicit table name (overrides CDK-generated name)
+ * // With inline IndexDefinition for GSIs
  * const table = new JaypieDynamoDb(this, "MyTable", {
  *   tableName: "custom-table-name",
  *   indexes: [
- *     { pk: ["scope", "model"] },
- *     { pk: ["scope", "model", "type"], sparse: true },
+ *     { name: "indexModel", pk: ["model"], sk: ["scope", "updatedAt"] },
+ *     { name: "indexModelAlias", pk: ["model", "alias"], sk: ["scope", "updatedAt"], sparse: true },
  *   ],
  * });
  */

package/dist/esm/index.d.ts

@@ -10,7 +10,7 @@ export { JaypieDatadogSecret } from "./JaypieDatadogSecret";
 export { JaypieDistribution, JaypieDistributionProps, JaypieWafConfig, SecurityHeadersOverrides, } from "./JaypieDistribution";
 export { JaypieDnsRecord, JaypieDnsRecordProps } from "./JaypieDnsRecord";
 export { JaypieDynamoDb, JaypieDynamoDbProps } from "./JaypieDynamoDb";
-export type { IndexDefinition } from "@jaypie/fabric";
+export type { IndexDefinition } from "./types/IndexDefinition";
 export { JaypieEnvSecret } from "./JaypieEnvSecret";
 export { JaypieEventsRule, JaypieEventsRuleProps } from "./JaypieEventsRule";
 export { JaypieExpressLambda } from "./JaypieExpressLambda";

package/dist/esm/index.js

@@ -26,7 +26,6 @@ import * as cloudfront from 'aws-cdk-lib/aws-cloudfront';
 import * as origins from 'aws-cdk-lib/aws-cloudfront-origins';
 import * as wafv2 from 'aws-cdk-lib/aws-wafv2';
 import * as dynamodb from 'aws-cdk-lib/aws-dynamodb';
-import { generateIndexName, DEFAULT_SORT_KEY } from '@jaypie/fabric';
 import * as cr from 'aws-cdk-lib/custom-resources';
 import { Nextjs } from 'cdk-nextjs-standalone';
 import * as path from 'path';
@@ -2895,41 +2894,65 @@ class JaypieDnsRecord extends Construct {
     }
 }
 
-//
-//
-// Constants
-//
-/** Composite key separator used in GSI partition keys */
-const SEPARATOR = "#";
 //
 //
 // Helper Functions
 //
 /**
- * Convert IndexDefinition[] from @jaypie/fabric to CDK GlobalSecondaryIndexPropsV2[]
+ * Derive GSI attribute names for an index definition.
+ *
+ * Mirrors `@jaypie/fabric`'s `getGsiAttributeNames` so CDK provisioning and
+ * any runtime write path agree on the attribute names. Kept local to avoid
+ * a runtime dependency on the pre-1.0 `@jaypie/fabric` package.
  *
- * @param indexes - Array of IndexDefinition from @jaypie/fabric
- * @returns Array of CDK GlobalSecondaryIndexPropsV2
+ * - `pk` is always the index name (`index.name` or generated from `index.pk`)
+ * - `sk` is the single sk field name when `sk.length === 1`, or
+ *   `{indexName}Sk` when `sk.length > 1` (composite sk attribute)
+ */
+function getGsiAttributeNames(index) {
+    const name = index.name ?? generateIndexName(index.pk);
+    let sk;
+    if (index.sk && index.sk.length > 1) {
+        sk = `${name}Sk`;
+    }
+    else if (index.sk && index.sk.length === 1) {
+        sk = index.sk[0];
+    }
+    return { pk: name, sk };
+}
+function generateIndexName(pk) {
+    const suffix = pk
+        .map((field) => field.charAt(0).toUpperCase() + field.slice(1))
+        .join("");
+    return `index${suffix}`;
+}
+/**
+ * Convert IndexDefinition[] to CDK GlobalSecondaryIndexPropsV2[].
+ *
+ * Composite sk indexes (sk.length > 1) get a dedicated STRING `{indexName}Sk`
+ * attribute; single-field sk indexes reference the field directly (STRING in
+ * the general case, NUMBER for the legacy `sequence` name).
  */
 function indexesToGsi(indexes) {
     return indexes.map((index) => {
-        // Generate index name from pk fields if not provided
-        const indexName = index.name ?? generateIndexName(index.pk);
-        // Sort key defaults to ["sequence"] if not provided
-        const skFields = index.sk ?? DEFAULT_SORT_KEY;
+        const { pk, sk } = getGsiAttributeNames(index);
+        let sortKey;
+        if (sk) {
+            if (sk === "sequence") {
+                sortKey = { name: "sequence", type: dynamodb.AttributeType.NUMBER };
+            }
+            else {
+                sortKey = { name: sk, type: dynamodb.AttributeType.STRING };
+            }
+        }
         return {
-            indexName,
+            indexName: pk,
             partitionKey: {
-                name: indexName,
+                name: pk,
                 type: dynamodb.AttributeType.STRING,
             },
             projectionType: dynamodb.ProjectionType.ALL,
-            sortKey: skFields.length === 1 && skFields[0] === "sequence"
-                ? { name: "sequence", type: dynamodb.AttributeType.NUMBER }
-                : {
-                    name: skFields.join(SEPARATOR),
-                    type: dynamodb.AttributeType.STRING,
-                },
+            ...(sortKey && { sortKey }),
         };
     });
 }
@@ -2941,8 +2964,7 @@ function indexesToGsi(indexes) {
  * DynamoDB table with Jaypie single-table design patterns.
  *
  * Creates a table with:
- * - Partition key: `model` (String)
- * - Sort key: `id` (String)
+ * - Partition key: `id` (String), no sort key
  * - Billing: PAY_PER_REQUEST (on-demand)
  * - Removal policy: RETAIN in production, DESTROY otherwise
  * - No GSIs by default (use `indexes` prop to add them)
@@ -2953,12 +2975,12 @@ function indexesToGsi(indexes) {
  * const table = new JaypieDynamoDb(this, "myApp");
  *
  * @example
- * // With explicit table name (overrides CDK-generated name)
+ * // With inline IndexDefinition for GSIs
  * const table = new JaypieDynamoDb(this, "MyTable", {
  *   tableName: "custom-table-name",
  *   indexes: [
- *     { pk: ["scope", "model"] },
- *     { pk: ["scope", "model", "type"], sparse: true },
+ *     { name: "indexModel", pk: ["model"], sk: ["scope", "updatedAt"] },
+ *     { name: "indexModelAlias", pk: ["model", "alias"], sk: ["scope", "updatedAt"], sparse: true },
  *   ],
  * });
  */
@@ -2971,11 +2993,11 @@ class JaypieDynamoDb extends Construct {
         const constructId = isShorthand ? `JaypieDynamoDb-${id}` : id;
         super(scope, constructId);
         const { billing = dynamodb.Billing.onDemand(), indexes, partitionKey = {
-            name: "model",
+            name: "id",
             type: dynamodb.AttributeType.STRING,
         }, project, removalPolicy = isProductionEnv()
             ? RemovalPolicy.RETAIN
-            : RemovalPolicy.DESTROY, roleTag = CDK$2.ROLE.STORAGE, service, sortKey = { name: "id", type: dynamodb.AttributeType.STRING }, vendorTag, ...restProps } = props;
+            : RemovalPolicy.DESTROY, roleTag = CDK$2.ROLE.STORAGE, service, sortKey, vendorTag, ...restProps } = props;
         // Convert IndexDefinition[] to CDK GSI props
         const globalSecondaryIndexes = indexes ? indexesToGsi(indexes) : undefined;
         this._table = new dynamodb.TableV2(this, "Table", {
@@ -2983,7 +3005,7 @@ class JaypieDynamoDb extends Construct {
             globalSecondaryIndexes,
             partitionKey,
             removalPolicy,
-            sortKey,
+            ...(sortKey && { sortKey }),
             ...restProps,
         });
         // Apply tags