@jaypie/dynamodb 0.1.1 → 0.1.3

package/dist/esm/index.js

@@ -3,6 +3,10 @@ import { DynamoDBDocumentClient, GetCommand, PutCommand, DeleteCommand, QueryCom
 import { ConfigurationError } from '@jaypie/errors';
 import { serviceHandler } from '@jaypie/vocabulary';
 
+// Environment variable names
+const ENV_AWS_REGION = "AWS_REGION";
+const ENV_DYNAMODB_TABLE_NAME = "DYNAMODB_TABLE_NAME";
+// Defaults
 const DEFAULT_REGION = "us-east-1";
 const LOCAL_CREDENTIALS = {
     accessKeyId: "local",
@@ -25,8 +29,9 @@ function isLocalEndpoint(endpoint) {
  *
  * @param config - Client configuration
  */
-function initClient(config) {
-    const { endpoint, region = DEFAULT_REGION } = config;
+function initClient(config = {}) {
+    const { endpoint } = config;
+    const region = config.region ?? process.env[ENV_AWS_REGION] ?? DEFAULT_REGION;
     // Auto-detect local mode and use dummy credentials
     const credentials = config.credentials ??
         (isLocalEndpoint(endpoint) ? LOCAL_CREDENTIALS : undefined);
@@ -40,7 +45,7 @@ function initClient(config) {
             removeUndefinedValues: true,
         },
     });
-    tableName = config.tableName;
+    tableName = config.tableName ?? process.env[ENV_DYNAMODB_TABLE_NAME] ?? null;
 }
 /**
  * Get the initialized DynamoDB Document Client
@@ -529,5 +534,154 @@ const queryByXid = serviceHandler({
     },
 });
 
-export { APEX, ARCHIVED_SUFFIX, DELETED_SUFFIX, INDEX_ALIAS, INDEX_CLASS, INDEX_OU, INDEX_TYPE, INDEX_XID, SEPARATOR, archiveEntity, buildIndexAlias, buildIndexClass, buildIndexOu, buildIndexType, buildIndexXid, calculateOu, deleteEntity, destroyEntity, getDocClient, getEntity, getTableName, indexEntity, initClient, isInitialized, putEntity, queryByAlias, queryByClass, queryByOu, queryByType, queryByXid, resetClient, updateEntity };
+/**
+ * Seed a single entity if it doesn't already exist
+ *
+ * @param entity - Partial entity with at least alias, model, and ou
+ * @returns true if entity was created, false if it already exists
+ */
+async function seedEntityIfNotExists(entity) {
+    if (!entity.alias || !entity.model || !entity.ou) {
+        throw new Error("Entity must have alias, model, and ou to check existence");
+    }
+    // Check if entity already exists
+    const existing = await queryByAlias({
+        alias: entity.alias,
+        model: entity.model,
+        ou: entity.ou,
+    });
+    if (existing) {
+        return false;
+    }
+    // Generate required fields if missing
+    const now = new Date().toISOString();
+    const completeEntity = {
+        createdAt: entity.createdAt ?? now,
+        id: entity.id ?? crypto.randomUUID(),
+        model: entity.model,
+        name: entity.name ?? entity.alias,
+        ou: entity.ou,
+        sequence: entity.sequence ?? Date.now(),
+        updatedAt: entity.updatedAt ?? now,
+        ...entity,
+    };
+    await putEntity({ entity: completeEntity });
+    return true;
+}
+/**
+ * Seed multiple entities (idempotent)
+ *
+ * - Checks existence by alias (via queryByAlias) before creating
+ * - Auto-generates id (UUID), createdAt, updatedAt if missing
+ * - Skip existing unless replace: true
+ * - Returns counts of created/skipped/errors
+ *
+ * @param entities - Array of partial entities to seed
+ * @param options - Seed options
+ * @returns Result with created, skipped, and errors arrays
+ */
+async function seedEntities(entities, options = {}) {
+    const { dryRun = false, replace = false } = options;
+    const result = {
+        created: [],
+        errors: [],
+        skipped: [],
+    };
+    for (const entity of entities) {
+        const alias = entity.alias ?? entity.name ?? "unknown";
+        try {
+            if (!entity.model || !entity.ou) {
+                throw new Error("Entity must have model and ou");
+            }
+            // For entities with alias, check existence
+            if (entity.alias) {
+                const existing = await queryByAlias({
+                    alias: entity.alias,
+                    model: entity.model,
+                    ou: entity.ou,
+                });
+                if (existing && !replace) {
+                    result.skipped.push(alias);
+                    continue;
+                }
+                // If replacing, use existing ID to update rather than create new
+                if (existing && replace) {
+                    entity.id = existing.id;
+                }
+            }
+            if (dryRun) {
+                result.created.push(alias);
+                continue;
+            }
+            // Generate required fields if missing
+            const now = new Date().toISOString();
+            const completeEntity = {
+                createdAt: entity.createdAt ?? now,
+                id: entity.id ?? crypto.randomUUID(),
+                model: entity.model,
+                name: entity.name ?? entity.alias ?? "Unnamed",
+                ou: entity.ou,
+                sequence: entity.sequence ?? Date.now(),
+                updatedAt: entity.updatedAt ?? now,
+                ...entity,
+            };
+            await putEntity({ entity: completeEntity });
+            result.created.push(alias);
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            result.errors.push({ alias, error: errorMessage });
+        }
+    }
+    return result;
+}
+/**
+ * Export entities by model and organizational unit
+ *
+ * - Paginates through all matching entities via queryByOu
+ * - Returns entities sorted by sequence (ascending)
+ *
+ * @param model - The entity model name
+ * @param ou - The organizational unit
+ * @param limit - Optional maximum number of entities to export
+ * @returns Export result with entities and count
+ */
+async function exportEntities(model, ou, limit) {
+    const entities = [];
+    let startKey;
+    let remaining = limit;
+    do {
+        const batchLimit = remaining !== undefined ? Math.min(remaining, 100) : undefined;
+        const { items, lastEvaluatedKey } = await queryByOu({
+            ascending: true,
+            limit: batchLimit,
+            model,
+            ou,
+            startKey,
+        });
+        entities.push(...items);
+        startKey = lastEvaluatedKey;
+        if (remaining !== undefined) {
+            remaining -= items.length;
+        }
+    } while (startKey && (remaining === undefined || remaining > 0));
+    return {
+        count: entities.length,
+        entities,
+    };
+}
+/**
+ * Export entities as a JSON string
+ *
+ * @param model - The entity model name
+ * @param ou - The organizational unit
+ * @param pretty - Format JSON with indentation (default: true)
+ * @returns JSON string of exported entities
+ */
+async function exportEntitiesToJson(model, ou, pretty = true) {
+    const { entities } = await exportEntities(model, ou);
+    return pretty ? JSON.stringify(entities, null, 2) : JSON.stringify(entities);
+}
+
+export { APEX, ARCHIVED_SUFFIX, DELETED_SUFFIX, INDEX_ALIAS, INDEX_CLASS, INDEX_OU, INDEX_TYPE, INDEX_XID, SEPARATOR, archiveEntity, buildIndexAlias, buildIndexClass, buildIndexOu, buildIndexType, buildIndexXid, calculateOu, deleteEntity, destroyEntity, exportEntities, exportEntitiesToJson, getDocClient, getEntity, getTableName, indexEntity, initClient, isInitialized, putEntity, queryByAlias, queryByClass, queryByOu, queryByType, queryByXid, resetClient, seedEntities, seedEntityIfNotExists, updateEntity };
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../src/client.ts","../../../src/constants.ts","../../../src/keyBuilders.ts","../../../src/entities.ts","../../../src/queries.ts"],"sourcesContent":["import { DynamoDBClient } from \"@aws-sdk/client-dynamodb\";\nimport { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\nimport { ConfigurationError } from \"@jaypie/errors\";\n\nimport type { DynamoClientConfig } from \"./types.js\";\n\nconst DEFAULT_REGION = \"us-east-1\";\nconst LOCAL_CREDENTIALS = {\n  accessKeyId: \"local\",\n  secretAccessKey: \"local\",\n};\n\n// Module-level state\nlet docClient: DynamoDBDocumentClient | null = null;\nlet tableName: string | null = null;\n\n/**\n * Check if endpoint indicates local development mode\n */\nfunction isLocalEndpoint(endpoint?: string): boolean {\n  if (!endpoint) return false;\n  return endpoint.includes(\"127.0.0.1\") || endpoint.includes(\"localhost\");\n}\n\n/**\n * Initialize the DynamoDB client\n * Must be called once at application startup before using query functions\n *\n * @param config - Client configuration\n */\nexport function initClient(config: DynamoClientConfig): void {\n  const { endpoint, region = DEFAULT_REGION } = config;\n\n  // Auto-detect local mode and use dummy credentials\n  const credentials =\n    config.credentials ??\n    (isLocalEndpoint(endpoint) ? LOCAL_CREDENTIALS : undefined);\n\n  const dynamoClient = new DynamoDBClient({\n    ...(credentials && { credentials }),\n    ...(endpoint && { endpoint }),\n    region,\n  });\n\n  docClient = DynamoDBDocumentClient.from(dynamoClient, {\n    marshallOptions: {\n      removeUndefinedValues: true,\n    },\n  });\n\n  tableName = config.tableName;\n}\n\n/**\n * Get the initialized DynamoDB Document Client\n * @throws ConfigurationError if client has not been initialized\n */\nexport function getDocClient(): DynamoDBDocumentClient {\n  if (!docClient) {\n    throw new ConfigurationError(\n      \"DynamoDB client not initialized. Call initClient() first.\",\n    );\n  }\n  return docClient;\n}\n\n/**\n * Get the configured table name\n * @throws ConfigurationError if client has not been initialized\n */\nexport function getTableName(): string {\n  if (!tableName) {\n    throw new ConfigurationError(\n      \"DynamoDB client not initialized. Call initClient() first.\",\n    );\n  }\n  return tableName;\n}\n\n/**\n * Check if the client has been initialized\n */\nexport function isInitialized(): boolean {\n  return docClient !== null && tableName !== null;\n}\n\n/**\n * Reset the client state (primarily for testing)\n */\nexport function resetClient(): void {\n  docClient = null;\n  tableName = null;\n}\n","// Primary markers\nexport const APEX = \"@\"; // Root-level marker (DynamoDB prohibits empty strings)\nexport const SEPARATOR = \"#\"; // Composite key separator\n\n// GSI names\nexport const INDEX_ALIAS = \"indexAlias\";\nexport const INDEX_CLASS = \"indexClass\";\nexport const INDEX_OU = \"indexOu\";\nexport const INDEX_TYPE = \"indexType\";\nexport const INDEX_XID = \"indexXid\";\n\n// Index suffixes for soft state\nexport const ARCHIVED_SUFFIX = \"#archived\";\nexport const DELETED_SUFFIX = \"#deleted\";\n","import { APEX, SEPARATOR } from \"./constants.js\";\nimport type { FabricEntity, ParentReference } from \"./types.js\";\n\n/**\n * Build the indexOu key for hierarchical queries\n * @param ou - The organizational unit (APEX or \"{parent.model}#{parent.id}\")\n * @param model - The entity model name\n * @returns Composite key: \"{ou}#{model}\"\n */\nexport function buildIndexOu(ou: string, model: string): string {\n  return `${ou}${SEPARATOR}${model}`;\n}\n\n/**\n * Build the indexAlias key for human-friendly lookups\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param alias - The human-friendly alias\n * @returns Composite key: \"{ou}#{model}#{alias}\"\n */\nexport function buildIndexAlias(\n  ou: string,\n  model: string,\n  alias: string,\n): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${alias}`;\n}\n\n/**\n * Build the indexClass key for category filtering\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param recordClass - The category classification\n * @returns Composite key: \"{ou}#{model}#{class}\"\n */\nexport function buildIndexClass(\n  ou: string,\n  model: string,\n  recordClass: string,\n): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${recordClass}`;\n}\n\n/**\n * Build the indexType key for type filtering\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param type - The type classification\n * @returns Composite key: \"{ou}#{model}#{type}\"\n */\nexport function buildIndexType(\n  ou: string,\n  model: string,\n  type: string,\n): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${type}`;\n}\n\n/**\n * Build the indexXid key for external ID lookups\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param xid - The external ID\n * @returns Composite key: \"{ou}#{model}#{xid}\"\n */\nexport function buildIndexXid(ou: string, model: string, xid: string): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${xid}`;\n}\n\n/**\n * Calculate the organizational unit from a parent reference\n * @param parent - Optional parent entity reference\n * @returns APEX (\"@\") if no parent, otherwise \"{parent.model}#{parent.id}\"\n */\nexport function calculateOu(parent?: ParentReference): string {\n  if (!parent) {\n    return APEX;\n  }\n  return `${parent.model}${SEPARATOR}${parent.id}`;\n}\n\n/**\n * Auto-populate GSI index keys on an entity\n * - indexOu is always populated from ou + model\n * - indexAlias is populated only when alias is present\n * - indexClass is populated only when class is present\n * - indexType is populated only when type is present\n * - indexXid is populated only when xid is present\n *\n * @param entity - The entity to populate index keys for\n * @param suffix - Optional suffix to append to all index keys (e.g., \"#deleted\", \"#archived\")\n * @returns The entity with populated index keys\n */\nexport function indexEntity<T extends FabricEntity>(\n  entity: T,\n  suffix: string = \"\",\n): T {\n  const result = { ...entity };\n\n  // indexOu is always set (from ou + model)\n  result.indexOu = buildIndexOu(entity.ou, entity.model) + suffix;\n\n  // Optional indexes - only set when the source field is present\n  if (entity.alias !== undefined) {\n    result.indexAlias =\n      buildIndexAlias(entity.ou, entity.model, entity.alias) + suffix;\n  }\n\n  if (entity.class !== undefined) {\n    result.indexClass =\n      buildIndexClass(entity.ou, entity.model, entity.class) + suffix;\n  }\n\n  if (entity.type !== undefined) {\n    result.indexType =\n      buildIndexType(entity.ou, entity.model, entity.type) + suffix;\n  }\n\n  if (entity.xid !== undefined) {\n    result.indexXid =\n      buildIndexXid(entity.ou, entity.model, entity.xid) + suffix;\n  }\n\n  return result;\n}\n","import { DeleteCommand, GetCommand, PutCommand } from \"@aws-sdk/lib-dynamodb\";\nimport { serviceHandler } from \"@jaypie/vocabulary\";\n\nimport { getDocClient, getTableName } from \"./client.js\";\nimport { ARCHIVED_SUFFIX, DELETED_SUFFIX } from \"./constants.js\";\nimport { indexEntity } from \"./keyBuilders.js\";\nimport type { FabricEntity } from \"./types.js\";\n\n/**\n * Calculate suffix based on entity's archived/deleted state\n */\nfunction calculateEntitySuffix(entity: {\n  archivedAt?: string;\n  deletedAt?: string;\n}): string {\n  const hasArchived = Boolean(entity.archivedAt);\n  const hasDeleted = Boolean(entity.deletedAt);\n\n  if (hasArchived && hasDeleted) {\n    return ARCHIVED_SUFFIX + DELETED_SUFFIX;\n  }\n  if (hasArchived) {\n    return ARCHIVED_SUFFIX;\n  }\n  if (hasDeleted) {\n    return DELETED_SUFFIX;\n  }\n  return \"\";\n}\n\n/**\n * Get a single entity by primary key\n */\nexport const getEntity = serviceHandler({\n  alias: \"getEntity\",\n  description: \"Get a single entity by primary key\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<FabricEntity | null> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    const command = new GetCommand({\n      Key: { id, model },\n      TableName: tableName,\n    });\n\n    const response = await docClient.send(command);\n    return (response.Item as FabricEntity) ?? null;\n  },\n});\n\n/**\n * Put (create or replace) an entity\n * Auto-populates GSI index keys via indexEntity\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex FabricEntity objects that can't be coerced by vocabulary's type system.\n */\nexport async function putEntity({\n  entity,\n}: {\n  entity: FabricEntity;\n}): Promise<FabricEntity> {\n  const docClient = getDocClient();\n  const tableName = getTableName();\n\n  // Auto-populate index keys\n  const indexedEntity = indexEntity(entity);\n\n  const command = new PutCommand({\n    Item: indexedEntity,\n    TableName: tableName,\n  });\n\n  await docClient.send(command);\n  return indexedEntity;\n}\n\n/**\n * Update an existing entity\n * Auto-populates GSI index keys and sets updatedAt\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex FabricEntity objects that can't be coerced by vocabulary's type system.\n */\nexport async function updateEntity({\n  entity,\n}: {\n  entity: FabricEntity;\n}): Promise<FabricEntity> {\n  const docClient = getDocClient();\n  const tableName = getTableName();\n\n  // Update timestamp and re-index\n  const updatedEntity = indexEntity({\n    ...entity,\n    updatedAt: new Date().toISOString(),\n  });\n\n  const command = new PutCommand({\n    Item: updatedEntity,\n    TableName: tableName,\n  });\n\n  await docClient.send(command);\n  return updatedEntity;\n}\n\n/**\n * Soft delete an entity by setting deletedAt timestamp\n * Re-indexes with appropriate suffix based on archived/deleted state\n */\nexport const deleteEntity = serviceHandler({\n  alias: \"deleteEntity\",\n  description: \"Soft delete an entity (sets deletedAt timestamp)\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<boolean> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    // Fetch the current entity\n    const existing = await getEntity({ id, model });\n    if (!existing) {\n      return false;\n    }\n\n    const now = new Date().toISOString();\n\n    // Build updated entity with deletedAt\n    const updatedEntity = {\n      ...existing,\n      deletedAt: now,\n      updatedAt: now,\n    };\n\n    // Calculate suffix based on combined state (may already be archived)\n    const suffix = calculateEntitySuffix(updatedEntity);\n    const deletedEntity = indexEntity(updatedEntity, suffix);\n\n    const command = new PutCommand({\n      Item: deletedEntity,\n      TableName: tableName,\n    });\n\n    await docClient.send(command);\n    return true;\n  },\n});\n\n/**\n * Archive an entity by setting archivedAt timestamp\n * Re-indexes with appropriate suffix based on archived/deleted state\n */\nexport const archiveEntity = serviceHandler({\n  alias: \"archiveEntity\",\n  description: \"Archive an entity (sets archivedAt timestamp)\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<boolean> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    // Fetch the current entity\n    const existing = await getEntity({ id, model });\n    if (!existing) {\n      return false;\n    }\n\n    const now = new Date().toISOString();\n\n    // Build updated entity with archivedAt\n    const updatedEntity = {\n      ...existing,\n      archivedAt: now,\n      updatedAt: now,\n    };\n\n    // Calculate suffix based on combined state (may already be deleted)\n    const suffix = calculateEntitySuffix(updatedEntity);\n    const archivedEntity = indexEntity(updatedEntity, suffix);\n\n    const command = new PutCommand({\n      Item: archivedEntity,\n      TableName: tableName,\n    });\n\n    await docClient.send(command);\n    return true;\n  },\n});\n\n/**\n * Hard delete an entity (permanently removes from table)\n * Use with caution - prefer deleteEntity for soft delete\n */\nexport const destroyEntity = serviceHandler({\n  alias: \"destroyEntity\",\n  description: \"Hard delete an entity (permanently removes from table)\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<boolean> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    const command = new DeleteCommand({\n      Key: { id, model },\n      TableName: tableName,\n    });\n\n    await docClient.send(command);\n    return true;\n  },\n});\n","import { QueryCommand } from \"@aws-sdk/lib-dynamodb\";\nimport { serviceHandler } from \"@jaypie/vocabulary\";\n\nimport { getDocClient, getTableName } from \"./client.js\";\nimport {\n  ARCHIVED_SUFFIX,\n  DELETED_SUFFIX,\n  INDEX_ALIAS,\n  INDEX_CLASS,\n  INDEX_OU,\n  INDEX_TYPE,\n  INDEX_XID,\n} from \"./constants.js\";\nimport {\n  buildIndexAlias,\n  buildIndexClass,\n  buildIndexOu,\n  buildIndexType,\n  buildIndexXid,\n} from \"./keyBuilders.js\";\nimport type { BaseQueryOptions, FabricEntity, QueryResult } from \"./types.js\";\n\n/**\n * Calculate the suffix based on archived/deleted flags\n * When both are true, returns combined suffix (archived first, alphabetically)\n */\nfunction calculateSuffix({\n  archived,\n  deleted,\n}: {\n  archived?: boolean;\n  deleted?: boolean;\n}): string {\n  if (archived && deleted) {\n    return ARCHIVED_SUFFIX + DELETED_SUFFIX;\n  }\n  if (archived) {\n    return ARCHIVED_SUFFIX;\n  }\n  if (deleted) {\n    return DELETED_SUFFIX;\n  }\n  return \"\";\n}\n\n/**\n * Execute a GSI query with common options\n */\nasync function executeQuery<T extends FabricEntity>(\n  indexName: string,\n  keyValue: string,\n  options: BaseQueryOptions = {},\n): Promise<QueryResult<T>> {\n  const { ascending = false, limit, startKey } = options;\n\n  const docClient = getDocClient();\n  const tableName = getTableName();\n\n  const command = new QueryCommand({\n    ExclusiveStartKey: startKey as Record<string, unknown> | undefined,\n    ExpressionAttributeNames: {\n      \"#pk\": indexName,\n    },\n    ExpressionAttributeValues: {\n      \":pkValue\": keyValue,\n    },\n    IndexName: indexName,\n    KeyConditionExpression: \"#pk = :pkValue\",\n    ...(limit && { Limit: limit }),\n    ScanIndexForward: ascending,\n    TableName: tableName,\n  });\n\n  const response = await docClient.send(command);\n\n  return {\n    items: (response.Items ?? []) as T[],\n    lastEvaluatedKey: response.LastEvaluatedKey,\n  };\n}\n\n/**\n * Query parameters for queryByOu\n */\ninterface QueryByOuParams extends BaseQueryOptions {\n  model: string;\n  ou: string;\n}\n\n/**\n * Query entities by organizational unit (parent hierarchy)\n * Uses indexOu GSI\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex startKey objects that can't be coerced by vocabulary's type system.\n */\nexport async function queryByOu({\n  archived = false,\n  ascending = false,\n  deleted = false,\n  limit,\n  model,\n  ou,\n  startKey,\n}: QueryByOuParams): Promise<QueryResult<FabricEntity>> {\n  const suffix = calculateSuffix({ archived, deleted });\n  const keyValue = buildIndexOu(ou, model) + suffix;\n  return executeQuery<FabricEntity>(INDEX_OU, keyValue, {\n    ascending,\n    limit,\n    startKey,\n  });\n}\n\n/**\n * Query a single entity by human-friendly alias\n * Uses indexAlias GSI\n */\nexport const queryByAlias = serviceHandler({\n  alias: \"queryByAlias\",\n  description: \"Query a single entity by human-friendly alias\",\n  input: {\n    alias: { type: String, description: \"Human-friendly alias\" },\n    archived: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query archived entities instead of active ones\",\n    },\n    deleted: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query deleted entities instead of active ones\",\n    },\n    model: { type: String, description: \"Entity model name\" },\n    ou: { type: String, description: \"Organizational unit (@ for root)\" },\n  },\n  service: async ({\n    alias,\n    archived,\n    deleted,\n    model,\n    ou,\n  }): Promise<FabricEntity | null> => {\n    const aliasStr = alias as string;\n    const archivedBool = archived as boolean | undefined;\n    const deletedBool = deleted as boolean | undefined;\n    const modelStr = model as string;\n    const ouStr = ou as string;\n\n    const suffix = calculateSuffix({ archived: archivedBool, deleted: deletedBool });\n    const keyValue = buildIndexAlias(ouStr, modelStr, aliasStr) + suffix;\n    const result = await executeQuery<FabricEntity>(INDEX_ALIAS, keyValue, {\n      limit: 1,\n    });\n    return result.items[0] ?? null;\n  },\n});\n\n/**\n * Query parameters for queryByClass\n */\ninterface QueryByClassParams extends BaseQueryOptions {\n  model: string;\n  ou: string;\n  recordClass: string;\n}\n\n/**\n * Query entities by category classification\n * Uses indexClass GSI\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex startKey objects that can't be coerced by vocabulary's type system.\n */\nexport async function queryByClass({\n  archived = false,\n  ascending = false,\n  deleted = false,\n  limit,\n  model,\n  ou,\n  recordClass,\n  startKey,\n}: QueryByClassParams): Promise<QueryResult<FabricEntity>> {\n  const suffix = calculateSuffix({ archived, deleted });\n  const keyValue = buildIndexClass(ou, model, recordClass) + suffix;\n  return executeQuery<FabricEntity>(INDEX_CLASS, keyValue, {\n    ascending,\n    limit,\n    startKey,\n  });\n}\n\n/**\n * Query parameters for queryByType\n */\ninterface QueryByTypeParams extends BaseQueryOptions {\n  model: string;\n  ou: string;\n  type: string;\n}\n\n/**\n * Query entities by type classification\n * Uses indexType GSI\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex startKey objects that can't be coerced by vocabulary's type system.\n */\nexport async function queryByType({\n  archived = false,\n  ascending = false,\n  deleted = false,\n  limit,\n  model,\n  ou,\n  startKey,\n  type,\n}: QueryByTypeParams): Promise<QueryResult<FabricEntity>> {\n  const suffix = calculateSuffix({ archived, deleted });\n  const keyValue = buildIndexType(ou, model, type) + suffix;\n  return executeQuery<FabricEntity>(INDEX_TYPE, keyValue, {\n    ascending,\n    limit,\n    startKey,\n  });\n}\n\n/**\n * Query a single entity by external ID\n * Uses indexXid GSI\n */\nexport const queryByXid = serviceHandler({\n  alias: \"queryByXid\",\n  description: \"Query a single entity by external ID\",\n  input: {\n    archived: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query archived entities instead of active ones\",\n    },\n    deleted: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query deleted entities instead of active ones\",\n    },\n    model: { type: String, description: \"Entity model name\" },\n    ou: { type: String, description: \"Organizational unit (@ for root)\" },\n    xid: { type: String, description: \"External ID\" },\n  },\n  service: async ({\n    archived,\n    deleted,\n    model,\n    ou,\n    xid,\n  }): Promise<FabricEntity | null> => {\n    const archivedBool = archived as boolean | undefined;\n    const deletedBool = deleted as boolean | undefined;\n    const modelStr = model as string;\n    const ouStr = ou as string;\n    const xidStr = xid as string;\n\n    const suffix = calculateSuffix({ archived: archivedBool, deleted: deletedBool });\n    const keyValue = buildIndexXid(ouStr, modelStr, xidStr) + suffix;\n    const result = await executeQuery<FabricEntity>(INDEX_XID, keyValue, {\n      limit: 1,\n    });\n    return result.items[0] ?? null;\n  },\n});\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sources":["../../../src/client.ts","../../../src/constants.ts","../../../src/keyBuilders.ts","../../../src/entities.ts","../../../src/queries.ts","../../../src/seedExport.ts"],"sourcesContent":["import { DynamoDBClient } from \"@aws-sdk/client-dynamodb\";\nimport { DynamoDBDocumentClient } from \"@aws-sdk/lib-dynamodb\";\nimport { ConfigurationError } from \"@jaypie/errors\";\n\nimport type { DynamoClientConfig } from \"./types.js\";\n\n// Environment variable names\nconst ENV_AWS_REGION = \"AWS_REGION\";\nconst ENV_DYNAMODB_TABLE_NAME = \"DYNAMODB_TABLE_NAME\";\n\n// Defaults\nconst DEFAULT_REGION = \"us-east-1\";\nconst LOCAL_CREDENTIALS = {\n  accessKeyId: \"local\",\n  secretAccessKey: \"local\",\n};\n\n// Module-level state\nlet docClient: DynamoDBDocumentClient | null = null;\nlet tableName: string | null = null;\n\n/**\n * Check if endpoint indicates local development mode\n */\nfunction isLocalEndpoint(endpoint?: string): boolean {\n  if (!endpoint) return false;\n  return endpoint.includes(\"127.0.0.1\") || endpoint.includes(\"localhost\");\n}\n\n/**\n * Initialize the DynamoDB client\n * Must be called once at application startup before using query functions\n *\n * @param config - Client configuration\n */\nexport function initClient(config: DynamoClientConfig = {}): void {\n  const { endpoint } = config;\n  const region =\n    config.region ?? process.env[ENV_AWS_REGION] ?? DEFAULT_REGION;\n\n  // Auto-detect local mode and use dummy credentials\n  const credentials =\n    config.credentials ??\n    (isLocalEndpoint(endpoint) ? LOCAL_CREDENTIALS : undefined);\n\n  const dynamoClient = new DynamoDBClient({\n    ...(credentials && { credentials }),\n    ...(endpoint && { endpoint }),\n    region,\n  });\n\n  docClient = DynamoDBDocumentClient.from(dynamoClient, {\n    marshallOptions: {\n      removeUndefinedValues: true,\n    },\n  });\n\n  tableName = config.tableName ?? process.env[ENV_DYNAMODB_TABLE_NAME] ?? null;\n}\n\n/**\n * Get the initialized DynamoDB Document Client\n * @throws ConfigurationError if client has not been initialized\n */\nexport function getDocClient(): DynamoDBDocumentClient {\n  if (!docClient) {\n    throw new ConfigurationError(\n      \"DynamoDB client not initialized. Call initClient() first.\",\n    );\n  }\n  return docClient;\n}\n\n/**\n * Get the configured table name\n * @throws ConfigurationError if client has not been initialized\n */\nexport function getTableName(): string {\n  if (!tableName) {\n    throw new ConfigurationError(\n      \"DynamoDB client not initialized. Call initClient() first.\",\n    );\n  }\n  return tableName;\n}\n\n/**\n * Check if the client has been initialized\n */\nexport function isInitialized(): boolean {\n  return docClient !== null && tableName !== null;\n}\n\n/**\n * Reset the client state (primarily for testing)\n */\nexport function resetClient(): void {\n  docClient = null;\n  tableName = null;\n}\n","// Primary markers\nexport const APEX = \"@\"; // Root-level marker (DynamoDB prohibits empty strings)\nexport const SEPARATOR = \"#\"; // Composite key separator\n\n// GSI names\nexport const INDEX_ALIAS = \"indexAlias\";\nexport const INDEX_CLASS = \"indexClass\";\nexport const INDEX_OU = \"indexOu\";\nexport const INDEX_TYPE = \"indexType\";\nexport const INDEX_XID = \"indexXid\";\n\n// Index suffixes for soft state\nexport const ARCHIVED_SUFFIX = \"#archived\";\nexport const DELETED_SUFFIX = \"#deleted\";\n","import { APEX, SEPARATOR } from \"./constants.js\";\nimport type { FabricEntity, ParentReference } from \"./types.js\";\n\n/**\n * Build the indexOu key for hierarchical queries\n * @param ou - The organizational unit (APEX or \"{parent.model}#{parent.id}\")\n * @param model - The entity model name\n * @returns Composite key: \"{ou}#{model}\"\n */\nexport function buildIndexOu(ou: string, model: string): string {\n  return `${ou}${SEPARATOR}${model}`;\n}\n\n/**\n * Build the indexAlias key for human-friendly lookups\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param alias - The human-friendly alias\n * @returns Composite key: \"{ou}#{model}#{alias}\"\n */\nexport function buildIndexAlias(\n  ou: string,\n  model: string,\n  alias: string,\n): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${alias}`;\n}\n\n/**\n * Build the indexClass key for category filtering\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param recordClass - The category classification\n * @returns Composite key: \"{ou}#{model}#{class}\"\n */\nexport function buildIndexClass(\n  ou: string,\n  model: string,\n  recordClass: string,\n): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${recordClass}`;\n}\n\n/**\n * Build the indexType key for type filtering\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param type - The type classification\n * @returns Composite key: \"{ou}#{model}#{type}\"\n */\nexport function buildIndexType(\n  ou: string,\n  model: string,\n  type: string,\n): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${type}`;\n}\n\n/**\n * Build the indexXid key for external ID lookups\n * @param ou - The organizational unit\n * @param model - The entity model name\n * @param xid - The external ID\n * @returns Composite key: \"{ou}#{model}#{xid}\"\n */\nexport function buildIndexXid(ou: string, model: string, xid: string): string {\n  return `${ou}${SEPARATOR}${model}${SEPARATOR}${xid}`;\n}\n\n/**\n * Calculate the organizational unit from a parent reference\n * @param parent - Optional parent entity reference\n * @returns APEX (\"@\") if no parent, otherwise \"{parent.model}#{parent.id}\"\n */\nexport function calculateOu(parent?: ParentReference): string {\n  if (!parent) {\n    return APEX;\n  }\n  return `${parent.model}${SEPARATOR}${parent.id}`;\n}\n\n/**\n * Auto-populate GSI index keys on an entity\n * - indexOu is always populated from ou + model\n * - indexAlias is populated only when alias is present\n * - indexClass is populated only when class is present\n * - indexType is populated only when type is present\n * - indexXid is populated only when xid is present\n *\n * @param entity - The entity to populate index keys for\n * @param suffix - Optional suffix to append to all index keys (e.g., \"#deleted\", \"#archived\")\n * @returns The entity with populated index keys\n */\nexport function indexEntity<T extends FabricEntity>(\n  entity: T,\n  suffix: string = \"\",\n): T {\n  const result = { ...entity };\n\n  // indexOu is always set (from ou + model)\n  result.indexOu = buildIndexOu(entity.ou, entity.model) + suffix;\n\n  // Optional indexes - only set when the source field is present\n  if (entity.alias !== undefined) {\n    result.indexAlias =\n      buildIndexAlias(entity.ou, entity.model, entity.alias) + suffix;\n  }\n\n  if (entity.class !== undefined) {\n    result.indexClass =\n      buildIndexClass(entity.ou, entity.model, entity.class) + suffix;\n  }\n\n  if (entity.type !== undefined) {\n    result.indexType =\n      buildIndexType(entity.ou, entity.model, entity.type) + suffix;\n  }\n\n  if (entity.xid !== undefined) {\n    result.indexXid =\n      buildIndexXid(entity.ou, entity.model, entity.xid) + suffix;\n  }\n\n  return result;\n}\n","import { DeleteCommand, GetCommand, PutCommand } from \"@aws-sdk/lib-dynamodb\";\nimport { serviceHandler } from \"@jaypie/vocabulary\";\n\nimport { getDocClient, getTableName } from \"./client.js\";\nimport { ARCHIVED_SUFFIX, DELETED_SUFFIX } from \"./constants.js\";\nimport { indexEntity } from \"./keyBuilders.js\";\nimport type { FabricEntity } from \"./types.js\";\n\n/**\n * Calculate suffix based on entity's archived/deleted state\n */\nfunction calculateEntitySuffix(entity: {\n  archivedAt?: string;\n  deletedAt?: string;\n}): string {\n  const hasArchived = Boolean(entity.archivedAt);\n  const hasDeleted = Boolean(entity.deletedAt);\n\n  if (hasArchived && hasDeleted) {\n    return ARCHIVED_SUFFIX + DELETED_SUFFIX;\n  }\n  if (hasArchived) {\n    return ARCHIVED_SUFFIX;\n  }\n  if (hasDeleted) {\n    return DELETED_SUFFIX;\n  }\n  return \"\";\n}\n\n/**\n * Get a single entity by primary key\n */\nexport const getEntity = serviceHandler({\n  alias: \"getEntity\",\n  description: \"Get a single entity by primary key\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<FabricEntity | null> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    const command = new GetCommand({\n      Key: { id, model },\n      TableName: tableName,\n    });\n\n    const response = await docClient.send(command);\n    return (response.Item as FabricEntity) ?? null;\n  },\n});\n\n/**\n * Put (create or replace) an entity\n * Auto-populates GSI index keys via indexEntity\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex FabricEntity objects that can't be coerced by vocabulary's type system.\n */\nexport async function putEntity({\n  entity,\n}: {\n  entity: FabricEntity;\n}): Promise<FabricEntity> {\n  const docClient = getDocClient();\n  const tableName = getTableName();\n\n  // Auto-populate index keys\n  const indexedEntity = indexEntity(entity);\n\n  const command = new PutCommand({\n    Item: indexedEntity,\n    TableName: tableName,\n  });\n\n  await docClient.send(command);\n  return indexedEntity;\n}\n\n/**\n * Update an existing entity\n * Auto-populates GSI index keys and sets updatedAt\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex FabricEntity objects that can't be coerced by vocabulary's type system.\n */\nexport async function updateEntity({\n  entity,\n}: {\n  entity: FabricEntity;\n}): Promise<FabricEntity> {\n  const docClient = getDocClient();\n  const tableName = getTableName();\n\n  // Update timestamp and re-index\n  const updatedEntity = indexEntity({\n    ...entity,\n    updatedAt: new Date().toISOString(),\n  });\n\n  const command = new PutCommand({\n    Item: updatedEntity,\n    TableName: tableName,\n  });\n\n  await docClient.send(command);\n  return updatedEntity;\n}\n\n/**\n * Soft delete an entity by setting deletedAt timestamp\n * Re-indexes with appropriate suffix based on archived/deleted state\n */\nexport const deleteEntity = serviceHandler({\n  alias: \"deleteEntity\",\n  description: \"Soft delete an entity (sets deletedAt timestamp)\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<boolean> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    // Fetch the current entity\n    const existing = await getEntity({ id, model });\n    if (!existing) {\n      return false;\n    }\n\n    const now = new Date().toISOString();\n\n    // Build updated entity with deletedAt\n    const updatedEntity = {\n      ...existing,\n      deletedAt: now,\n      updatedAt: now,\n    };\n\n    // Calculate suffix based on combined state (may already be archived)\n    const suffix = calculateEntitySuffix(updatedEntity);\n    const deletedEntity = indexEntity(updatedEntity, suffix);\n\n    const command = new PutCommand({\n      Item: deletedEntity,\n      TableName: tableName,\n    });\n\n    await docClient.send(command);\n    return true;\n  },\n});\n\n/**\n * Archive an entity by setting archivedAt timestamp\n * Re-indexes with appropriate suffix based on archived/deleted state\n */\nexport const archiveEntity = serviceHandler({\n  alias: \"archiveEntity\",\n  description: \"Archive an entity (sets archivedAt timestamp)\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<boolean> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    // Fetch the current entity\n    const existing = await getEntity({ id, model });\n    if (!existing) {\n      return false;\n    }\n\n    const now = new Date().toISOString();\n\n    // Build updated entity with archivedAt\n    const updatedEntity = {\n      ...existing,\n      archivedAt: now,\n      updatedAt: now,\n    };\n\n    // Calculate suffix based on combined state (may already be deleted)\n    const suffix = calculateEntitySuffix(updatedEntity);\n    const archivedEntity = indexEntity(updatedEntity, suffix);\n\n    const command = new PutCommand({\n      Item: archivedEntity,\n      TableName: tableName,\n    });\n\n    await docClient.send(command);\n    return true;\n  },\n});\n\n/**\n * Hard delete an entity (permanently removes from table)\n * Use with caution - prefer deleteEntity for soft delete\n */\nexport const destroyEntity = serviceHandler({\n  alias: \"destroyEntity\",\n  description: \"Hard delete an entity (permanently removes from table)\",\n  input: {\n    id: { type: String, description: \"Entity ID (sort key)\" },\n    model: { type: String, description: \"Entity model (partition key)\" },\n  },\n  service: async ({ id, model }): Promise<boolean> => {\n    const docClient = getDocClient();\n    const tableName = getTableName();\n\n    const command = new DeleteCommand({\n      Key: { id, model },\n      TableName: tableName,\n    });\n\n    await docClient.send(command);\n    return true;\n  },\n});\n","import { QueryCommand } from \"@aws-sdk/lib-dynamodb\";\nimport { serviceHandler } from \"@jaypie/vocabulary\";\n\nimport { getDocClient, getTableName } from \"./client.js\";\nimport {\n  ARCHIVED_SUFFIX,\n  DELETED_SUFFIX,\n  INDEX_ALIAS,\n  INDEX_CLASS,\n  INDEX_OU,\n  INDEX_TYPE,\n  INDEX_XID,\n} from \"./constants.js\";\nimport {\n  buildIndexAlias,\n  buildIndexClass,\n  buildIndexOu,\n  buildIndexType,\n  buildIndexXid,\n} from \"./keyBuilders.js\";\nimport type { BaseQueryOptions, FabricEntity, QueryResult } from \"./types.js\";\n\n/**\n * Calculate the suffix based on archived/deleted flags\n * When both are true, returns combined suffix (archived first, alphabetically)\n */\nfunction calculateSuffix({\n  archived,\n  deleted,\n}: {\n  archived?: boolean;\n  deleted?: boolean;\n}): string {\n  if (archived && deleted) {\n    return ARCHIVED_SUFFIX + DELETED_SUFFIX;\n  }\n  if (archived) {\n    return ARCHIVED_SUFFIX;\n  }\n  if (deleted) {\n    return DELETED_SUFFIX;\n  }\n  return \"\";\n}\n\n/**\n * Execute a GSI query with common options\n */\nasync function executeQuery<T extends FabricEntity>(\n  indexName: string,\n  keyValue: string,\n  options: BaseQueryOptions = {},\n): Promise<QueryResult<T>> {\n  const { ascending = false, limit, startKey } = options;\n\n  const docClient = getDocClient();\n  const tableName = getTableName();\n\n  const command = new QueryCommand({\n    ExclusiveStartKey: startKey as Record<string, unknown> | undefined,\n    ExpressionAttributeNames: {\n      \"#pk\": indexName,\n    },\n    ExpressionAttributeValues: {\n      \":pkValue\": keyValue,\n    },\n    IndexName: indexName,\n    KeyConditionExpression: \"#pk = :pkValue\",\n    ...(limit && { Limit: limit }),\n    ScanIndexForward: ascending,\n    TableName: tableName,\n  });\n\n  const response = await docClient.send(command);\n\n  return {\n    items: (response.Items ?? []) as T[],\n    lastEvaluatedKey: response.LastEvaluatedKey,\n  };\n}\n\n/**\n * Query parameters for queryByOu\n */\ninterface QueryByOuParams extends BaseQueryOptions {\n  model: string;\n  ou: string;\n}\n\n/**\n * Query entities by organizational unit (parent hierarchy)\n * Uses indexOu GSI\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex startKey objects that can't be coerced by vocabulary's type system.\n */\nexport async function queryByOu({\n  archived = false,\n  ascending = false,\n  deleted = false,\n  limit,\n  model,\n  ou,\n  startKey,\n}: QueryByOuParams): Promise<QueryResult<FabricEntity>> {\n  const suffix = calculateSuffix({ archived, deleted });\n  const keyValue = buildIndexOu(ou, model) + suffix;\n  return executeQuery<FabricEntity>(INDEX_OU, keyValue, {\n    ascending,\n    limit,\n    startKey,\n  });\n}\n\n/**\n * Query a single entity by human-friendly alias\n * Uses indexAlias GSI\n */\nexport const queryByAlias = serviceHandler({\n  alias: \"queryByAlias\",\n  description: \"Query a single entity by human-friendly alias\",\n  input: {\n    alias: { type: String, description: \"Human-friendly alias\" },\n    archived: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query archived entities instead of active ones\",\n    },\n    deleted: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query deleted entities instead of active ones\",\n    },\n    model: { type: String, description: \"Entity model name\" },\n    ou: { type: String, description: \"Organizational unit (@ for root)\" },\n  },\n  service: async ({\n    alias,\n    archived,\n    deleted,\n    model,\n    ou,\n  }): Promise<FabricEntity | null> => {\n    const aliasStr = alias as string;\n    const archivedBool = archived as boolean | undefined;\n    const deletedBool = deleted as boolean | undefined;\n    const modelStr = model as string;\n    const ouStr = ou as string;\n\n    const suffix = calculateSuffix({ archived: archivedBool, deleted: deletedBool });\n    const keyValue = buildIndexAlias(ouStr, modelStr, aliasStr) + suffix;\n    const result = await executeQuery<FabricEntity>(INDEX_ALIAS, keyValue, {\n      limit: 1,\n    });\n    return result.items[0] ?? null;\n  },\n});\n\n/**\n * Query parameters for queryByClass\n */\ninterface QueryByClassParams extends BaseQueryOptions {\n  model: string;\n  ou: string;\n  recordClass: string;\n}\n\n/**\n * Query entities by category classification\n * Uses indexClass GSI\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex startKey objects that can't be coerced by vocabulary's type system.\n */\nexport async function queryByClass({\n  archived = false,\n  ascending = false,\n  deleted = false,\n  limit,\n  model,\n  ou,\n  recordClass,\n  startKey,\n}: QueryByClassParams): Promise<QueryResult<FabricEntity>> {\n  const suffix = calculateSuffix({ archived, deleted });\n  const keyValue = buildIndexClass(ou, model, recordClass) + suffix;\n  return executeQuery<FabricEntity>(INDEX_CLASS, keyValue, {\n    ascending,\n    limit,\n    startKey,\n  });\n}\n\n/**\n * Query parameters for queryByType\n */\ninterface QueryByTypeParams extends BaseQueryOptions {\n  model: string;\n  ou: string;\n  type: string;\n}\n\n/**\n * Query entities by type classification\n * Uses indexType GSI\n *\n * Note: This is a regular async function (not serviceHandler) because it accepts\n * complex startKey objects that can't be coerced by vocabulary's type system.\n */\nexport async function queryByType({\n  archived = false,\n  ascending = false,\n  deleted = false,\n  limit,\n  model,\n  ou,\n  startKey,\n  type,\n}: QueryByTypeParams): Promise<QueryResult<FabricEntity>> {\n  const suffix = calculateSuffix({ archived, deleted });\n  const keyValue = buildIndexType(ou, model, type) + suffix;\n  return executeQuery<FabricEntity>(INDEX_TYPE, keyValue, {\n    ascending,\n    limit,\n    startKey,\n  });\n}\n\n/**\n * Query a single entity by external ID\n * Uses indexXid GSI\n */\nexport const queryByXid = serviceHandler({\n  alias: \"queryByXid\",\n  description: \"Query a single entity by external ID\",\n  input: {\n    archived: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query archived entities instead of active ones\",\n    },\n    deleted: {\n      type: Boolean,\n      default: false,\n      required: false,\n      description: \"Query deleted entities instead of active ones\",\n    },\n    model: { type: String, description: \"Entity model name\" },\n    ou: { type: String, description: \"Organizational unit (@ for root)\" },\n    xid: { type: String, description: \"External ID\" },\n  },\n  service: async ({\n    archived,\n    deleted,\n    model,\n    ou,\n    xid,\n  }): Promise<FabricEntity | null> => {\n    const archivedBool = archived as boolean | undefined;\n    const deletedBool = deleted as boolean | undefined;\n    const modelStr = model as string;\n    const ouStr = ou as string;\n    const xidStr = xid as string;\n\n    const suffix = calculateSuffix({ archived: archivedBool, deleted: deletedBool });\n    const keyValue = buildIndexXid(ouStr, modelStr, xidStr) + suffix;\n    const result = await executeQuery<FabricEntity>(INDEX_XID, keyValue, {\n      limit: 1,\n    });\n    return result.items[0] ?? null;\n  },\n});\n","import { putEntity } from \"./entities.js\";\nimport { queryByAlias, queryByOu } from \"./queries.js\";\nimport type { FabricEntity } from \"./types.js\";\n\n/**\n * Result of a seed operation\n */\nexport interface SeedResult {\n  /** Aliases of entities that were created */\n  created: string[];\n  /** Error details for failed seed operations */\n  errors: Array<{ alias: string; error: string }>;\n  /** Aliases of entities that were skipped (already exist) */\n  skipped: string[];\n}\n\n/**\n * Options for seed operations\n */\nexport interface SeedOptions {\n  /** Preview without writing (default: false) */\n  dryRun?: boolean;\n  /** Overwrite existing entities (default: false) */\n  replace?: boolean;\n}\n\n/**\n * Result of an export operation\n */\nexport interface ExportResult<T extends FabricEntity = FabricEntity> {\n  /** Number of entities exported */\n  count: number;\n  /** Exported entities */\n  entities: T[];\n}\n\n/**\n * Seed a single entity if it doesn't already exist\n *\n * @param entity - Partial entity with at least alias, model, and ou\n * @returns true if entity was created, false if it already exists\n */\nexport async function seedEntityIfNotExists<T extends Partial<FabricEntity>>(\n  entity: T,\n): Promise<boolean> {\n  if (!entity.alias || !entity.model || !entity.ou) {\n    throw new Error(\n      \"Entity must have alias, model, and ou to check existence\",\n    );\n  }\n\n  // Check if entity already exists\n  const existing = await queryByAlias({\n    alias: entity.alias,\n    model: entity.model,\n    ou: entity.ou,\n  });\n\n  if (existing) {\n    return false;\n  }\n\n  // Generate required fields if missing\n  const now = new Date().toISOString();\n  const completeEntity: FabricEntity = {\n    createdAt: entity.createdAt ?? now,\n    id: entity.id ?? crypto.randomUUID(),\n    model: entity.model,\n    name: entity.name ?? entity.alias,\n    ou: entity.ou,\n    sequence: entity.sequence ?? Date.now(),\n    updatedAt: entity.updatedAt ?? now,\n    ...entity,\n  } as FabricEntity;\n\n  await putEntity({ entity: completeEntity });\n  return true;\n}\n\n/**\n * Seed multiple entities (idempotent)\n *\n * - Checks existence by alias (via queryByAlias) before creating\n * - Auto-generates id (UUID), createdAt, updatedAt if missing\n * - Skip existing unless replace: true\n * - Returns counts of created/skipped/errors\n *\n * @param entities - Array of partial entities to seed\n * @param options - Seed options\n * @returns Result with created, skipped, and errors arrays\n */\nexport async function seedEntities<T extends Partial<FabricEntity>>(\n  entities: T[],\n  options: SeedOptions = {},\n): Promise<SeedResult> {\n  const { dryRun = false, replace = false } = options;\n  const result: SeedResult = {\n    created: [],\n    errors: [],\n    skipped: [],\n  };\n\n  for (const entity of entities) {\n    const alias = entity.alias ?? entity.name ?? \"unknown\";\n\n    try {\n      if (!entity.model || !entity.ou) {\n        throw new Error(\"Entity must have model and ou\");\n      }\n\n      // For entities with alias, check existence\n      if (entity.alias) {\n        const existing = await queryByAlias({\n          alias: entity.alias,\n          model: entity.model,\n          ou: entity.ou,\n        });\n\n        if (existing && !replace) {\n          result.skipped.push(alias);\n          continue;\n        }\n\n        // If replacing, use existing ID to update rather than create new\n        if (existing && replace) {\n          entity.id = existing.id;\n        }\n      }\n\n      if (dryRun) {\n        result.created.push(alias);\n        continue;\n      }\n\n      // Generate required fields if missing\n      const now = new Date().toISOString();\n      const completeEntity: FabricEntity = {\n        createdAt: entity.createdAt ?? now,\n        id: entity.id ?? crypto.randomUUID(),\n        model: entity.model,\n        name: entity.name ?? entity.alias ?? \"Unnamed\",\n        ou: entity.ou,\n        sequence: entity.sequence ?? Date.now(),\n        updatedAt: entity.updatedAt ?? now,\n        ...entity,\n      } as FabricEntity;\n\n      await putEntity({ entity: completeEntity });\n      result.created.push(alias);\n    } catch (error) {\n      const errorMessage =\n        error instanceof Error ? error.message : String(error);\n      result.errors.push({ alias, error: errorMessage });\n    }\n  }\n\n  return result;\n}\n\n/**\n * Export entities by model and organizational unit\n *\n * - Paginates through all matching entities via queryByOu\n * - Returns entities sorted by sequence (ascending)\n *\n * @param model - The entity model name\n * @param ou - The organizational unit\n * @param limit - Optional maximum number of entities to export\n * @returns Export result with entities and count\n */\nexport async function exportEntities<T extends FabricEntity>(\n  model: string,\n  ou: string,\n  limit?: number,\n): Promise<ExportResult<T>> {\n  const entities: T[] = [];\n  let startKey: Record<string, unknown> | undefined;\n  let remaining = limit;\n\n  do {\n    const batchLimit =\n      remaining !== undefined ? Math.min(remaining, 100) : undefined;\n\n    const { items, lastEvaluatedKey } = await queryByOu({\n      ascending: true,\n      limit: batchLimit,\n      model,\n      ou,\n      startKey,\n    });\n\n    entities.push(...(items as T[]));\n    startKey = lastEvaluatedKey;\n\n    if (remaining !== undefined) {\n      remaining -= items.length;\n    }\n  } while (startKey && (remaining === undefined || remaining > 0));\n\n  return {\n    count: entities.length,\n    entities,\n  };\n}\n\n/**\n * Export entities as a JSON string\n *\n * @param model - The entity model name\n * @param ou - The organizational unit\n * @param pretty - Format JSON with indentation (default: true)\n * @returns JSON string of exported entities\n */\nexport async function exportEntitiesToJson(\n  model: string,\n  ou: string,\n  pretty: boolean = true,\n): Promise<string> {\n  const { entities } = await exportEntities(model, ou);\n  return pretty ? JSON.stringify(entities, null, 2) : JSON.stringify(entities);\n}\n"],"names":[],"mappings":";;;;;AAMA;AACA,MAAM,cAAc,GAAG,YAAY;AACnC,MAAM,uBAAuB,GAAG,qBAAqB;AAErD;AACA,MAAM,cAAc,GAAG,WAAW;AAClC,MAAM,iBAAiB,GAAG;AACxB,IAAA,WAAW,EAAE,OAAO;AACpB,IAAA,eAAe,EAAE,OAAO;CACzB;AAED;AACA,IAAI,SAAS,GAAkC,IAAI;AACnD,IAAI,SAAS,GAAkB,IAAI;AAEnC;;AAEG;AACH,SAAS,eAAe,CAAC,QAAiB,EAAA;AACxC,IAAA,IAAI,CAAC,QAAQ;AAAE,QAAA,OAAO,KAAK;AAC3B,IAAA,OAAO,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,WAAW,CAAC;AACzE;AAEA;;;;;AAKG;AACG,SAAU,UAAU,CAAC,MAAA,GAA6B,EAAE,EAAA;AACxD,IAAA,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM;AAC3B,IAAA,MAAM,MAAM,GACV,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,cAAc;;AAGhE,IAAA,MAAM,WAAW,GACf,MAAM,CAAC,WAAW;AAClB,SAAC,eAAe,CAAC,QAAQ,CAAC,GAAG,iBAAiB,GAAG,SAAS,CAAC;AAE7D,IAAA,MAAM,YAAY,GAAG,IAAI,cAAc,CAAC;AACtC,QAAA,IAAI,WAAW,IAAI,EAAE,WAAW,EAAE,CAAC;AACnC,QAAA,IAAI,QAAQ,IAAI,EAAE,QAAQ,EAAE,CAAC;QAC7B,MAAM;AACP,KAAA,CAAC;AAEF,IAAA,SAAS,GAAG,sBAAsB,CAAC,IAAI,CAAC,YAAY,EAAE;AACpD,QAAA,eAAe,EAAE;AACf,YAAA,qBAAqB,EAAE,IAAI;AAC5B,SAAA;AACF,KAAA,CAAC;AAEF,IAAA,SAAS,GAAG,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,uBAAuB,CAAC,IAAI,IAAI;AAC9E;AAEA;;;AAGG;SACa,YAAY,GAAA;IAC1B,IAAI,CAAC,SAAS,EAAE;AACd,QAAA,MAAM,IAAI,kBAAkB,CAC1B,2DAA2D,CAC5D;IACH;AACA,IAAA,OAAO,SAAS;AAClB;AAEA;;;AAGG;SACa,YAAY,GAAA;IAC1B,IAAI,CAAC,SAAS,EAAE;AACd,QAAA,MAAM,IAAI,kBAAkB,CAC1B,2DAA2D,CAC5D;IACH;AACA,IAAA,OAAO,SAAS;AAClB;AAEA;;AAEG;SACa,aAAa,GAAA;AAC3B,IAAA,OAAO,SAAS,KAAK,IAAI,IAAI,SAAS,KAAK,IAAI;AACjD;AAEA;;AAEG;SACa,WAAW,GAAA;IACzB,SAAS,GAAG,IAAI;IAChB,SAAS,GAAG,IAAI;AAClB;;ACnGA;AACO,MAAM,IAAI,GAAG,IAAI;AACjB,MAAM,SAAS,GAAG,IAAI;AAE7B;AACO,MAAM,WAAW,GAAG;AACpB,MAAM,WAAW,GAAG;AACpB,MAAM,QAAQ,GAAG;AACjB,MAAM,UAAU,GAAG;AACnB,MAAM,SAAS,GAAG;AAEzB;AACO,MAAM,eAAe,GAAG;AACxB,MAAM,cAAc,GAAG;;ACV9B;;;;;AAKG;AACG,SAAU,YAAY,CAAC,EAAU,EAAE,KAAa,EAAA;AACpD,IAAA,OAAO,GAAG,EAAE,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,EAAE;AACpC;AAEA;;;;;;AAMG;SACa,eAAe,CAC7B,EAAU,EACV,KAAa,EACb,KAAa,EAAA;IAEb,OAAO,CAAA,EAAG,EAAE,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,CAAA,CAAE;AACxD;AAEA;;;;;;AAMG;SACa,eAAe,CAC7B,EAAU,EACV,KAAa,EACb,WAAmB,EAAA;IAEnB,OAAO,CAAA,EAAG,EAAE,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,CAAA,EAAG,SAAS,CAAA,EAAG,WAAW,CAAA,CAAE;AAC9D;AAEA;;;;;;AAMG;SACa,cAAc,CAC5B,EAAU,EACV,KAAa,EACb,IAAY,EAAA;IAEZ,OAAO,CAAA,EAAG,EAAE,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,CAAA,EAAG,SAAS,CAAA,EAAG,IAAI,CAAA,CAAE;AACvD;AAEA;;;;;;AAMG;SACa,aAAa,CAAC,EAAU,EAAE,KAAa,EAAE,GAAW,EAAA;IAClE,OAAO,CAAA,EAAG,EAAE,CAAA,EAAG,SAAS,CAAA,EAAG,KAAK,CAAA,EAAG,SAAS,CAAA,EAAG,GAAG,CAAA,CAAE;AACtD;AAEA;;;;AAIG;AACG,SAAU,WAAW,CAAC,MAAwB,EAAA;IAClD,IAAI,CAAC,MAAM,EAAE;AACX,QAAA,OAAO,IAAI;IACb;IACA,OAAO,CAAA,EAAG,MAAM,CAAC,KAAK,CAAA,EAAG,SAAS,CAAA,EAAG,MAAM,CAAC,EAAE,CAAA,CAAE;AAClD;AAEA;;;;;;;;;;;AAWG;SACa,WAAW,CACzB,MAAS,EACT,SAAiB,EAAE,EAAA;AAEnB,IAAA,MAAM,MAAM,GAAG,EAAE,GAAG,MAAM,EAAE;;AAG5B,IAAA,MAAM,CAAC,OAAO,GAAG,YAAY,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM;;AAG/D,IAAA,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE;AAC9B,QAAA,MAAM,CAAC,UAAU;AACf,YAAA,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM;IACnE;AAEA,IAAA,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS,EAAE;AAC9B,QAAA,MAAM,CAAC,UAAU;AACf,YAAA,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,MAAM;IACnE;AAEA,IAAA,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE;AAC7B,QAAA,MAAM,CAAC,SAAS;AACd,YAAA,cAAc,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM;IACjE;AAEA,IAAA,IAAI,MAAM,CAAC,GAAG,KAAK,SAAS,EAAE;AAC5B,QAAA,MAAM,CAAC,QAAQ;AACb,YAAA,aAAa,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM;IAC/D;AAEA,IAAA,OAAO,MAAM;AACf;;ACpHA;;AAEG;AACH,SAAS,qBAAqB,CAAC,MAG9B,EAAA;IACC,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC;IAC9C,MAAM,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC;AAE5C,IAAA,IAAI,WAAW,IAAI,UAAU,EAAE;QAC7B,OAAO,eAAe,GAAG,cAAc;IACzC;IACA,IAAI,WAAW,EAAE;AACf,QAAA,OAAO,eAAe;IACxB;IACA,IAAI,UAAU,EAAE;AACd,QAAA,OAAO,cAAc;IACvB;AACA,IAAA,OAAO,EAAE;AACX;AAEA;;AAEG;AACI,MAAM,SAAS,GAAG,cAAc,CAAC;AACtC,IAAA,KAAK,EAAE,WAAW;AAClB,IAAA,WAAW,EAAE,oCAAoC;AACjD,IAAA,KAAK,EAAE;QACL,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACzD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B,EAAE;AACrE,KAAA;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAkC;AAC7D,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAEhC,QAAA,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;AAC7B,YAAA,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;AAClB,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;QAEF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC9C,QAAA,OAAQ,QAAQ,CAAC,IAAqB,IAAI,IAAI;IAChD,CAAC;AACF,CAAA;AAED;;;;;;AAMG;AACI,eAAe,SAAS,CAAC,EAC9B,MAAM,GAGP,EAAA;AACC,IAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,IAAA,MAAM,SAAS,GAAG,YAAY,EAAE;;AAGhC,IAAA,MAAM,aAAa,GAAG,WAAW,CAAC,MAAM,CAAC;AAEzC,IAAA,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;AAC7B,QAAA,IAAI,EAAE,aAAa;AACnB,QAAA,SAAS,EAAE,SAAS;AACrB,KAAA,CAAC;AAEF,IAAA,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7B,IAAA,OAAO,aAAa;AACtB;AAEA;;;;;;AAMG;AACI,eAAe,YAAY,CAAC,EACjC,MAAM,GAGP,EAAA;AACC,IAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,IAAA,MAAM,SAAS,GAAG,YAAY,EAAE;;IAGhC,MAAM,aAAa,GAAG,WAAW,CAAC;AAChC,QAAA,GAAG,MAAM;AACT,QAAA,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;AACpC,KAAA,CAAC;AAEF,IAAA,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;AAC7B,QAAA,IAAI,EAAE,aAAa;AACnB,QAAA,SAAS,EAAE,SAAS;AACrB,KAAA,CAAC;AAEF,IAAA,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7B,IAAA,OAAO,aAAa;AACtB;AAEA;;;AAGG;AACI,MAAM,YAAY,GAAG,cAAc,CAAC;AACzC,IAAA,KAAK,EAAE,cAAc;AACrB,IAAA,WAAW,EAAE,kDAAkD;AAC/D,IAAA,KAAK,EAAE;QACL,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACzD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B,EAAE;AACrE,KAAA;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAsB;AACjD,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;;QAGhC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,EAAE;AACb,YAAA,OAAO,KAAK;QACd;QAEA,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;AAGpC,QAAA,MAAM,aAAa,GAAG;AACpB,YAAA,GAAG,QAAQ;AACX,YAAA,SAAS,EAAE,GAAG;AACd,YAAA,SAAS,EAAE,GAAG;SACf;;AAGD,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC;QACnD,MAAM,aAAa,GAAG,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC;AAExD,QAAA,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;AAC7B,YAAA,IAAI,EAAE,aAAa;AACnB,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;AAEF,QAAA,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7B,QAAA,OAAO,IAAI;IACb,CAAC;AACF,CAAA;AAED;;;AAGG;AACI,MAAM,aAAa,GAAG,cAAc,CAAC;AAC1C,IAAA,KAAK,EAAE,eAAe;AACtB,IAAA,WAAW,EAAE,+CAA+C;AAC5D,IAAA,KAAK,EAAE;QACL,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACzD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B,EAAE;AACrE,KAAA;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAsB;AACjD,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;;QAGhC,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC;QAC/C,IAAI,CAAC,QAAQ,EAAE;AACb,YAAA,OAAO,KAAK;QACd;QAEA,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;;AAGpC,QAAA,MAAM,aAAa,GAAG;AACpB,YAAA,GAAG,QAAQ;AACX,YAAA,UAAU,EAAE,GAAG;AACf,YAAA,SAAS,EAAE,GAAG;SACf;;AAGD,QAAA,MAAM,MAAM,GAAG,qBAAqB,CAAC,aAAa,CAAC;QACnD,MAAM,cAAc,GAAG,WAAW,CAAC,aAAa,EAAE,MAAM,CAAC;AAEzD,QAAA,MAAM,OAAO,GAAG,IAAI,UAAU,CAAC;AAC7B,YAAA,IAAI,EAAE,cAAc;AACpB,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;AAEF,QAAA,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7B,QAAA,OAAO,IAAI;IACb,CAAC;AACF,CAAA;AAED;;;AAGG;AACI,MAAM,aAAa,GAAG,cAAc,CAAC;AAC1C,IAAA,KAAK,EAAE,eAAe;AACtB,IAAA,WAAW,EAAE,wDAAwD;AACrE,IAAA,KAAK,EAAE;QACL,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE;QACzD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,8BAA8B,EAAE;AACrE,KAAA;IACD,OAAO,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAsB;AACjD,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,QAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAEhC,QAAA,MAAM,OAAO,GAAG,IAAI,aAAa,CAAC;AAChC,YAAA,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE;AAClB,YAAA,SAAS,EAAE,SAAS;AACrB,SAAA,CAAC;AAEF,QAAA,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;AAC7B,QAAA,OAAO,IAAI;IACb,CAAC;AACF,CAAA;;ACxMD;;;AAGG;AACH,SAAS,eAAe,CAAC,EACvB,QAAQ,EACR,OAAO,GAIR,EAAA;AACC,IAAA,IAAI,QAAQ,IAAI,OAAO,EAAE;QACvB,OAAO,eAAe,GAAG,cAAc;IACzC;IACA,IAAI,QAAQ,EAAE;AACZ,QAAA,OAAO,eAAe;IACxB;IACA,IAAI,OAAO,EAAE;AACX,QAAA,OAAO,cAAc;IACvB;AACA,IAAA,OAAO,EAAE;AACX;AAEA;;AAEG;AACH,eAAe,YAAY,CACzB,SAAiB,EACjB,QAAgB,EAChB,UAA4B,EAAE,EAAA;IAE9B,MAAM,EAAE,SAAS,GAAG,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,OAAO;AAEtD,IAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAChC,IAAA,MAAM,SAAS,GAAG,YAAY,EAAE;AAEhC,IAAA,MAAM,OAAO,GAAG,IAAI,YAAY,CAAC;AAC/B,QAAA,iBAAiB,EAAE,QAA+C;AAClE,QAAA,wBAAwB,EAAE;AACxB,YAAA,KAAK,EAAE,SAAS;AACjB,SAAA;AACD,QAAA,yBAAyB,EAAE;AACzB,YAAA,UAAU,EAAE,QAAQ;AACrB,SAAA;AACD,QAAA,SAAS,EAAE,SAAS;AACpB,QAAA,sBAAsB,EAAE,gBAAgB;QACxC,IAAI,KAAK,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AAC9B,QAAA,gBAAgB,EAAE,SAAS;AAC3B,QAAA,SAAS,EAAE,SAAS;AACrB,KAAA,CAAC;IAEF,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC;IAE9C,OAAO;AACL,QAAA,KAAK,GAAG,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAQ;QACpC,gBAAgB,EAAE,QAAQ,CAAC,gBAAgB;KAC5C;AACH;AAUA;;;;;;AAMG;AACI,eAAe,SAAS,CAAC,EAC9B,QAAQ,GAAG,KAAK,EAChB,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,KAAK,EACf,KAAK,EACL,KAAK,EACL,EAAE,EACF,QAAQ,GACQ,EAAA;IAChB,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;IACrD,MAAM,QAAQ,GAAG,YAAY,CAAC,EAAE,EAAE,KAAK,CAAC,GAAG,MAAM;AACjD,IAAA,OAAO,YAAY,CAAe,QAAQ,EAAE,QAAQ,EAAE;QACpD,SAAS;QACT,KAAK;QACL,QAAQ;AACT,KAAA,CAAC;AACJ;AAEA;;;AAGG;AACI,MAAM,YAAY,GAAG,cAAc,CAAC;AACzC,IAAA,KAAK,EAAE,cAAc;AACrB,IAAA,WAAW,EAAE,+CAA+C;AAC5D,IAAA,KAAK,EAAE;QACL,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,sBAAsB,EAAE;AAC5D,QAAA,QAAQ,EAAE;AACR,YAAA,IAAI,EAAE,OAAO;AACb,YAAA,OAAO,EAAE,KAAK;AACd,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,WAAW,EAAE,gDAAgD;AAC9D,SAAA;AACD,QAAA,OAAO,EAAE;AACP,YAAA,IAAI,EAAE,OAAO;AACb,YAAA,OAAO,EAAE,KAAK;AACd,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,WAAW,EAAE,+CAA+C;AAC7D,SAAA;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACzD,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kCAAkC,EAAE;AACtE,KAAA;AACD,IAAA,OAAO,EAAE,OAAO,EACd,KAAK,EACL,QAAQ,EACR,OAAO,EACP,KAAK,EACL,EAAE,GACH,KAAkC;QACjC,MAAM,QAAQ,GAAG,KAAe;QAChC,MAAM,YAAY,GAAG,QAA+B;QACpD,MAAM,WAAW,GAAG,OAA8B;QAClD,MAAM,QAAQ,GAAG,KAAe;QAChC,MAAM,KAAK,GAAG,EAAY;AAE1B,QAAA,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAChF,QAAA,MAAM,QAAQ,GAAG,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,GAAG,MAAM;QACpE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAe,WAAW,EAAE,QAAQ,EAAE;AACrE,YAAA,KAAK,EAAE,CAAC;AACT,SAAA,CAAC;QACF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI;IAChC,CAAC;AACF,CAAA;AAWD;;;;;;AAMG;AACI,eAAe,YAAY,CAAC,EACjC,QAAQ,GAAG,KAAK,EAChB,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,KAAK,EACf,KAAK,EACL,KAAK,EACL,EAAE,EACF,WAAW,EACX,QAAQ,GACW,EAAA;IACnB,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrD,IAAA,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,EAAE,KAAK,EAAE,WAAW,CAAC,GAAG,MAAM;AACjE,IAAA,OAAO,YAAY,CAAe,WAAW,EAAE,QAAQ,EAAE;QACvD,SAAS;QACT,KAAK;QACL,QAAQ;AACT,KAAA,CAAC;AACJ;AAWA;;;;;;AAMG;AACI,eAAe,WAAW,CAAC,EAChC,QAAQ,GAAG,KAAK,EAChB,SAAS,GAAG,KAAK,EACjB,OAAO,GAAG,KAAK,EACf,KAAK,EACL,KAAK,EACL,EAAE,EACF,QAAQ,EACR,IAAI,GACc,EAAA;IAClB,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,OAAO,EAAE,CAAC;AACrD,IAAA,MAAM,QAAQ,GAAG,cAAc,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,GAAG,MAAM;AACzD,IAAA,OAAO,YAAY,CAAe,UAAU,EAAE,QAAQ,EAAE;QACtD,SAAS;QACT,KAAK;QACL,QAAQ;AACT,KAAA,CAAC;AACJ;AAEA;;;AAGG;AACI,MAAM,UAAU,GAAG,cAAc,CAAC;AACvC,IAAA,KAAK,EAAE,YAAY;AACnB,IAAA,WAAW,EAAE,sCAAsC;AACnD,IAAA,KAAK,EAAE;AACL,QAAA,QAAQ,EAAE;AACR,YAAA,IAAI,EAAE,OAAO;AACb,YAAA,OAAO,EAAE,KAAK;AACd,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,WAAW,EAAE,gDAAgD;AAC9D,SAAA;AACD,QAAA,OAAO,EAAE;AACP,YAAA,IAAI,EAAE,OAAO;AACb,YAAA,OAAO,EAAE,KAAK;AACd,YAAA,QAAQ,EAAE,KAAK;AACf,YAAA,WAAW,EAAE,+CAA+C;AAC7D,SAAA;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,mBAAmB,EAAE;QACzD,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,kCAAkC,EAAE;QACrE,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE;AAClD,KAAA;AACD,IAAA,OAAO,EAAE,OAAO,EACd,QAAQ,EACR,OAAO,EACP,KAAK,EACL,EAAE,EACF,GAAG,GACJ,KAAkC;QACjC,MAAM,YAAY,GAAG,QAA+B;QACpD,MAAM,WAAW,GAAG,OAA8B;QAClD,MAAM,QAAQ,GAAG,KAAe;QAChC,MAAM,KAAK,GAAG,EAAY;QAC1B,MAAM,MAAM,GAAG,GAAa;AAE5B,QAAA,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;AAChF,QAAA,MAAM,QAAQ,GAAG,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,CAAC,GAAG,MAAM;QAChE,MAAM,MAAM,GAAG,MAAM,YAAY,CAAe,SAAS,EAAE,QAAQ,EAAE;AACnE,YAAA,KAAK,EAAE,CAAC;AACT,SAAA,CAAC;QACF,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,IAAI;IAChC,CAAC;AACF,CAAA;;AC9OD;;;;;AAKG;AACI,eAAe,qBAAqB,CACzC,MAAS,EAAA;AAET,IAAA,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE;AAChD,QAAA,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D;IACH;;AAGA,IAAA,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC;QAClC,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,EAAE,EAAE,MAAM,CAAC,EAAE;AACd,KAAA,CAAC;IAEF,IAAI,QAAQ,EAAE;AACZ,QAAA,OAAO,KAAK;IACd;;IAGA,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;AACpC,IAAA,MAAM,cAAc,GAAiB;AACnC,QAAA,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;QAClC,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;QACpC,KAAK,EAAE,MAAM,CAAC,KAAK;AACnB,QAAA,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK;QACjC,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE;AACvC,QAAA,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;AAClC,QAAA,GAAG,MAAM;KACM;IAEjB,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AAC3C,IAAA,OAAO,IAAI;AACb;AAEA;;;;;;;;;;;AAWG;AACI,eAAe,YAAY,CAChC,QAAa,EACb,UAAuB,EAAE,EAAA;IAEzB,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,OAAO;AACnD,IAAA,MAAM,MAAM,GAAe;AACzB,QAAA,OAAO,EAAE,EAAE;AACX,QAAA,MAAM,EAAE,EAAE;AACV,QAAA,OAAO,EAAE,EAAE;KACZ;AAED,IAAA,KAAK,MAAM,MAAM,IAAI,QAAQ,EAAE;QAC7B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,IAAI,SAAS;AAEtD,QAAA,IAAI;YACF,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE;AAC/B,gBAAA,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC;YAClD;;AAGA,YAAA,IAAI,MAAM,CAAC,KAAK,EAAE;AAChB,gBAAA,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC;oBAClC,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,KAAK,EAAE,MAAM,CAAC,KAAK;oBACnB,EAAE,EAAE,MAAM,CAAC,EAAE;AACd,iBAAA,CAAC;AAEF,gBAAA,IAAI,QAAQ,IAAI,CAAC,OAAO,EAAE;AACxB,oBAAA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;oBAC1B;gBACF;;AAGA,gBAAA,IAAI,QAAQ,IAAI,OAAO,EAAE;AACvB,oBAAA,MAAM,CAAC,EAAE,GAAG,QAAQ,CAAC,EAAE;gBACzB;YACF;YAEA,IAAI,MAAM,EAAE;AACV,gBAAA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC1B;YACF;;YAGA,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;AACpC,YAAA,MAAM,cAAc,GAAiB;AACnC,gBAAA,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;gBAClC,EAAE,EAAE,MAAM,CAAC,EAAE,IAAI,MAAM,CAAC,UAAU,EAAE;gBACpC,KAAK,EAAE,MAAM,CAAC,KAAK;gBACnB,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,KAAK,IAAI,SAAS;gBAC9C,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,GAAG,EAAE;AACvC,gBAAA,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,GAAG;AAClC,gBAAA,GAAG,MAAM;aACM;YAEjB,MAAM,SAAS,CAAC,EAAE,MAAM,EAAE,cAAc,EAAE,CAAC;AAC3C,YAAA,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC;QAC5B;QAAE,OAAO,KAAK,EAAE;AACd,YAAA,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,GAAG,KAAK,CAAC,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC;AACxD,YAAA,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC;QACpD;IACF;AAEA,IAAA,OAAO,MAAM;AACf;AAEA;;;;;;;;;;AAUG;AACI,eAAe,cAAc,CAClC,KAAa,EACb,EAAU,EACV,KAAc,EAAA;IAEd,MAAM,QAAQ,GAAQ,EAAE;AACxB,IAAA,IAAI,QAA6C;IACjD,IAAI,SAAS,GAAG,KAAK;AAErB,IAAA,GAAG;QACD,MAAM,UAAU,GACd,SAAS,KAAK,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,GAAG,SAAS;QAEhE,MAAM,EAAE,KAAK,EAAE,gBAAgB,EAAE,GAAG,MAAM,SAAS,CAAC;AAClD,YAAA,SAAS,EAAE,IAAI;AACf,YAAA,KAAK,EAAE,UAAU;YACjB,KAAK;YACL,EAAE;YACF,QAAQ;AACT,SAAA,CAAC;AAEF,QAAA,QAAQ,CAAC,IAAI,CAAC,GAAI,KAAa,CAAC;QAChC,QAAQ,GAAG,gBAAgB;AAE3B,QAAA,IAAI,SAAS,KAAK,SAAS,EAAE;AAC3B,YAAA,SAAS,IAAI,KAAK,CAAC,MAAM;QAC3B;AACF,IAAA,CAAC,QAAQ,QAAQ,KAAK,SAAS,KAAK,SAAS,IAAI,SAAS,GAAG,CAAC,CAAC;IAE/D,OAAO;QACL,KAAK,EAAE,QAAQ,CAAC,MAAM;QACtB,QAAQ;KACT;AACH;AAEA;;;;;;;AAOG;AACI,eAAe,oBAAoB,CACxC,KAAa,EACb,EAAU,EACV,MAAA,GAAkB,IAAI,EAAA;IAEtB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,EAAE,CAAC;IACpD,OAAO,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;AAC9E;;;;"}

package/dist/esm/mcp/index.js

@@ -4,6 +4,10 @@ import { DynamoDBClient, DescribeTableCommand, CreateTableCommand } from '@aws-s
 import { DynamoDBDocumentClient, GetCommand, PutCommand, DeleteCommand, QueryCommand } from '@aws-sdk/lib-dynamodb';
 import { ConfigurationError } from '@jaypie/errors';
 
+// Environment variable names
+const ENV_AWS_REGION = "AWS_REGION";
+const ENV_DYNAMODB_TABLE_NAME = "DYNAMODB_TABLE_NAME";
+// Defaults
 const DEFAULT_REGION$2 = "us-east-1";
 const LOCAL_CREDENTIALS = {
     accessKeyId: "local",
@@ -26,8 +30,9 @@ function isLocalEndpoint(endpoint) {
  *
  * @param config - Client configuration
  */
-function initClient(config) {
-    const { endpoint, region = DEFAULT_REGION$2 } = config;
+function initClient(config = {}) {
+    const { endpoint } = config;
+    const region = config.region ?? process.env[ENV_AWS_REGION] ?? DEFAULT_REGION$2;
     // Auto-detect local mode and use dummy credentials
     const credentials = config.credentials ??
         (isLocalEndpoint(endpoint) ? LOCAL_CREDENTIALS : undefined);
@@ -41,7 +46,7 @@ function initClient(config) {
             removeUndefinedValues: true,
         },
     });
-    tableName = config.tableName;
+    tableName = config.tableName ?? process.env[ENV_DYNAMODB_TABLE_NAME] ?? null;
 }
 /**
  * Get the initialized DynamoDB Document Client