@lssm/lib.files 0.0.0-canary-20251217063201 → 0.0.0-canary-20251217073102

package/dist/docs/files.docblock.js

@@ -1,4 +1,21 @@
-import{a as e}from"../contracts/dist/docs/registry.js";import"../contracts/dist/docs/index.js";e([{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
+import { registerDocBlocks } from "../contracts/dist/docs/registry.js";
+import "../contracts/dist/docs/index.js";
+
+//#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.
@@ -48,4 +65,7 @@ await AttachFileContract; // register in spec to enable attach flows
 - 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

package/dist/docs/index.js

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

package/dist/entities/index.d.ts

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

package/dist/entities/index.js

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