captify 0.1.18 → 0.1.19

package/dist/db/schemas/collab-comments.schema.js

@@ -0,0 +1,103 @@
+// ============================================================================
+// Table Name
+// ============================================================================
+export const COLLAB_COMMENTS_TABLE = "captify_core_collab_comments";
+// ============================================================================
+// Key Builders
+// ============================================================================
+/**
+ * Key builders for Comments table.
+ * Returns branded types to ensure type safety.
+ */
+export const collabCommentKeys = {
+    /**
+     * Build partition key: COLLAB_DOC#{documentId}
+     */
+    pk: (documentId) => `COLLAB_DOC#${documentId}`,
+    /**
+     * Build sort key: COMMENT#{commentId}
+     */
+    sk: (commentId) => `COMMENT#${commentId}`,
+};
+// ============================================================================
+// Infrastructure (for table creation/migrations)
+// ============================================================================
+/**
+ * CreateTableCommandInput for AWS SDK.
+ */
+export const collabCommentsTableInput = {
+    TableName: COLLAB_COMMENTS_TABLE,
+    AttributeDefinitions: [
+        { AttributeName: "PK", AttributeType: "S" },
+        { AttributeName: "SK", AttributeType: "S" },
+    ],
+    KeySchema: [
+        { AttributeName: "PK", KeyType: "HASH" },
+        { AttributeName: "SK", KeyType: "RANGE" },
+    ],
+    ProvisionedThroughput: { ReadCapacityUnits: 5, WriteCapacityUnits: 5 },
+};
+// ============================================================================
+// Schema Registry Entry
+// ============================================================================
+import { defineSchemaEntry, } from "../../ontology/schemas/ontology-registry.types";
+/**
+ * Schema entry for the ontology registry.
+ */
+export const schemaEntry = defineSchemaEntry({
+    tableInput: collabCommentsTableInput,
+    displayName: "Document Comments",
+    description: "Inline comments for collaborative documents",
+    entityType: "DocumentComment",
+    entityAttributes: [
+        { name: "id", type: "String", required: true, description: "Comment identifier" },
+        { name: "documentId", type: "String", required: true, description: "Document reference" },
+        { name: "parentId", type: "String", description: "Parent comment for replies" },
+        {
+            name: "anchorStart",
+            type: "Binary",
+            required: true,
+            description: "yjs RelativePosition start",
+        },
+        { name: "anchorEnd", type: "Binary", required: true, description: "yjs RelativePosition end" },
+        { name: "anchorText", type: "String", description: "Cached anchor text" },
+        { name: "content", type: "String", required: true, description: "Comment content" },
+        { name: "authorId", type: "String", required: true, description: "Author user ID" },
+        { name: "authorName", type: "String", required: true, description: "Author display name" },
+        { name: "authorEmail", type: "String", required: true, description: "Author email" },
+        { name: "authorAvatar", type: "String", description: "Author avatar URL" },
+        { name: "status", type: "String", required: true, description: "open|resolved" },
+        { name: "resolvedById", type: "String", description: "Resolver user ID" },
+        { name: "resolvedAt", type: "Number", description: "Resolution timestamp" },
+        { name: "mentions", type: "Array", description: "Mentioned user IDs" },
+        { name: "createdAt", type: "Number", required: true, description: "Creation timestamp" },
+        { name: "updatedAt", type: "Number", required: true, description: "Last update timestamp" },
+    ],
+    relationships: [
+        {
+            targetTable: "captify_core_collab_documents",
+            sourceAttribute: "documentId",
+            targetAttribute: "id",
+            label: "Comment On",
+            confidence: "high",
+            description: "Comment belongs to a document",
+        },
+        {
+            targetTable: "cognito_users",
+            sourceAttribute: "authorId",
+            targetAttribute: "id",
+            label: "Authored By",
+            confidence: "high",
+            description: "Comment authored by a user",
+        },
+        {
+            targetTable: "captify_core_collab_comments",
+            sourceAttribute: "parentId",
+            targetAttribute: "id",
+            label: "Reply To",
+            confidence: "medium",
+            description: "Comment is a reply to another comment",
+        },
+    ],
+});
+//# sourceMappingURL=collab-comments.schema.js.map

package/dist/db/schemas/collab-comments.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-comments.schema.js","sourceRoot":"","sources":["../../../lib/db/schemas/collab-comments.schema.ts"],"names":[],"mappings":"AAmBA,+EAA+E;AAC/E,aAAa;AACb,+EAA+E;AAE/E,MAAM,CAAC,MAAM,qBAAqB,GAAG,8BAA8B,CAAC;AAiEpE,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B;;OAEG;IACH,EAAE,EAAE,CAAC,UAAkB,EAAmB,EAAE,CAAC,cAAc,UAAU,EAAqB;IAE1F;;OAEG;IACH,EAAE,EAAE,CAAC,SAAiB,EAAmB,EAAE,CAAC,WAAW,SAAS,EAAqB;CACtF,CAAC;AAEF,+EAA+E;AAC/E,iDAAiD;AACjD,+EAA+E;AAE/E;;GAEG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAA4B;IAC/D,SAAS,EAAE,qBAAqB;IAChC,oBAAoB,EAAE;QACpB,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE;QAC3C,EAAE,aAAa,EAAE,IAAI,EAAE,aAAa,EAAE,GAAG,EAAE;KAC5C;IACD,SAAS,EAAE;QACT,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;QACxC,EAAE,aAAa,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE;KAC1C;IACD,qBAAqB,EAAE,EAAE,iBAAiB,EAAE,CAAC,EAAE,kBAAkB,EAAE,CAAC,EAAE;CACvE,CAAC;AAEF,+EAA+E;AAC/E,wBAAwB;AACxB,+EAA+E;AAE/E,OAAO,EACL,iBAAiB,GAElB,MAAM,gDAAgD,CAAC;AAExD;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAsB,iBAAiB,CAAC;IAC9D,UAAU,EAAE,wBAAwB;IACpC,WAAW,EAAE,mBAAmB;IAChC,WAAW,EAAE,6CAA6C;IAC1D,UAAU,EAAE,iBAAiB;IAC7B,gBAAgB,EAAE;QAChB,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACjF,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACzF,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,4BAA4B,EAAE;QAC/E;YACE,IAAI,EAAE,aAAa;YACnB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,IAAI;YACd,WAAW,EAAE,4BAA4B;SAC1C;QACD,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,0BAA0B,EAAE;QAC9F,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACzE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,iBAAiB,EAAE;QACnF,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,gBAAgB,EAAE;QACnF,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,qBAAqB,EAAE;QAC1F,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,cAAc,EAAE;QACpF,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,mBAAmB,EAAE;QAC1E,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,eAAe,EAAE;QAChF,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,kBAAkB,EAAE;QACzE,EAAE,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,sBAAsB,EAAE;QAC3E,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACtE,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE;QACxF,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,WAAW,EAAE,uBAAuB,EAAE;KAC5F;IACD,aAAa,EAAE;QACb;YACE,WAAW,EAAE,+BAA+B;YAC5C,eAAe,EAAE,YAAY;YAC7B,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,YAAY;YACnB,UAAU,EAAE,MAAM;YAClB,WAAW,EAAE,+BAA+B;SAC7C;QACD;YACE,WAAW,EAAE,eAAe;YAC5B,eAAe,EAAE,UAAU;YAC3B,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,aAAa;YACpB,UAAU,EAAE,MAAM;YAClB,WAAW,EAAE,4BAA4B;SAC1C;QACD;YACE,WAAW,EAAE,8BAA8B;YAC3C,eAAe,EAAE,UAAU;YAC3B,eAAe,EAAE,IAAI;YACrB,KAAK,EAAE,UAAU;YACjB,UAAU,EAAE,QAAQ;YACpB,WAAW,EAAE,uCAAuC;SACrD;KACF;CACF,CAAC,CAAC"}

package/dist/db/schemas/collab-documents.schema.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Collaborative Documents Table Schema
+ *
+ * Single source of truth for the collab_documents table:
+ * - Document types (Keys + Entity)
+ * - Table schema (for DynamoDB service type safety)
+ * - Key builders
+ * - Infrastructure (CreateTableCommandInput)
+ *
+ * Access Patterns:
+ * 1. Get document by tenant + documentId: Query on PK + SK
+ * 2. List all documents for a tenant: Query on PK
+ * 3. List documents shared with a user: Query on GSI1 (USER#{userId})
+ */
+import type { CreateTableCommandInput } from "@aws-sdk/client-dynamodb";
+import type { TableSchema } from "../../shared/services/dynamodb";
+import type { CollabDocument } from "../../collaboration/collaboration.schemas";
+import type { PartitionKey, SortKey } from "../../shared/shared.schemas";
+export declare const COLLAB_DOCUMENTS_TABLE = "captify_core_collab_documents";
+/** Branded partition key type for Collab Documents table */
+export type CollabDocumentPK = PartitionKey<"CollabDocument">;
+/** Branded sort key type for Collab Documents table */
+export type CollabDocumentSK = SortKey<"CollabDocument">;
+/** Branded GSI1 partition key type */
+export type CollabDocumentGsi1PK = PartitionKey<"CollabDocumentGsi1">;
+/** Branded GSI1 sort key type */
+export type CollabDocumentGsi1SK = SortKey<"CollabDocumentGsi1">;
+/**
+ * DynamoDB key attributes for Collab Documents table.
+ */
+export interface CollabDocumentKeys {
+    /** Partition key: TENANT#{tenantId} */
+    PK: CollabDocumentPK;
+    /** Sort key: COLLAB_DOC#{documentId} */
+    SK: CollabDocumentSK;
+    /** GSI1 partition key: USER#{userId} (for shared-with-me queries) */
+    GSI1_PK?: CollabDocumentGsi1PK;
+    /** GSI1 sort key: COLLAB_DOC#{documentId} */
+    GSI1_SK?: CollabDocumentGsi1SK;
+}
+/**
+ * The complete document stored in DynamoDB for a Collab Document item.
+ *
+ * @example
+ * {
+ *   PK: "TENANT#acme",
+ *   SK: "COLLAB_DOC#550e8400-e29b-41d4-a716-446655440000",
+ *   id: "550e8400-e29b-41d4-a716-446655440000",
+ *   tenantId: "acme",
+ *   title: "Project Proposal",
+ *   content: <Binary>,
+ *   ownerId: "user-123",
+ *   ownerName: "John Doe",
+ *   ownerEmail: "john@example.com",
+ *   status: "active",
+ *   wordCount: 1500,
+ *   createdAt: 1704067200000,
+ *   updatedAt: 1704067200000
+ * }
+ */
+export type CollabDocumentDocument = CollabDocumentKeys & CollabDocument;
+/**
+ * Collab Documents table schema for DynamoDB service type safety.
+ */
+export interface CollabDocumentsTableSchema extends TableSchema<CollabDocumentDocument> {
+    tableName: typeof COLLAB_DOCUMENTS_TABLE;
+    primaryKey: {
+        partition: "PK";
+        sort: "SK";
+    };
+    gsi1?: {
+        indexName: "GSI1";
+        partition: "GSI1_PK";
+        sort: "GSI1_SK";
+    };
+}
+/**
+ * Key builders for Collab Documents table.
+ * Returns branded types to ensure type safety.
+ */
+export declare const collabDocumentKeys: {
+    /**
+     * Build partition key: TENANT#{tenantId}
+     */
+    pk: (tenantId: string) => CollabDocumentPK;
+    /**
+     * Build sort key: COLLAB_DOC#{documentId}
+     */
+    sk: (documentId: string) => CollabDocumentSK;
+    /**
+     * Build GSI1 partition key: USER#{userId}
+     */
+    gsi1Pk: (userId: string) => CollabDocumentGsi1PK;
+    /**
+     * Build GSI1 sort key: COLLAB_DOC#{documentId}
+     */
+    gsi1Sk: (documentId: string) => CollabDocumentGsi1SK;
+};
+/**
+ * CreateTableCommandInput for AWS SDK.
+ */
+export declare const collabDocumentsTableInput: CreateTableCommandInput;
+import { type SchemaEntryConfig } from "../../ontology/schemas/ontology-registry.types";
+/**
+ * Schema entry for the ontology registry.
+ */
+export declare const schemaEntry: SchemaEntryConfig;
+//# sourceMappingURL=collab-documents.schema.d.ts.map

package/dist/db/schemas/collab-documents.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-documents.schema.d.ts","sourceRoot":"","sources":["../../../lib/db/schemas/collab-documents.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAMzE,eAAO,MAAM,sBAAsB,kCAAkC,CAAC;AAMtE,4DAA4D;AAC5D,MAAM,MAAM,gBAAgB,GAAG,YAAY,CAAC,gBAAgB,CAAC,CAAC;AAE9D,uDAAuD;AACvD,MAAM,MAAM,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AAEzD,sCAAsC;AACtC,MAAM,MAAM,oBAAoB,GAAG,YAAY,CAAC,oBAAoB,CAAC,CAAC;AAEtE,iCAAiC;AACjC,MAAM,MAAM,oBAAoB,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAAC;AAMjE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,uCAAuC;IACvC,EAAE,EAAE,gBAAgB,CAAC;IACrB,wCAAwC;IACxC,EAAE,EAAE,gBAAgB,CAAC;IACrB,qEAAqE;IACrE,OAAO,CAAC,EAAE,oBAAoB,CAAC;IAC/B,6CAA6C;IAC7C,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,sBAAsB,GAAG,kBAAkB,GAAG,cAAc,CAAC;AAMzE;;GAEG;AACH,MAAM,WAAW,0BAA2B,SAAQ,WAAW,CAAC,sBAAsB,CAAC;IACrF,SAAS,EAAE,OAAO,sBAAsB,CAAC;IACzC,UAAU,EAAE;QACV,SAAS,EAAE,IAAI,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC;KACZ,CAAC;IACF,IAAI,CAAC,EAAE;QACL,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,EAAE,SAAS,CAAC;QACrB,IAAI,EAAE,SAAS,CAAC;KACjB,CAAC;CACH;AAMD;;;GAGG;AACH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;mBACY,MAAM,KAAG,gBAAgB;IAExC;;OAEG;qBACc,MAAM,KAAG,gBAAgB;IAE1C;;OAEG;qBACc,MAAM,KAAG,oBAAoB;IAE9C;;OAEG;yBACkB,MAAM,KAAG,oBAAoB;CAEnD,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,yBAAyB,EAAE,uBAwBvC,CAAC;AAMF,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,gDAAgD,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,iBAwDxB,CAAC"}

package/dist/db/schemas/collab-documents.schema.js

@@ -0,0 +1,125 @@
+// ============================================================================
+// Table Name
+// ============================================================================
+export const COLLAB_DOCUMENTS_TABLE = "captify_core_collab_documents";
+// ============================================================================
+// Key Builders
+// ============================================================================
+/**
+ * Key builders for Collab Documents table.
+ * Returns branded types to ensure type safety.
+ */
+export const collabDocumentKeys = {
+    /**
+     * Build partition key: TENANT#{tenantId}
+     */
+    pk: (tenantId) => `TENANT#${tenantId}`,
+    /**
+     * Build sort key: COLLAB_DOC#{documentId}
+     */
+    sk: (documentId) => `COLLAB_DOC#${documentId}`,
+    /**
+     * Build GSI1 partition key: USER#{userId}
+     */
+    gsi1Pk: (userId) => `USER#${userId}`,
+    /**
+     * Build GSI1 sort key: COLLAB_DOC#{documentId}
+     */
+    gsi1Sk: (documentId) => `COLLAB_DOC#${documentId}`,
+};
+// ============================================================================
+// Infrastructure (for table creation/migrations)
+// ============================================================================
+/**
+ * CreateTableCommandInput for AWS SDK.
+ */
+export const collabDocumentsTableInput = {
+    TableName: COLLAB_DOCUMENTS_TABLE,
+    AttributeDefinitions: [
+        { AttributeName: "PK", AttributeType: "S" },
+        { AttributeName: "SK", AttributeType: "S" },
+        { AttributeName: "GSI1_PK", AttributeType: "S" },
+        { AttributeName: "GSI1_SK", AttributeType: "S" },
+    ],
+    KeySchema: [
+        { AttributeName: "PK", KeyType: "HASH" },
+        { AttributeName: "SK", KeyType: "RANGE" },
+    ],
+    GlobalSecondaryIndexes: [
+        {
+            IndexName: "GSI1",
+            KeySchema: [
+                { AttributeName: "GSI1_PK", KeyType: "HASH" },
+                { AttributeName: "GSI1_SK", KeyType: "RANGE" },
+            ],
+            Projection: { ProjectionType: "ALL" },
+            ProvisionedThroughput: { ReadCapacityUnits: 5, WriteCapacityUnits: 5 },
+        },
+    ],
+    ProvisionedThroughput: { ReadCapacityUnits: 5, WriteCapacityUnits: 5 },
+};
+// ============================================================================
+// Schema Registry Entry
+// ============================================================================
+import { defineSchemaEntry, } from "../../ontology/schemas/ontology-registry.types";
+/**
+ * Schema entry for the ontology registry.
+ */
+export const schemaEntry = defineSchemaEntry({
+    tableInput: collabDocumentsTableInput,
+    displayName: "Collaborative Documents",
+    description: "Real-time collaborative documents with yjs CRDT",
+    entityType: "CollabDocument",
+    entityAttributes: [
+        { name: "id", type: "String", required: true, description: "Document identifier" },
+        { name: "tenantId", type: "String", required: true, description: "Tenant identifier" },
+        { name: "title", type: "String", required: true, description: "Document title" },
+        {
+            name: "content",
+            type: "Binary",
+            required: true,
+            description: "yjs-encoded document content",
+        },
+        { name: "contentVector", type: "Binary", description: "yjs state vector for sync" },
+        { name: "contentS3Key", type: "String", description: "S3 key for large documents" },
+        { name: "wordCount", type: "Number", required: true, description: "Document word count" },
+        { name: "previewSnippet", type: "String", description: "First ~200 chars of text" },
+        { name: "ownerId", type: "String", required: true, description: "Owner user ID" },
+        { name: "ownerName", type: "String", required: true, description: "Owner display name" },
+        { name: "ownerEmail", type: "String", required: true, description: "Owner email" },
+        { name: "status", type: "String", required: true, description: "Document status" },
+        { name: "trashedAt", type: "Number", description: "Timestamp when trashed" },
+        { name: "deletedAt", type: "Number", description: "Timestamp when hard deleted" },
+        { name: "createdAt", type: "Number", required: true, description: "Creation timestamp" },
+        { name: "updatedAt", type: "Number", required: true, description: "Last update timestamp" },
+        { name: "createdById", type: "String", required: true, description: "Creator user ID" },
+        { name: "modifiedById", type: "String", description: "Last modifier user ID" },
+    ],
+    relationships: [
+        {
+            targetTable: "captify_core_collab_collaborators",
+            sourceAttribute: "id",
+            targetAttribute: "documentId",
+            label: "Has Collaborators",
+            confidence: "high",
+            description: "Documents have collaborators with permissions",
+        },
+        {
+            targetTable: "captify_core_collab_versions",
+            sourceAttribute: "id",
+            targetAttribute: "documentId",
+            label: "Has Versions",
+            confidence: "high",
+            description: "Documents have version history",
+        },
+        {
+            targetTable: "captify_core_collab_comments",
+            sourceAttribute: "id",
+            targetAttribute: "documentId",
+            label: "Has Comments",
+            confidence: "high",
+            description: "Documents have inline comments",
+        },
+    ],
+});
+//# sourceMappingURL=collab-documents.schema.js.map

package/dist/db/schemas/collab-documents.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-documents.schema.js","sourceRoot":"","sources":["../../../lib/db/schemas/collab-documents.schema.ts"],"names":[],"mappings":"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"}

package/dist/db/schemas/collab-versions.schema.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Document Versions Table Schema
+ *
+ * Single source of truth for the collab_versions table:
+ * - Document types (Keys + Entity)
+ * - Table schema (for DynamoDB service type safety)
+ * - Key builders
+ * - Infrastructure (CreateTableCommandInput)
+ *
+ * Access Patterns:
+ * 1. Get version by document + versionId: Query on PK + SK
+ * 2. List versions for a document (newest first): Query on PK, descending
+ */
+import type { CreateTableCommandInput } from "@aws-sdk/client-dynamodb";
+import type { TableSchema } from "../../shared/services/dynamodb";
+import type { DocumentVersion } from "../../collaboration/collaboration.schemas";
+import type { PartitionKey, SortKey } from "../../shared/shared.schemas";
+export declare const COLLAB_VERSIONS_TABLE = "captify_core_collab_versions";
+/** Branded partition key type for Versions table */
+export type VersionPK = PartitionKey<"Version">;
+/** Branded sort key type for Versions table */
+export type VersionSK = SortKey<"Version">;
+/**
+ * DynamoDB key attributes for Versions table.
+ */
+export interface VersionKeys {
+    /** Partition key: COLLAB_DOC#{documentId} */
+    PK: VersionPK;
+    /** Sort key: VERSION#{timestamp} (zero-padded for sorting) */
+    SK: VersionSK;
+}
+/**
+ * The complete document stored in DynamoDB for a Version item.
+ *
+ * @example
+ * {
+ *   PK: "COLLAB_DOC#doc-123",
+ *   SK: "VERSION#1704067200000",
+ *   id: "version-456",
+ *   documentId: "doc-123",
+ *   content: <Binary>,
+ *   wordCount: 1500,
+ *   editorId: "user-123",
+ *   editorName: "John Doe",
+ *   snapshotType: "auto",
+ *   createdAt: 1704067200000
+ * }
+ */
+export type VersionDocument = VersionKeys & DocumentVersion;
+/**
+ * Versions table schema for DynamoDB service type safety.
+ */
+export interface CollabVersionsTableSchema extends TableSchema<VersionDocument> {
+    tableName: typeof COLLAB_VERSIONS_TABLE;
+    primaryKey: {
+        partition: "PK";
+        sort: "SK";
+    };
+}
+/**
+ * Key builders for Versions table.
+ * Returns branded types to ensure type safety.
+ */
+export declare const versionKeys: {
+    /**
+     * Build partition key: COLLAB_DOC#{documentId}
+     */
+    pk: (documentId: string) => VersionPK;
+    /**
+     * Build sort key: VERSION#{timestamp}
+     * Timestamp is zero-padded to 15 digits for proper string sorting
+     */
+    sk: (timestamp: number) => VersionSK;
+    /**
+     * Parse timestamp from sort key
+     */
+    parseTimestamp: (sk: string) => number;
+};
+/**
+ * CreateTableCommandInput for AWS SDK.
+ */
+export declare const collabVersionsTableInput: CreateTableCommandInput;
+import { type SchemaEntryConfig } from "../../ontology/schemas/ontology-registry.types";
+/**
+ * Schema entry for the ontology registry.
+ */
+export declare const schemaEntry: SchemaEntryConfig;
+//# sourceMappingURL=collab-versions.schema.d.ts.map

package/dist/db/schemas/collab-versions.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-versions.schema.d.ts","sourceRoot":"","sources":["../../../lib/db/schemas/collab-versions.schema.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,0BAA0B,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAClE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,6BAA6B,CAAC;AAMzE,eAAO,MAAM,qBAAqB,iCAAiC,CAAC;AAMpE,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;AAEhD,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;AAM3C;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,6CAA6C;IAC7C,EAAE,EAAE,SAAS,CAAC;IACd,8DAA8D;IAC9D,EAAE,EAAE,SAAS,CAAC;CACf;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,MAAM,eAAe,GAAG,WAAW,GAAG,eAAe,CAAC;AAM5D;;GAEG;AACH,MAAM,WAAW,yBAA0B,SAAQ,WAAW,CAAC,eAAe,CAAC;IAC7E,SAAS,EAAE,OAAO,qBAAqB,CAAC;IACxC,UAAU,EAAE;QACV,SAAS,EAAE,IAAI,CAAC;QAChB,IAAI,EAAE,IAAI,CAAC;KACZ,CAAC;CACH;AAMD;;;GAGG;AACH,eAAO,MAAM,WAAW;IACtB;;OAEG;qBACc,MAAM,KAAG,SAAS;IAEnC;;;OAGG;oBACa,MAAM,KAAG,SAAS;IAGlC;;OAEG;yBACkB,MAAM,KAAG,MAAM;CAIrC,CAAC;AAMF;;GAEG;AACH,eAAO,MAAM,wBAAwB,EAAE,uBAWtC,CAAC;AAMF,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,gDAAgD,CAAC;AAExD;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,iBA6CxB,CAAC"}

package/dist/db/schemas/collab-versions.schema.js

@@ -0,0 +1,101 @@
+// ============================================================================
+// Table Name
+// ============================================================================
+export const COLLAB_VERSIONS_TABLE = "captify_core_collab_versions";
+// ============================================================================
+// Key Builders
+// ============================================================================
+/**
+ * Key builders for Versions table.
+ * Returns branded types to ensure type safety.
+ */
+export const versionKeys = {
+    /**
+     * Build partition key: COLLAB_DOC#{documentId}
+     */
+    pk: (documentId) => `COLLAB_DOC#${documentId}`,
+    /**
+     * Build sort key: VERSION#{timestamp}
+     * Timestamp is zero-padded to 15 digits for proper string sorting
+     */
+    sk: (timestamp) => `VERSION#${timestamp.toString().padStart(15, "0")}`,
+    /**
+     * Parse timestamp from sort key
+     */
+    parseTimestamp: (sk) => {
+        const match = sk.match(/^VERSION#(\d+)$/);
+        return match ? parseInt(match[1], 10) : 0;
+    },
+};
+// ============================================================================
+// Infrastructure (for table creation/migrations)
+// ============================================================================
+/**
+ * CreateTableCommandInput for AWS SDK.
+ */
+export const collabVersionsTableInput = {
+    TableName: COLLAB_VERSIONS_TABLE,
+    AttributeDefinitions: [
+        { AttributeName: "PK", AttributeType: "S" },
+        { AttributeName: "SK", AttributeType: "S" },
+    ],
+    KeySchema: [
+        { AttributeName: "PK", KeyType: "HASH" },
+        { AttributeName: "SK", KeyType: "RANGE" },
+    ],
+    ProvisionedThroughput: { ReadCapacityUnits: 5, WriteCapacityUnits: 5 },
+};
+// ============================================================================
+// Schema Registry Entry
+// ============================================================================
+import { defineSchemaEntry, } from "../../ontology/schemas/ontology-registry.types";
+/**
+ * Schema entry for the ontology registry.
+ */
+export const schemaEntry = defineSchemaEntry({
+    tableInput: collabVersionsTableInput,
+    displayName: "Document Versions",
+    description: "Version history snapshots for collaborative documents",
+    entityType: "DocumentVersion",
+    entityAttributes: [
+        { name: "id", type: "String", required: true, description: "Version identifier" },
+        { name: "documentId", type: "String", required: true, description: "Document reference" },
+        {
+            name: "content",
+            type: "Binary",
+            required: true,
+            description: "yjs-encoded content snapshot",
+        },
+        { name: "contentS3Key", type: "String", description: "S3 key for large versions" },
+        { name: "wordCount", type: "Number", required: true, description: "Word count at snapshot" },
+        { name: "editorId", type: "String", required: true, description: "Editor user ID" },
+        { name: "editorName", type: "String", required: true, description: "Editor display name" },
+        {
+            name: "snapshotType",
+            type: "String",
+            required: true,
+            description: "auto|manual|restore|session_end",
+        },
+        { name: "label", type: "String", description: "User label for manual snapshots" },
+        { name: "createdAt", type: "Number", required: true, description: "Creation timestamp" },
+    ],
+    relationships: [
+        {
+            targetTable: "captify_core_collab_documents",
+            sourceAttribute: "documentId",
+            targetAttribute: "id",
+            label: "Version Of",
+            confidence: "high",
+            description: "Version is a snapshot of a document",
+        },
+        {
+            targetTable: "cognito_users",
+            sourceAttribute: "editorId",
+            targetAttribute: "id",
+            label: "Created By",
+            confidence: "high",
+            description: "Version created by an editor",
+        },
+    ],
+});
+//# sourceMappingURL=collab-versions.schema.js.map

package/dist/db/schemas/collab-versions.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"collab-versions.schema.js","sourceRoot":"","sources":["../../../lib/db/schemas/collab-versions.schema.ts"],"names":[],"mappings":"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"}