@contractspec/lib.files 1.44.0

package/dist/contracts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/contracts/index.ts"],"sourcesContent":["import { ScalarTypeEnum, defineSchemaModel } from '@contractspec/lib.schema';\nimport { defineCommand, defineQuery } from '@contractspec/lib.contracts';\n\nconst OWNERS = ['platform.files'] as const;\n\n// ============ Schema Models ============\n\nexport const FileModel = defineSchemaModel({\n  name: 'File',\n  description: 'Represents an uploaded file',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    mimeType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    size: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    storageProvider: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: false,\n    },\n    storagePath: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    checksum: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    metadata: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    width: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    height: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    updatedAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const FileVersionModel = defineSchemaModel({\n  name: 'FileVersion',\n  description: 'Represents a file version',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    version: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    size: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    storagePath: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    checksum: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    comment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n  },\n});\n\nexport const AttachmentModel = defineSchemaModel({\n  name: 'Attachment',\n  description: 'Represents an attachment',\n  fields: {\n    id: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    entityType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    entityId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    attachmentType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    metadata: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    createdBy: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    createdAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    file: { type: FileModel, isOptional: true },\n  },\n});\n\nexport const PresignedUrlModel = defineSchemaModel({\n  name: 'PresignedUrl',\n  description: 'A presigned URL for file operations',\n  fields: {\n    url: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    fields: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    expiresAt: { type: ScalarTypeEnum.DateTime(), isOptional: false },\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    sessionId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\n// ============ Input/Output Models ============\n\nconst UploadFileInput = defineSchemaModel({\n  name: 'UploadFileInput',\n  description: 'Input for uploading a file',\n  fields: {\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    mimeType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    size: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }, // Base64 encoded\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    metadata: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\nconst UpdateFileInput = defineSchemaModel({\n  name: 'UpdateFileInput',\n  description: 'Input for updating a file',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    isPublic: { type: ScalarTypeEnum.Boolean(), isOptional: true },\n    metadata: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\nconst DeleteFileInput = defineSchemaModel({\n  name: 'DeleteFileInput',\n  description: 'Input for deleting a file',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst GetFileInput = defineSchemaModel({\n  name: 'GetFileInput',\n  description: 'Input for getting a file',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst ListFilesInput = defineSchemaModel({\n  name: 'ListFilesInput',\n  description: 'Input for listing files',\n  fields: {\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    ownerId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    mimeType: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    status: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    tags: { type: ScalarTypeEnum.JSON(), isOptional: true },\n    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    offset: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nconst ListFilesOutput = defineSchemaModel({\n  name: 'ListFilesOutput',\n  description: 'Output for listing files',\n  fields: {\n    files: { type: FileModel, isArray: true, isOptional: false },\n    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n  },\n});\n\nconst GetDownloadUrlInput = defineSchemaModel({\n  name: 'GetDownloadUrlInput',\n  description: 'Input for getting a download URL',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    expiresInSeconds: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nconst CreateVersionInput = defineSchemaModel({\n  name: 'CreateVersionInput',\n  description: 'Input for creating a file version',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    content: { type: ScalarTypeEnum.String_unsecure(), isOptional: false }, // Base64 encoded\n    comment: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n  },\n});\n\nconst GetVersionsInput = defineSchemaModel({\n  name: 'GetVersionsInput',\n  description: 'Input for getting file versions',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    limit: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    offset: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nconst GetVersionsOutput = defineSchemaModel({\n  name: 'GetVersionsOutput',\n  description: 'Output for getting file versions',\n  fields: {\n    versions: { type: FileVersionModel, isArray: true, isOptional: false },\n    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n  },\n});\n\nconst AttachFileInput = defineSchemaModel({\n  name: 'AttachFileInput',\n  description: 'Input for attaching a file to an entity',\n  fields: {\n    fileId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    entityType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    entityId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    attachmentType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n    name: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    description: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    order: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n    metadata: { type: ScalarTypeEnum.JSON(), isOptional: true },\n  },\n});\n\nconst DetachFileInput = defineSchemaModel({\n  name: 'DetachFileInput',\n  description: 'Input for detaching a file',\n  fields: {\n    attachmentId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n  },\n});\n\nconst ListAttachmentsInput = defineSchemaModel({\n  name: 'ListAttachmentsInput',\n  description: 'Input for listing attachments',\n  fields: {\n    entityType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    entityId: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    attachmentType: {\n      type: ScalarTypeEnum.String_unsecure(),\n      isOptional: true,\n    },\n  },\n});\n\nconst ListAttachmentsOutput = defineSchemaModel({\n  name: 'ListAttachmentsOutput',\n  description: 'Output for listing attachments',\n  fields: {\n    attachments: { type: AttachmentModel, isArray: true, isOptional: false },\n    total: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n  },\n});\n\nconst CreatePresignedUrlInput = defineSchemaModel({\n  name: 'CreatePresignedUrlInput',\n  description: 'Input for creating a presigned upload URL',\n  fields: {\n    fileName: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    mimeType: { type: ScalarTypeEnum.String_unsecure(), isOptional: false },\n    size: { type: ScalarTypeEnum.Int_unsecure(), isOptional: false },\n    orgId: { type: ScalarTypeEnum.String_unsecure(), isOptional: true },\n    expiresInSeconds: { type: ScalarTypeEnum.Int_unsecure(), isOptional: true },\n  },\n});\n\nconst SuccessOutput = defineSchemaModel({\n  name: 'SuccessOutput',\n  description: 'Generic success output',\n  fields: {\n    success: { type: ScalarTypeEnum.Boolean(), isOptional: false },\n  },\n});\n\n// ============ Contracts ============\n\n/**\n * Upload a file.\n */\nexport const UploadFileContract = defineCommand({\n  meta: {\n    key: 'file.upload',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'upload'],\n    description: 'Upload a new file.',\n    goal: 'Store a file and create a file record.',\n    context: 'Called when uploading files directly.',\n  },\n  io: {\n    input: UploadFileInput,\n    output: FileModel,\n    errors: {\n      FILE_TOO_LARGE: {\n        description: 'File exceeds size limit',\n        http: 413,\n        gqlCode: 'FILE_TOO_LARGE',\n        when: 'File size exceeds configured limit',\n      },\n      INVALID_MIME_TYPE: {\n        description: 'MIME type not allowed',\n        http: 415,\n        gqlCode: 'INVALID_MIME_TYPE',\n        when: 'File type is not in allowed list',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Update a file.\n */\nexport const UpdateFileContract = defineCommand({\n  meta: {\n    key: 'file.update',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'update'],\n    description: 'Update file metadata.',\n    goal: 'Modify file properties without replacing content.',\n    context: 'Called when renaming or updating file metadata.',\n  },\n  io: {\n    input: UpdateFileInput,\n    output: FileModel,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Delete a file.\n */\nexport const DeleteFileContract = defineCommand({\n  meta: {\n    key: 'file.delete',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'delete'],\n    description: 'Delete a file.',\n    goal: 'Remove a file and all its versions and attachments.',\n    context: 'Called when removing a file permanently.',\n  },\n  io: {\n    input: DeleteFileInput,\n    output: SuccessOutput,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Get a file by ID.\n */\nexport const GetFileContract = defineQuery({\n  meta: {\n    key: 'file.get',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'get'],\n    description: 'Get a file by ID.',\n    goal: 'Retrieve file metadata.',\n    context: 'Called to inspect file details.',\n  },\n  io: {\n    input: GetFileInput,\n    output: FileModel,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * List files.\n */\nexport const ListFilesContract = defineQuery({\n  meta: {\n    key: 'file.list',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'list'],\n    description: 'List files with filtering.',\n    goal: 'Browse uploaded files.',\n    context: 'Called to browse file library.',\n  },\n  io: {\n    input: ListFilesInput,\n    output: ListFilesOutput,\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Get download URL.\n */\nexport const GetDownloadUrlContract = defineQuery({\n  meta: {\n    key: 'file.downloadUrl',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'download'],\n    description: 'Get a presigned download URL.',\n    goal: 'Generate a temporary URL for downloading.',\n    context: 'Called when user wants to download a file.',\n  },\n  io: {\n    input: GetDownloadUrlInput,\n    output: PresignedUrlModel,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Create a file version.\n */\nexport const CreateVersionContract = defineCommand({\n  meta: {\n    key: 'file.version.create',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'version', 'create'],\n    description: 'Create a new version of a file.',\n    goal: 'Upload a new version while preserving history.',\n    context: 'Called when updating a document.',\n  },\n  io: {\n    input: CreateVersionInput,\n    output: FileVersionModel,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Get file versions.\n */\nexport const GetVersionsContract = defineQuery({\n  meta: {\n    key: 'file.version.list',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'version', 'list'],\n    description: 'Get file version history.',\n    goal: 'View all versions of a file.',\n    context: 'Called to browse file history.',\n  },\n  io: {\n    input: GetVersionsInput,\n    output: GetVersionsOutput,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Attach a file to an entity.\n */\nexport const AttachFileContract = defineCommand({\n  meta: {\n    key: 'attachment.attach',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'attachment', 'attach'],\n    description: 'Attach a file to an entity.',\n    goal: 'Link a file to a business entity.',\n    context: 'Called when associating files with entities.',\n  },\n  io: {\n    input: AttachFileInput,\n    output: AttachmentModel,\n    errors: {\n      FILE_NOT_FOUND: {\n        description: 'File does not exist',\n        http: 404,\n        gqlCode: 'FILE_NOT_FOUND',\n        when: 'File ID is invalid',\n      },\n      ATTACHMENT_EXISTS: {\n        description: 'Attachment already exists',\n        http: 409,\n        gqlCode: 'ATTACHMENT_EXISTS',\n        when: 'File is already attached to this entity',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Detach a file from an entity.\n */\nexport const DetachFileContract = defineCommand({\n  meta: {\n    key: 'attachment.detach',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'attachment', 'detach'],\n    description: 'Detach a file from an entity.',\n    goal: 'Remove a file association.',\n    context: 'Called when removing file from entity.',\n  },\n  io: {\n    input: DetachFileInput,\n    output: SuccessOutput,\n    errors: {\n      ATTACHMENT_NOT_FOUND: {\n        description: 'Attachment does not exist',\n        http: 404,\n        gqlCode: 'ATTACHMENT_NOT_FOUND',\n        when: 'Attachment ID is invalid',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * List attachments for an entity.\n */\nexport const ListAttachmentsContract = defineQuery({\n  meta: {\n    key: 'attachment.list',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'attachment', 'list'],\n    description: 'List attachments for an entity.',\n    goal: 'Get all files attached to an entity.',\n    context: 'Called to display attached files.',\n  },\n  io: {\n    input: ListAttachmentsInput,\n    output: ListAttachmentsOutput,\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n\n/**\n * Create a presigned upload URL.\n */\nexport const CreatePresignedUrlContract = defineCommand({\n  meta: {\n    key: 'file.presignedUrl.create',\n    version: 1,\n    stability: 'stable',\n    owners: [...OWNERS],\n    tags: ['files', 'presigned', 'upload'],\n    description: 'Create a presigned URL for direct upload.',\n    goal: 'Enable direct-to-storage uploads.',\n    context: 'Called for large file uploads.',\n  },\n  io: {\n    input: CreatePresignedUrlInput,\n    output: PresignedUrlModel,\n    errors: {\n      FILE_TOO_LARGE: {\n        description: 'File exceeds size limit',\n        http: 413,\n        gqlCode: 'FILE_TOO_LARGE',\n        when: 'Requested file size exceeds limit',\n      },\n      INVALID_MIME_TYPE: {\n        description: 'MIME type not allowed',\n        http: 415,\n        gqlCode: 'INVALID_MIME_TYPE',\n        when: 'File type is not in allowed list',\n      },\n    },\n  },\n  policy: {\n    auth: 'user',\n  },\n});\n"],"mappings":"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"}

package/dist/docs/files.docblock.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/files.docblock.js

@@ -0,0 +1,71 @@
+import { registerDocBlocks } from "@contractspec/lib.contracts/docs";
+
+//#region src/docs/files.docblock.ts
+registerDocBlocks([{
+	id: "docs.files.attachments",
+	title: "Files, Versions & Attachments",
+	summary: "Spec-first file management with storage adapters, versioning, presigned URLs, and polymorphic attachments for any entity.",
+	kind: "reference",
+	visibility: "public",
+	route: "/docs/files/attachments",
+	tags: [
+		"files",
+		"attachments",
+		"storage",
+		"versions"
+	],
+	body: `## Capabilities
+
+- **Entities**: File, FileVersion, Attachment, UploadSession with retention, checksum, ACLs.
+- **Contracts**: upload/update/delete/list/get files; presigned upload/download; version create/list; attach/detach/list attachments.
+- **Storage**: pluggable adapters (Local, S3 placeholder + interface), in-memory for tests.
+- **Events**: file.uploaded/deleted, attachment.added/removed (see events export).
+
+## Usage
+
+1) Compose schema
+- Include \`filesSchemaContribution\` in your schema composition.
+
+2) Register contracts/events
+- Import contracts and events from \`@contractspec/lib.files\` in your spec registry.
+
+3) Wire storage
+- Provide a \`StorageAdapter\` implementation (local/in-memory or S3 via custom impl).
+- Use \`createStorageAdapter\` with config to instantiate.
+
+4) Attach to domain entities
+- Use \`attachment.attach\` with \`entityType/entityId\` to link files to deals, orders, runs, etc.
+
+## Example
+
+\`\`\`ts
+import {
+  UploadFileContract,
+  AttachFileContract,
+  InMemoryStorageAdapter,
+} from '@contractspec/lib.files';
+
+// storage
+const storage = new InMemoryStorageAdapter();
+
+// upload
+const file = await storage.upload({
+  path: 'org-1/reports/r1.pdf',
+  content: Buffer.from(pdfBytes),
+  mimeType: 'application/pdf',
+});
+
+// attach
+await AttachFileContract; // register in spec to enable attach flows
+\`\`\`,
+
+## Guardrails
+
+- Enforce size/MIME limits in your handlers; avoid storing PII in paths.
+- Keep \`orgId\` scoped for multi-tenant isolation; prefer presigned URLs for public delivery.
+- Persist checksums for integrity; emit audit + events for access/retention changes.
+`
+}]);
+
+//#endregion
+//# sourceMappingURL=files.docblock.js.map

package/dist/docs/files.docblock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"files.docblock.js","names":[],"sources":["../../src/docs/files.docblock.ts"],"sourcesContent":["import type { DocBlock } from '@contractspec/lib.contracts/docs';\nimport { registerDocBlocks } from '@contractspec/lib.contracts/docs';\n\nconst filesDocBlocks: DocBlock[] = [\n  {\n    id: 'docs.files.attachments',\n    title: 'Files, Versions & Attachments',\n    summary:\n      'Spec-first file management with storage adapters, versioning, presigned URLs, and polymorphic attachments for any entity.',\n    kind: 'reference',\n    visibility: 'public',\n    route: '/docs/files/attachments',\n    tags: ['files', 'attachments', 'storage', 'versions'],\n    body: `## Capabilities\n\n- **Entities**: File, FileVersion, Attachment, UploadSession with retention, checksum, ACLs.\n- **Contracts**: upload/update/delete/list/get files; presigned upload/download; version create/list; attach/detach/list attachments.\n- **Storage**: pluggable adapters (Local, S3 placeholder + interface), in-memory for tests.\n- **Events**: file.uploaded/deleted, attachment.added/removed (see events export).\n\n## Usage\n\n1) Compose schema\n- Include \\`filesSchemaContribution\\` in your schema composition.\n\n2) Register contracts/events\n- Import contracts and events from \\`@contractspec/lib.files\\` in your spec registry.\n\n3) Wire storage\n- Provide a \\`StorageAdapter\\` implementation (local/in-memory or S3 via custom impl).\n- Use \\`createStorageAdapter\\` with config to instantiate.\n\n4) Attach to domain entities\n- Use \\`attachment.attach\\` with \\`entityType/entityId\\` to link files to deals, orders, runs, etc.\n\n## Example\n\n${'```'}ts\nimport {\n  UploadFileContract,\n  AttachFileContract,\n  InMemoryStorageAdapter,\n} from '@contractspec/lib.files';\n\n// storage\nconst storage = new InMemoryStorageAdapter();\n\n// upload\nconst file = await storage.upload({\n  path: 'org-1/reports/r1.pdf',\n  content: Buffer.from(pdfBytes),\n  mimeType: 'application/pdf',\n});\n\n// attach\nawait AttachFileContract; // register in spec to enable attach flows\n${'```'},\n\n## Guardrails\n\n- Enforce size/MIME limits in your handlers; avoid storing PII in paths.\n- Keep \\`orgId\\` scoped for multi-tenant isolation; prefer presigned URLs for public delivery.\n- Persist checksums for integrity; emit audit + events for access/retention changes.\n`,\n  },\n];\n\nregisterDocBlocks(filesDocBlocks);\n"],"mappings":";;;AAmEA,kBAhEmC,CACjC;CACE,IAAI;CACJ,OAAO;CACP,SACE;CACF,MAAM;CACN,YAAY;CACZ,OAAO;CACP,MAAM;EAAC;EAAS;EAAe;EAAW;EAAW;CACrD,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmDP,CACF,CAEgC"}

package/dist/docs/index.d.ts

@@ -0,0 +1 @@
+export { };

package/dist/docs/index.js

@@ -0,0 +1 @@
+import "./files.docblock.js";

package/dist/entities/index.d.ts

@@ -0,0 +1,169 @@
+import * as _contractspec_lib_schema404 from "@contractspec/lib.schema";
+import { ModuleSchemaContribution } from "@contractspec/lib.schema";
+
+//#region src/entities/index.d.ts
+/**
+ * Storage provider enum.
+ */
+declare const StorageProviderEnum: _contractspec_lib_schema404.EntityEnumDef;
+/**
+ * File status enum.
+ */
+declare const FileStatusEnum: _contractspec_lib_schema404.EntityEnumDef;
+/**
+ * File entity - represents an uploaded file.
+ */
+declare const FileEntity: _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  name: _contractspec_lib_schema404.EntityScalarField;
+  mimeType: _contractspec_lib_schema404.EntityScalarField;
+  size: _contractspec_lib_schema404.EntityScalarField;
+  storageProvider: _contractspec_lib_schema404.EntityEnumField;
+  storagePath: _contractspec_lib_schema404.EntityScalarField;
+  storageKey: _contractspec_lib_schema404.EntityScalarField;
+  checksum: _contractspec_lib_schema404.EntityScalarField;
+  etag: _contractspec_lib_schema404.EntityScalarField;
+  status: _contractspec_lib_schema404.EntityEnumField;
+  isPublic: _contractspec_lib_schema404.EntityScalarField;
+  expiresAt: _contractspec_lib_schema404.EntityScalarField;
+  ownerId: _contractspec_lib_schema404.EntityScalarField;
+  orgId: _contractspec_lib_schema404.EntityScalarField;
+  metadata: _contractspec_lib_schema404.EntityScalarField;
+  tags: _contractspec_lib_schema404.EntityScalarField;
+  width: _contractspec_lib_schema404.EntityScalarField;
+  height: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  updatedAt: _contractspec_lib_schema404.EntityScalarField;
+  versions: _contractspec_lib_schema404.EntityRelationField;
+  attachments: _contractspec_lib_schema404.EntityRelationField;
+}>;
+/**
+ * FileVersion entity - version history for files.
+ */
+declare const FileVersionEntity: _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  fileId: _contractspec_lib_schema404.EntityScalarField;
+  version: _contractspec_lib_schema404.EntityScalarField;
+  size: _contractspec_lib_schema404.EntityScalarField;
+  storagePath: _contractspec_lib_schema404.EntityScalarField;
+  checksum: _contractspec_lib_schema404.EntityScalarField;
+  comment: _contractspec_lib_schema404.EntityScalarField;
+  changes: _contractspec_lib_schema404.EntityScalarField;
+  createdBy: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  file: _contractspec_lib_schema404.EntityRelationField;
+}>;
+/**
+ * Attachment entity - polymorphic link between files and entities.
+ */
+declare const AttachmentEntity: _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  fileId: _contractspec_lib_schema404.EntityScalarField;
+  entityType: _contractspec_lib_schema404.EntityScalarField;
+  entityId: _contractspec_lib_schema404.EntityScalarField;
+  attachmentType: _contractspec_lib_schema404.EntityScalarField;
+  name: _contractspec_lib_schema404.EntityScalarField;
+  description: _contractspec_lib_schema404.EntityScalarField;
+  order: _contractspec_lib_schema404.EntityScalarField;
+  metadata: _contractspec_lib_schema404.EntityScalarField;
+  createdBy: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  updatedAt: _contractspec_lib_schema404.EntityScalarField;
+  file: _contractspec_lib_schema404.EntityRelationField;
+}>;
+/**
+ * UploadSession entity - tracks multipart uploads.
+ */
+declare const UploadSessionEntity: _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  fileName: _contractspec_lib_schema404.EntityScalarField;
+  mimeType: _contractspec_lib_schema404.EntityScalarField;
+  totalSize: _contractspec_lib_schema404.EntityScalarField;
+  uploadId: _contractspec_lib_schema404.EntityScalarField;
+  uploadedBytes: _contractspec_lib_schema404.EntityScalarField;
+  uploadedParts: _contractspec_lib_schema404.EntityScalarField;
+  status: _contractspec_lib_schema404.EntityScalarField;
+  error: _contractspec_lib_schema404.EntityScalarField;
+  fileId: _contractspec_lib_schema404.EntityScalarField;
+  ownerId: _contractspec_lib_schema404.EntityScalarField;
+  orgId: _contractspec_lib_schema404.EntityScalarField;
+  expiresAt: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  updatedAt: _contractspec_lib_schema404.EntityScalarField;
+}>;
+/**
+ * All file entities for schema composition.
+ */
+declare const fileEntities: (_contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  name: _contractspec_lib_schema404.EntityScalarField;
+  mimeType: _contractspec_lib_schema404.EntityScalarField;
+  size: _contractspec_lib_schema404.EntityScalarField;
+  storageProvider: _contractspec_lib_schema404.EntityEnumField;
+  storagePath: _contractspec_lib_schema404.EntityScalarField;
+  storageKey: _contractspec_lib_schema404.EntityScalarField;
+  checksum: _contractspec_lib_schema404.EntityScalarField;
+  etag: _contractspec_lib_schema404.EntityScalarField;
+  status: _contractspec_lib_schema404.EntityEnumField;
+  isPublic: _contractspec_lib_schema404.EntityScalarField;
+  expiresAt: _contractspec_lib_schema404.EntityScalarField;
+  ownerId: _contractspec_lib_schema404.EntityScalarField;
+  orgId: _contractspec_lib_schema404.EntityScalarField;
+  metadata: _contractspec_lib_schema404.EntityScalarField;
+  tags: _contractspec_lib_schema404.EntityScalarField;
+  width: _contractspec_lib_schema404.EntityScalarField;
+  height: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  updatedAt: _contractspec_lib_schema404.EntityScalarField;
+  versions: _contractspec_lib_schema404.EntityRelationField;
+  attachments: _contractspec_lib_schema404.EntityRelationField;
+}> | _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  fileId: _contractspec_lib_schema404.EntityScalarField;
+  version: _contractspec_lib_schema404.EntityScalarField;
+  size: _contractspec_lib_schema404.EntityScalarField;
+  storagePath: _contractspec_lib_schema404.EntityScalarField;
+  checksum: _contractspec_lib_schema404.EntityScalarField;
+  comment: _contractspec_lib_schema404.EntityScalarField;
+  changes: _contractspec_lib_schema404.EntityScalarField;
+  createdBy: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  file: _contractspec_lib_schema404.EntityRelationField;
+}> | _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  fileId: _contractspec_lib_schema404.EntityScalarField;
+  entityType: _contractspec_lib_schema404.EntityScalarField;
+  entityId: _contractspec_lib_schema404.EntityScalarField;
+  attachmentType: _contractspec_lib_schema404.EntityScalarField;
+  name: _contractspec_lib_schema404.EntityScalarField;
+  description: _contractspec_lib_schema404.EntityScalarField;
+  order: _contractspec_lib_schema404.EntityScalarField;
+  metadata: _contractspec_lib_schema404.EntityScalarField;
+  createdBy: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  updatedAt: _contractspec_lib_schema404.EntityScalarField;
+  file: _contractspec_lib_schema404.EntityRelationField;
+}> | _contractspec_lib_schema404.EntitySpec<{
+  id: _contractspec_lib_schema404.EntityScalarField;
+  fileName: _contractspec_lib_schema404.EntityScalarField;
+  mimeType: _contractspec_lib_schema404.EntityScalarField;
+  totalSize: _contractspec_lib_schema404.EntityScalarField;
+  uploadId: _contractspec_lib_schema404.EntityScalarField;
+  uploadedBytes: _contractspec_lib_schema404.EntityScalarField;
+  uploadedParts: _contractspec_lib_schema404.EntityScalarField;
+  status: _contractspec_lib_schema404.EntityScalarField;
+  error: _contractspec_lib_schema404.EntityScalarField;
+  fileId: _contractspec_lib_schema404.EntityScalarField;
+  ownerId: _contractspec_lib_schema404.EntityScalarField;
+  orgId: _contractspec_lib_schema404.EntityScalarField;
+  expiresAt: _contractspec_lib_schema404.EntityScalarField;
+  createdAt: _contractspec_lib_schema404.EntityScalarField;
+  updatedAt: _contractspec_lib_schema404.EntityScalarField;
+}>)[];
+/**
+ * Module schema contribution for files.
+ */
+declare const filesSchemaContribution: ModuleSchemaContribution;
+//#endregion
+export { AttachmentEntity, FileEntity, FileStatusEnum, FileVersionEntity, StorageProviderEnum, UploadSessionEntity, fileEntities, filesSchemaContribution };
+//# sourceMappingURL=index.d.ts.map

package/dist/entities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../../src/entities/index.ts"],"sourcesContent":[],"mappings":";;;;;;;AAWa,cAAA,mBAKX,EAAA,2BAAA,CAL8B,aAK9B;AAKF;AAiBA;;cAjBa,gBAYX,2BAAA,CAZyB;;;;cAiBd,wCAAU;MA0FrB,2BAAA,CAAA;;;;;;;;;;;;;;;;sDA1FqB;EAAA,MAAA,+CAAA;EA+FV,SAAA,+CAwCX;EAAA,SAAA,+CAAA;;;;;;;cAxCW,+CAAiB;MAwC5B,2BAAA,CAAA;;;qDAxC4B;EAAA,WAAA,+CAAA;EA6CjB,QAAA,+CAwDX;EAAA,OAAA,+CAAA;;;;;;;;;cAxDW,8CAAgB;MAwD3B,2BAAA,CAAA;;;yDAxD2B;EAAA,cAAA,+CAAA;EA6DhB,IAAA,+CA0DX;EAAA,WAAA,+CAAA;;;;;;;;;;;cA1DW,iDAAmB;MA0D9B,2BAAA,CAAA;;;0DA1D8B;EAAA,QAAA,+CAAA;EA+DnB,aAAA,+CAKZ;EAAA,aAAA,+CAAA;;;;;;;;;;;;;cALY,2CAAY;MAKxB,2BAAA,CAAA;;;;;;;;qDALwB;EAAA,MAAA,6CAAA;;;;;;;;;;;;;;MAAA,2BAAA,CAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAUZ,SAAA,+CAIZ;;;;;;;;;;;;;;;;cAJY,yBAAyB"}

package/dist/entities/index.js

@@ -0,0 +1,265 @@
+import { defineEntity, defineEntityEnum, field, index } from "@contractspec/lib.schema";
+
+//#region src/entities/index.ts
+/**
+* Storage provider enum.
+*/
+const StorageProviderEnum = defineEntityEnum({
+	name: "StorageProvider",
+	values: [
+		"LOCAL",
+		"S3",
+		"GCS",
+		"AZURE",
+		"CLOUDFLARE"
+	],
+	schema: "lssm_files",
+	description: "Storage backend provider."
+});
+/**
+* File status enum.
+*/
+const FileStatusEnum = defineEntityEnum({
+	name: "FileStatus",
+	values: [
+		"PENDING",
+		"UPLOADED",
+		"PROCESSING",
+		"READY",
+		"ERROR",
+		"DELETED"
+	],
+	schema: "lssm_files",
+	description: "File processing status."
+});
+/**
+* File entity - represents an uploaded file.
+*/
+const FileEntity = defineEntity({
+	name: "File",
+	description: "An uploaded file.",
+	schema: "lssm_files",
+	map: "file",
+	fields: {
+		id: field.id({ description: "Unique file identifier" }),
+		name: field.string({ description: "Original file name" }),
+		mimeType: field.string({ description: "MIME type" }),
+		size: field.int({ description: "File size in bytes" }),
+		storageProvider: field.enum("StorageProvider", {
+			default: "LOCAL",
+			description: "Storage backend"
+		}),
+		storagePath: field.string({ description: "Path in storage backend" }),
+		storageKey: field.string({
+			isOptional: true,
+			description: "Storage key/bucket"
+		}),
+		checksum: field.string({
+			isOptional: true,
+			description: "SHA-256 checksum"
+		}),
+		etag: field.string({
+			isOptional: true,
+			description: "Storage ETag"
+		}),
+		status: field.enum("FileStatus", {
+			default: "PENDING",
+			description: "File status"
+		}),
+		isPublic: field.boolean({
+			default: false,
+			description: "Whether file is publicly accessible"
+		}),
+		expiresAt: field.dateTime({
+			isOptional: true,
+			description: "Auto-delete timestamp"
+		}),
+		ownerId: field.string({ description: "User who uploaded" }),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Additional metadata"
+		}),
+		tags: field.json({
+			isOptional: true,
+			description: "Tags for categorization"
+		}),
+		width: field.int({
+			isOptional: true,
+			description: "Image width in pixels"
+		}),
+		height: field.int({
+			isOptional: true,
+			description: "Image height in pixels"
+		}),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		versions: field.hasMany("FileVersion"),
+		attachments: field.hasMany("Attachment")
+	},
+	indexes: [
+		index.on(["ownerId"]),
+		index.on(["orgId"]),
+		index.on(["status"]),
+		index.on(["mimeType"]),
+		index.on(["storageProvider", "storagePath"])
+	],
+	enums: [StorageProviderEnum, FileStatusEnum]
+});
+/**
+* FileVersion entity - version history for files.
+*/
+const FileVersionEntity = defineEntity({
+	name: "FileVersion",
+	description: "A version of a file.",
+	schema: "lssm_files",
+	map: "file_version",
+	fields: {
+		id: field.id({ description: "Unique version identifier" }),
+		fileId: field.foreignKey({ description: "Parent file" }),
+		version: field.int({ description: "Version number" }),
+		size: field.int({ description: "Version size in bytes" }),
+		storagePath: field.string({ description: "Path in storage backend" }),
+		checksum: field.string({
+			isOptional: true,
+			description: "SHA-256 checksum"
+		}),
+		comment: field.string({
+			isOptional: true,
+			description: "Version comment"
+		}),
+		changes: field.json({
+			isOptional: true,
+			description: "Change description"
+		}),
+		createdBy: field.string({ description: "User who created version" }),
+		createdAt: field.createdAt(),
+		file: field.belongsTo("File", ["fileId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [index.on(["fileId", "version"]), index.unique(["fileId", "version"], { name: "file_version_unique" })]
+});
+/**
+* Attachment entity - polymorphic link between files and entities.
+*/
+const AttachmentEntity = defineEntity({
+	name: "Attachment",
+	description: "Links a file to an entity.",
+	schema: "lssm_files",
+	map: "attachment",
+	fields: {
+		id: field.id({ description: "Unique attachment identifier" }),
+		fileId: field.foreignKey({ description: "Attached file" }),
+		entityType: field.string({ description: "Target entity type (deal, listing, etc.)" }),
+		entityId: field.string({ description: "Target entity ID" }),
+		attachmentType: field.string({
+			isOptional: true,
+			description: "Type of attachment (document, image, avatar, etc.)"
+		}),
+		name: field.string({
+			isOptional: true,
+			description: "Display name (overrides file name)"
+		}),
+		description: field.string({
+			isOptional: true,
+			description: "Attachment description"
+		}),
+		order: field.int({
+			default: 0,
+			description: "Display order"
+		}),
+		metadata: field.json({
+			isOptional: true,
+			description: "Attachment-specific metadata"
+		}),
+		createdBy: field.string({ description: "User who created attachment" }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt(),
+		file: field.belongsTo("File", ["fileId"], ["id"], { onDelete: "Cascade" })
+	},
+	indexes: [
+		index.on(["entityType", "entityId"]),
+		index.on(["fileId"]),
+		index.on([
+			"entityType",
+			"entityId",
+			"attachmentType"
+		]),
+		index.unique([
+			"fileId",
+			"entityType",
+			"entityId"
+		], { name: "attachment_unique" })
+	]
+});
+/**
+* UploadSession entity - tracks multipart uploads.
+*/
+const UploadSessionEntity = defineEntity({
+	name: "UploadSession",
+	description: "Tracks a multipart upload session.",
+	schema: "lssm_files",
+	map: "upload_session",
+	fields: {
+		id: field.id({ description: "Unique session identifier" }),
+		fileName: field.string({ description: "Target file name" }),
+		mimeType: field.string({ description: "Expected MIME type" }),
+		totalSize: field.int({ description: "Total file size" }),
+		uploadId: field.string({
+			isOptional: true,
+			description: "Storage upload ID"
+		}),
+		uploadedBytes: field.int({
+			default: 0,
+			description: "Bytes uploaded so far"
+		}),
+		uploadedParts: field.json({
+			isOptional: true,
+			description: "Completed part info"
+		}),
+		status: field.string({
+			default: "\"pending\"",
+			description: "Session status"
+		}),
+		error: field.string({
+			isOptional: true,
+			description: "Error message if failed"
+		}),
+		fileId: field.string({
+			isOptional: true,
+			description: "Resulting file ID"
+		}),
+		ownerId: field.string({ description: "User who initiated upload" }),
+		orgId: field.string({
+			isOptional: true,
+			description: "Organization scope"
+		}),
+		expiresAt: field.dateTime({ description: "Session expiry time" }),
+		createdAt: field.createdAt(),
+		updatedAt: field.updatedAt()
+	},
+	indexes: [index.on(["status", "expiresAt"]), index.on(["ownerId"])]
+});
+/**
+* All file entities for schema composition.
+*/
+const fileEntities = [
+	FileEntity,
+	FileVersionEntity,
+	AttachmentEntity,
+	UploadSessionEntity
+];
+/**
+* Module schema contribution for files.
+*/
+const filesSchemaContribution = {
+	moduleId: "@contractspec/lib.files",
+	entities: fileEntities,
+	enums: [StorageProviderEnum, FileStatusEnum]
+};
+
+//#endregion
+export { AttachmentEntity, FileEntity, FileStatusEnum, FileVersionEntity, StorageProviderEnum, UploadSessionEntity, fileEntities, filesSchemaContribution };
+//# sourceMappingURL=index.js.map

package/dist/entities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":["filesSchemaContribution: ModuleSchemaContribution"],"sources":["../../src/entities/index.ts"],"sourcesContent":["import {\n  defineEntity,\n  defineEntityEnum,\n  field,\n  index,\n} from '@contractspec/lib.schema';\nimport type { ModuleSchemaContribution } from '@contractspec/lib.schema';\n\n/**\n * Storage provider enum.\n */\nexport const StorageProviderEnum = defineEntityEnum({\n  name: 'StorageProvider',\n  values: ['LOCAL', 'S3', 'GCS', 'AZURE', 'CLOUDFLARE'] as const,\n  schema: 'lssm_files',\n  description: 'Storage backend provider.',\n});\n\n/**\n * File status enum.\n */\nexport const FileStatusEnum = defineEntityEnum({\n  name: 'FileStatus',\n  values: [\n    'PENDING',\n    'UPLOADED',\n    'PROCESSING',\n    'READY',\n    'ERROR',\n    'DELETED',\n  ] as const,\n  schema: 'lssm_files',\n  description: 'File processing status.',\n});\n\n/**\n * File entity - represents an uploaded file.\n */\nexport const FileEntity = defineEntity({\n  name: 'File',\n  description: 'An uploaded file.',\n  schema: 'lssm_files',\n  map: 'file',\n  fields: {\n    id: field.id({ description: 'Unique file identifier' }),\n\n    // File info\n    name: field.string({ description: 'Original file name' }),\n    mimeType: field.string({ description: 'MIME type' }),\n    size: field.int({ description: 'File size in bytes' }),\n\n    // Storage\n    storageProvider: field.enum('StorageProvider', {\n      default: 'LOCAL',\n      description: 'Storage backend',\n    }),\n    storagePath: field.string({ description: 'Path in storage backend' }),\n    storageKey: field.string({\n      isOptional: true,\n      description: 'Storage key/bucket',\n    }),\n\n    // Integrity\n    checksum: field.string({\n      isOptional: true,\n      description: 'SHA-256 checksum',\n    }),\n    etag: field.string({ isOptional: true, description: 'Storage ETag' }),\n\n    // Status\n    status: field.enum('FileStatus', {\n      default: 'PENDING',\n      description: 'File status',\n    }),\n\n    // Access\n    isPublic: field.boolean({\n      default: false,\n      description: 'Whether file is publicly accessible',\n    }),\n    expiresAt: field.dateTime({\n      isOptional: true,\n      description: 'Auto-delete timestamp',\n    }),\n\n    // Ownership\n    ownerId: field.string({ description: 'User who uploaded' }),\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope',\n    }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Additional metadata',\n    }),\n    tags: field.json({\n      isOptional: true,\n      description: 'Tags for categorization',\n    }),\n\n    // Image-specific\n    width: field.int({\n      isOptional: true,\n      description: 'Image width in pixels',\n    }),\n    height: field.int({\n      isOptional: true,\n      description: 'Image height in pixels',\n    }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    versions: field.hasMany('FileVersion'),\n    attachments: field.hasMany('Attachment'),\n  },\n  indexes: [\n    index.on(['ownerId']),\n    index.on(['orgId']),\n    index.on(['status']),\n    index.on(['mimeType']),\n    index.on(['storageProvider', 'storagePath']),\n  ],\n  enums: [StorageProviderEnum, FileStatusEnum],\n});\n\n/**\n * FileVersion entity - version history for files.\n */\nexport const FileVersionEntity = defineEntity({\n  name: 'FileVersion',\n  description: 'A version of a file.',\n  schema: 'lssm_files',\n  map: 'file_version',\n  fields: {\n    id: field.id({ description: 'Unique version identifier' }),\n    fileId: field.foreignKey({ description: 'Parent file' }),\n\n    // Version info\n    version: field.int({ description: 'Version number' }),\n    size: field.int({ description: 'Version size in bytes' }),\n\n    // Storage\n    storagePath: field.string({ description: 'Path in storage backend' }),\n    checksum: field.string({\n      isOptional: true,\n      description: 'SHA-256 checksum',\n    }),\n\n    // Metadata\n    comment: field.string({ isOptional: true, description: 'Version comment' }),\n    changes: field.json({\n      isOptional: true,\n      description: 'Change description',\n    }),\n\n    // Creator\n    createdBy: field.string({ description: 'User who created version' }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n\n    // Relations\n    file: field.belongsTo('File', ['fileId'], ['id'], { onDelete: 'Cascade' }),\n  },\n  indexes: [\n    index.on(['fileId', 'version']),\n    index.unique(['fileId', 'version'], { name: 'file_version_unique' }),\n  ],\n});\n\n/**\n * Attachment entity - polymorphic link between files and entities.\n */\nexport const AttachmentEntity = defineEntity({\n  name: 'Attachment',\n  description: 'Links a file to an entity.',\n  schema: 'lssm_files',\n  map: 'attachment',\n  fields: {\n    id: field.id({ description: 'Unique attachment identifier' }),\n    fileId: field.foreignKey({ description: 'Attached file' }),\n\n    // Target entity (polymorphic)\n    entityType: field.string({\n      description: 'Target entity type (deal, listing, etc.)',\n    }),\n    entityId: field.string({ description: 'Target entity ID' }),\n\n    // Attachment metadata\n    attachmentType: field.string({\n      isOptional: true,\n      description: 'Type of attachment (document, image, avatar, etc.)',\n    }),\n    name: field.string({\n      isOptional: true,\n      description: 'Display name (overrides file name)',\n    }),\n    description: field.string({\n      isOptional: true,\n      description: 'Attachment description',\n    }),\n\n    // Ordering\n    order: field.int({ default: 0, description: 'Display order' }),\n\n    // Metadata\n    metadata: field.json({\n      isOptional: true,\n      description: 'Attachment-specific metadata',\n    }),\n\n    // Creator\n    createdBy: field.string({ description: 'User who created attachment' }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n\n    // Relations\n    file: field.belongsTo('File', ['fileId'], ['id'], { onDelete: 'Cascade' }),\n  },\n  indexes: [\n    index.on(['entityType', 'entityId']),\n    index.on(['fileId']),\n    index.on(['entityType', 'entityId', 'attachmentType']),\n    index.unique(['fileId', 'entityType', 'entityId'], {\n      name: 'attachment_unique',\n    }),\n  ],\n});\n\n/**\n * UploadSession entity - tracks multipart uploads.\n */\nexport const UploadSessionEntity = defineEntity({\n  name: 'UploadSession',\n  description: 'Tracks a multipart upload session.',\n  schema: 'lssm_files',\n  map: 'upload_session',\n  fields: {\n    id: field.id({ description: 'Unique session identifier' }),\n\n    // File info\n    fileName: field.string({ description: 'Target file name' }),\n    mimeType: field.string({ description: 'Expected MIME type' }),\n    totalSize: field.int({ description: 'Total file size' }),\n\n    // Upload state\n    uploadId: field.string({\n      isOptional: true,\n      description: 'Storage upload ID',\n    }),\n    uploadedBytes: field.int({\n      default: 0,\n      description: 'Bytes uploaded so far',\n    }),\n    uploadedParts: field.json({\n      isOptional: true,\n      description: 'Completed part info',\n    }),\n\n    // Status\n    status: field.string({\n      default: '\"pending\"',\n      description: 'Session status',\n    }),\n    error: field.string({\n      isOptional: true,\n      description: 'Error message if failed',\n    }),\n\n    // Result\n    fileId: field.string({\n      isOptional: true,\n      description: 'Resulting file ID',\n    }),\n\n    // Context\n    ownerId: field.string({ description: 'User who initiated upload' }),\n    orgId: field.string({\n      isOptional: true,\n      description: 'Organization scope',\n    }),\n\n    // Expiry\n    expiresAt: field.dateTime({ description: 'Session expiry time' }),\n\n    // Timestamps\n    createdAt: field.createdAt(),\n    updatedAt: field.updatedAt(),\n  },\n  indexes: [index.on(['status', 'expiresAt']), index.on(['ownerId'])],\n});\n\n/**\n * All file entities for schema composition.\n */\nexport const fileEntities = [\n  FileEntity,\n  FileVersionEntity,\n  AttachmentEntity,\n  UploadSessionEntity,\n];\n\n/**\n * Module schema contribution for files.\n */\nexport const filesSchemaContribution: ModuleSchemaContribution = {\n  moduleId: '@contractspec/lib.files',\n  entities: fileEntities,\n  enums: [StorageProviderEnum, FileStatusEnum],\n};\n"],"mappings":"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"}