@jaypie/dynamodb 0.4.4 → 0.6.0

package/dist/cjs/constants.d.ts

@@ -1,6 +1 @@
 export { APEX, ARCHIVED_SUFFIX, DELETED_SUFFIX, SEPARATOR, } from "@jaypie/fabric";
-export declare const INDEX_ALIAS = "indexAlias";
-export declare const INDEX_CATEGORY = "indexCategory";
-export declare const INDEX_SCOPE = "indexScope";
-export declare const INDEX_TYPE = "indexType";
-export declare const INDEX_XID = "indexXid";

package/dist/cjs/entities.d.ts

@@ -1,24 +1,19 @@
 import type { StorableEntity } from "./types.js";
 /**
- * Get a single entity by primary key
+ * Get a single entity by primary key (id)
  */
 export declare const getEntity: import("@jaypie/fabric").Service<Record<string, unknown>, StorableEntity | null, StorableEntity | null>;
 /**
- * Put (create or replace) an entity
- * Auto-populates GSI index keys via indexEntity
- *
- * Note: This is a regular async function (not fabricService) because it accepts
- * complex StorableEntity objects that can't be coerced by vocabulary's type system.
+ * Create an entity. Fails the conditional write if `id` already exists,
+ * returning `null` instead of throwing. Use `updateEntity` to overwrite.
+ * `indexEntity` auto-bumps `updatedAt` and backfills `createdAt`.
  */
-export declare function putEntity({ entity, }: {
+export declare function createEntity({ entity, }: {
     entity: StorableEntity;
-}): Promise<StorableEntity>;
+}): Promise<StorableEntity | null>;
 /**
- * Update an existing entity
- * Auto-populates GSI index keys and sets updatedAt
- *
- * Note: This is a regular async function (not fabricService) because it accepts
- * complex StorableEntity objects that can't be coerced by vocabulary's type system.
+ * Update an existing entity.
+ * `indexEntity` auto-bumps `updatedAt` — callers never set it manually.
  */
 export declare function updateEntity({ entity, }: {
     entity: StorableEntity;