@abyss-project/tools 1.0.5 → 1.2.0

package/src/types/enum/api-error.enum.ts

@@ -1,23 +1,23 @@
-export enum ErrorType {
-  apiError = 'api_error',
-  authError = 'authentication_error',
-  resourceError = 'resource_error',
-}
-
-export enum Code {
-  // HTTP Error
-  tokenFailure = 'token_authentication_failure',
-  authenticationFailure = 'authentication_credentials_failure',
-  accessNotAllowed = 'access_not_allowed',
-  notFound = 'not_found',
-  validationError = 'resource_validation_error',
-  constraintError = 'resource_constraint_error',
-  internalServerError = 'internal_server_error',
-  serviceUnavailable = 'service_unavailable',
-  invalidData = 'invalid_data',
-  notImplemented = 'not_implemented',
-  retrospectiveCannotBeModifiedWhenCompleted = 'retrospective_cannot_be_modified_when_completed',
-  atlasDocumentLimitReached = 'atlas_document_limit_reached',
-  boardCardDocumentLimitReached = 'board_card_document_limit_reached',
-  boardCardMoveInvalidDestination = 'board_card_move_invalid_destination',
-}
+export enum ErrorType {
+  apiError = 'api_error',
+  authError = 'authentication_error',
+  resourceError = 'resource_error',
+}
+
+export enum Code {
+  // HTTP Error
+  tokenFailure = 'token_authentication_failure',
+  authenticationFailure = 'authentication_credentials_failure',
+  accessNotAllowed = 'access_not_allowed',
+  notFound = 'not_found',
+  validationError = 'resource_validation_error',
+  constraintError = 'resource_constraint_error',
+  internalServerError = 'internal_server_error',
+  serviceUnavailable = 'service_unavailable',
+  invalidData = 'invalid_data',
+  notImplemented = 'not_implemented',
+  retrospectiveCannotBeModifiedWhenCompleted = 'retrospective_cannot_be_modified_when_completed',
+  atlasDocumentLimitReached = 'atlas_document_limit_reached',
+  boardCardDocumentLimitReached = 'board_card_document_limit_reached',
+  boardCardMoveInvalidDestination = 'board_card_move_invalid_destination',
+}

package/src/types/enum/beam.enum.ts

@@ -0,0 +1,24 @@
+// AbyssBeam transfer visibility (design D7). PUBLIC = a contentShare LINK so the
+// /b/:slug link works for anyone until expiry; RESTRICTED = USER/ORG/TEAM/PROJECT
+// grants resolved via contentShare.resolveAccess (>= VIEW). Password is an
+// independent second factor, NOT a visibility level.
+export enum BeamVisibility {
+  PUBLIC = 'PUBLIC',
+  RESTRICTED = 'RESTRICTED',
+}
+
+// Machine-readable denial reason returned on the public serving discovery path
+// (GET /b/:slug) so the front renders the correct state from the reason code
+// rather than inferring it from the bare HTTP status (spec §17.1). Mirrors the
+// backend `BeamServeDenyReason`; only the non-password discovery denials are
+// surfaced here (PASSWORD_REQUIRED is not a VIEW denial — the metadata is still
+// returned with isLocked=true). Byte endpoints (/file, /raw, /thumb, /zip) stay
+// bare-status by design (CDN-visible), so this reason is a VIEW-only signal.
+export enum BeamServeDenyReasonCode {
+  NOT_FOUND = 'not_found',
+  EXPIRED = 'expired',
+  FORBIDDEN_VISIBILITY = 'forbidden_visibility',
+  MAX_DOWNLOADS = 'max_downloads',
+  SCAN_PENDING = 'scan_pending',
+  SCAN_INFECTED = 'scan_infected',
+}

package/src/types/enum/board-activity.enum.ts

@@ -1,189 +1,189 @@
-export enum BoardActivityType {
-  CARD_CREATE = 'CARD_CREATE',
-  CARD_UPDATE = 'CARD_UPDATE',
-  CARD_ARCHIVE = 'CARD_ARCHIVE',
-  CARD_RESTORE = 'CARD_RESTORE',
-  CARD_MOVE_COLUMN = 'CARD_MOVE_COLUMN',
-  CARD_MOVE_BOARD = 'CARD_MOVE_BOARD',
-
-  COLUMN_CREATE = 'COLUMN_CREATE',
-  COLUMN_UPDATE = 'COLUMN_UPDATE',
-  COLUMN_DELETE = 'COLUMN_DELETE',
-
-  COMMENT_CREATE = 'COMMENT_CREATE',
-  COMMENT_UPDATE = 'COMMENT_UPDATE',
-  COMMENT_DELETE = 'COMMENT_DELETE',
-
-  LABEL_CREATE = 'LABEL_CREATE',
-  LABEL_DELETE = 'LABEL_DELETE',
-  LABEL_UPDATE = 'LABEL_UPDATE',
-  LABEL_ADD = 'LABEL_ADD',
-  LABEL_REMOVE = 'LABEL_REMOVE',
-
-  MEMBER_ADD = 'MEMBER_ADD',
-  MEMBER_REMOVE = 'MEMBER_REMOVE',
-
-  CHECKLIST_CREATE = 'CHECKLIST_CREATE',
-  CHECKLIST_UPDATE = 'CHECKLIST_UPDATE',
-  CHECKLIST_DELETE = 'CHECKLIST_DELETE',
-  CHECKLIST_ITEM_ADD = 'CHECKLIST_ITEM_ADD',
-  CHECKLIST_ITEM_UPDATE = 'CHECKLIST_ITEM_UPDATE',
-  CHECKLIST_ITEM_DELETE = 'CHECKLIST_ITEM_DELETE',
-
-  DOCUMENT_ADD = 'DOCUMENT_ADD',
-  DOCUMENT_REMOVE = 'DOCUMENT_REMOVE',
-}
-
-type ValueOf<T> = T[keyof T];
-
-export type BoardActivityDataContent = ValueOf<
-  {
-    [K in BoardActivityType]: {
-      type: K;
-      payload: BoardActivityData[K];
-    };
-  }
->;
-
-export class BoardActivityData
-  implements Record<BoardActivityType, Record<string, string | number | Date | boolean>>
-{
-  [BoardActivityType.CARD_CREATE]!: {
-    boardCardName: string;
-    boardCardId: string;
-    boardColumnName: string;
-    boardColumnId: string;
-  };
-  [BoardActivityType.CARD_UPDATE]!: {
-    boardCardName: string;
-    boardCardId: string;
-  };
-  [BoardActivityType.CARD_ARCHIVE]!: {
-    boardCardId: string;
-  };
-  [BoardActivityType.CARD_RESTORE]!: {
-    boardCardId: string;
-  };
-  [BoardActivityType.CARD_MOVE_COLUMN]!: {
-    boardCardName: string;
-    boardCardId: string;
-    toBoardColumnId: string;
-    toBoardColumnName: string;
-  };
-  [BoardActivityType.CARD_MOVE_BOARD]!: {
-    boardCardName: string;
-    boardCardId: string;
-    toBoardColumnId: string;
-    toBoardColumnName: string;
-    toBoardId: string;
-    toBoardName: string;
-  };
-
-  [BoardActivityType.COLUMN_CREATE]!: {
-    boardColumnName: string;
-    boardColumnId: string;
-  };
-  [BoardActivityType.COLUMN_UPDATE]!: {
-    boardColumnName: string;
-    boardColumnId: string;
-  };
-  [BoardActivityType.COLUMN_DELETE]!: {
-    boardColumnId: string;
-  };
-
-  [BoardActivityType.COMMENT_CREATE]!: {
-    boardCardCommentId: string;
-    boardCardId: string;
-  };
-  [BoardActivityType.COMMENT_UPDATE]!: {
-    boardCardCommentId: string;
-    fromBoardCardCommentContent: string;
-    toBoardCardCommentContent: string;
-    boardCardId: string;
-  };
-  [BoardActivityType.COMMENT_DELETE]!: {
-    boardCardCommentId: string;
-    boardCardId: string;
-  };
-
-  [BoardActivityType.LABEL_CREATE]!: {
-    boardLabelId: string;
-    boardLabelName: string;
-    boardLabelColor: string;
-  };
-  [BoardActivityType.LABEL_DELETE]!: {
-    boardLabelId: string;
-  };
-  [BoardActivityType.LABEL_UPDATE]!: {
-    boardLabelId: string;
-    boardLabelName: string;
-    boardLabelColor: string;
-  };
-
-  [BoardActivityType.LABEL_ADD]!: {
-    boardLabelId: string;
-    boardCardId: string;
-    boardLabelName: string;
-  };
-  [BoardActivityType.LABEL_REMOVE]!: {
-    boardLabelId: string;
-    boardCardId: string;
-    boardLabelName: string;
-  };
-
-  [BoardActivityType.MEMBER_ADD]!: {
-    boardCardId: string;
-    userId: string;
-  };
-  [BoardActivityType.MEMBER_REMOVE]!: {
-    boardCardId: string;
-    userId: string;
-  };
-
-  [BoardActivityType.CHECKLIST_CREATE]!: {
-    boardCardId: string;
-    boardCardChecklistId: string;
-    boardCardChecklistName: string;
-  };
-  [BoardActivityType.CHECKLIST_UPDATE]!: {
-    boardCardId: string;
-    boardCardChecklistId: string;
-    boardCardChecklistName: string;
-  };
-  [BoardActivityType.CHECKLIST_DELETE]!: {
-    boardCardId: string;
-    boardCardChecklistId: string;
-    boardCardChecklistName: string;
-  };
-  [BoardActivityType.CHECKLIST_ITEM_ADD]!: {
-    boardCardId: string;
-    boardCardChecklistId: string;
-    boardCardChecklistItemId: string;
-    boardCardChecklistItemContent: string;
-    boardCardChecklistName: string;
-  };
-  [BoardActivityType.CHECKLIST_ITEM_UPDATE]!: {
-    boardCardId: string;
-    boardCardChecklistId: string;
-    boardCardChecklistItemId: string;
-    boardCardChecklistName: string;
-  };
-  [BoardActivityType.CHECKLIST_ITEM_DELETE]!: {
-    boardCardId: string;
-    boardCardChecklistId: string;
-    boardCardChecklistItemId: string;
-    boardCardChecklistName: string;
-    boardCardChecklistItemContent: string;
-  };
-
-  [BoardActivityType.DOCUMENT_ADD]!: {
-    boardCardId: string;
-    boardCardDocumentId: string;
-    boardCardDocumentName: string;
-  };
-  [BoardActivityType.DOCUMENT_REMOVE]!: {
-    boardCardId: string;
-    boardCardDocumentId: string;
-    boardCardDocumentName: string;
-  };
-}
+export enum BoardActivityType {
+  CARD_CREATE = 'CARD_CREATE',
+  CARD_UPDATE = 'CARD_UPDATE',
+  CARD_ARCHIVE = 'CARD_ARCHIVE',
+  CARD_RESTORE = 'CARD_RESTORE',
+  CARD_MOVE_COLUMN = 'CARD_MOVE_COLUMN',
+  CARD_MOVE_BOARD = 'CARD_MOVE_BOARD',
+
+  COLUMN_CREATE = 'COLUMN_CREATE',
+  COLUMN_UPDATE = 'COLUMN_UPDATE',
+  COLUMN_DELETE = 'COLUMN_DELETE',
+
+  COMMENT_CREATE = 'COMMENT_CREATE',
+  COMMENT_UPDATE = 'COMMENT_UPDATE',
+  COMMENT_DELETE = 'COMMENT_DELETE',
+
+  LABEL_CREATE = 'LABEL_CREATE',
+  LABEL_DELETE = 'LABEL_DELETE',
+  LABEL_UPDATE = 'LABEL_UPDATE',
+  LABEL_ADD = 'LABEL_ADD',
+  LABEL_REMOVE = 'LABEL_REMOVE',
+
+  MEMBER_ADD = 'MEMBER_ADD',
+  MEMBER_REMOVE = 'MEMBER_REMOVE',
+
+  CHECKLIST_CREATE = 'CHECKLIST_CREATE',
+  CHECKLIST_UPDATE = 'CHECKLIST_UPDATE',
+  CHECKLIST_DELETE = 'CHECKLIST_DELETE',
+  CHECKLIST_ITEM_ADD = 'CHECKLIST_ITEM_ADD',
+  CHECKLIST_ITEM_UPDATE = 'CHECKLIST_ITEM_UPDATE',
+  CHECKLIST_ITEM_DELETE = 'CHECKLIST_ITEM_DELETE',
+
+  DOCUMENT_ADD = 'DOCUMENT_ADD',
+  DOCUMENT_REMOVE = 'DOCUMENT_REMOVE',
+}
+
+type ValueOf<T> = T[keyof T];
+
+export type BoardActivityDataContent = ValueOf<
+  {
+    [K in BoardActivityType]: {
+      type: K;
+      payload: BoardActivityData[K];
+    };
+  }
+>;
+
+export class BoardActivityData
+  implements Record<BoardActivityType, Record<string, string | number | Date | boolean>>
+{
+  [BoardActivityType.CARD_CREATE]!: {
+    boardCardName: string;
+    boardCardId: string;
+    boardColumnName: string;
+    boardColumnId: string;
+  };
+  [BoardActivityType.CARD_UPDATE]!: {
+    boardCardName: string;
+    boardCardId: string;
+  };
+  [BoardActivityType.CARD_ARCHIVE]!: {
+    boardCardId: string;
+  };
+  [BoardActivityType.CARD_RESTORE]!: {
+    boardCardId: string;
+  };
+  [BoardActivityType.CARD_MOVE_COLUMN]!: {
+    boardCardName: string;
+    boardCardId: string;
+    toBoardColumnId: string;
+    toBoardColumnName: string;
+  };
+  [BoardActivityType.CARD_MOVE_BOARD]!: {
+    boardCardName: string;
+    boardCardId: string;
+    toBoardColumnId: string;
+    toBoardColumnName: string;
+    toBoardId: string;
+    toBoardName: string;
+  };
+
+  [BoardActivityType.COLUMN_CREATE]!: {
+    boardColumnName: string;
+    boardColumnId: string;
+  };
+  [BoardActivityType.COLUMN_UPDATE]!: {
+    boardColumnName: string;
+    boardColumnId: string;
+  };
+  [BoardActivityType.COLUMN_DELETE]!: {
+    boardColumnId: string;
+  };
+
+  [BoardActivityType.COMMENT_CREATE]!: {
+    boardCardCommentId: string;
+    boardCardId: string;
+  };
+  [BoardActivityType.COMMENT_UPDATE]!: {
+    boardCardCommentId: string;
+    fromBoardCardCommentContent: string;
+    toBoardCardCommentContent: string;
+    boardCardId: string;
+  };
+  [BoardActivityType.COMMENT_DELETE]!: {
+    boardCardCommentId: string;
+    boardCardId: string;
+  };
+
+  [BoardActivityType.LABEL_CREATE]!: {
+    boardLabelId: string;
+    boardLabelName: string;
+    boardLabelColor: string;
+  };
+  [BoardActivityType.LABEL_DELETE]!: {
+    boardLabelId: string;
+  };
+  [BoardActivityType.LABEL_UPDATE]!: {
+    boardLabelId: string;
+    boardLabelName: string;
+    boardLabelColor: string;
+  };
+
+  [BoardActivityType.LABEL_ADD]!: {
+    boardLabelId: string;
+    boardCardId: string;
+    boardLabelName: string;
+  };
+  [BoardActivityType.LABEL_REMOVE]!: {
+    boardLabelId: string;
+    boardCardId: string;
+    boardLabelName: string;
+  };
+
+  [BoardActivityType.MEMBER_ADD]!: {
+    boardCardId: string;
+    userId: string;
+  };
+  [BoardActivityType.MEMBER_REMOVE]!: {
+    boardCardId: string;
+    userId: string;
+  };
+
+  [BoardActivityType.CHECKLIST_CREATE]!: {
+    boardCardId: string;
+    boardCardChecklistId: string;
+    boardCardChecklistName: string;
+  };
+  [BoardActivityType.CHECKLIST_UPDATE]!: {
+    boardCardId: string;
+    boardCardChecklistId: string;
+    boardCardChecklistName: string;
+  };
+  [BoardActivityType.CHECKLIST_DELETE]!: {
+    boardCardId: string;
+    boardCardChecklistId: string;
+    boardCardChecklistName: string;
+  };
+  [BoardActivityType.CHECKLIST_ITEM_ADD]!: {
+    boardCardId: string;
+    boardCardChecklistId: string;
+    boardCardChecklistItemId: string;
+    boardCardChecklistItemContent: string;
+    boardCardChecklistName: string;
+  };
+  [BoardActivityType.CHECKLIST_ITEM_UPDATE]!: {
+    boardCardId: string;
+    boardCardChecklistId: string;
+    boardCardChecklistItemId: string;
+    boardCardChecklistName: string;
+  };
+  [BoardActivityType.CHECKLIST_ITEM_DELETE]!: {
+    boardCardId: string;
+    boardCardChecklistId: string;
+    boardCardChecklistItemId: string;
+    boardCardChecklistName: string;
+    boardCardChecklistItemContent: string;
+  };
+
+  [BoardActivityType.DOCUMENT_ADD]!: {
+    boardCardId: string;
+    boardCardDocumentId: string;
+    boardCardDocumentName: string;
+  };
+  [BoardActivityType.DOCUMENT_REMOVE]!: {
+    boardCardId: string;
+    boardCardDocumentId: string;
+    boardCardDocumentName: string;
+  };
+}

package/src/types/enum/board-column-type.enum.ts

@@ -1,6 +1,6 @@
-export enum BoardColumnType {
-  CONCEPTION = 'CONCEPTION',
-  BACKLOG = 'BACKLOG',
-  DOING = 'DOING',
-  DONE = 'DONE',
-}
+export enum BoardColumnType {
+  CONCEPTION = 'CONCEPTION',
+  BACKLOG = 'BACKLOG',
+  DOING = 'DOING',
+  DONE = 'DONE',
+}

package/src/types/enum/combine-strategy.enum.ts

@@ -0,0 +1,7 @@
+// Combine strategy enum — mirror apps/api plan.types.ts exactly.
+
+export enum CombineStrategy {
+  MAX_CONFIDENCE = 'maxConfidence',
+  FIRST_WINS = 'firstWins',
+  VOTE = 'vote',
+}

package/src/types/enum/content-share.enum.ts

@@ -1,36 +1,38 @@
-export enum ShareableContentType {
-  DRAW = 'draw',
-  BOARD = 'board',
-  MEMO = 'memo',
-  ATLAS = 'atlas',
-  RETROSPECTIVE = 'retrospective',
-  SHORT_LINK = 'short_link',
-  CLOUD_FILE = 'cloud_file',
-  CLOUD_FOLDER = 'cloud_folder',
-  CLOUD_GALLERY = 'cloud_gallery',
-  FORM = 'form',
-  SPOTLIGHT_PROJECT = 'spotlight_project',
-  EVENT = 'event',
-  REPORT = 'report',
-  PDF = 'pdf',
-}
-
-export enum ShareTargetType {
-  USER = 'USER',
-  TEAM = 'TEAM',
-  ORGANIZATION = 'ORGANIZATION',
-  LINK = 'LINK',
-}
-
-export enum SharePermission {
-  VIEW = 'VIEW',
-  EDIT = 'EDIT',
-  MANAGE = 'MANAGE',
-}
-
-export enum ContentShareScope {
-  ORGANIZATION = 'ORGANIZATION',
-  ORG_USER = 'ORG_USER',
-  ORG_TEAM = 'ORG_TEAM',
-  ORG_PROJECT = 'ORG_PROJECT',
-}
+export enum ShareableContentType {
+  DRAW = 'draw',
+  BOARD = 'board',
+  MEMO = 'memo',
+  ATLAS = 'atlas',
+  RETROSPECTIVE = 'retrospective',
+  SHORT_LINK = 'short_link',
+  CLOUD_FILE = 'cloud_file',
+  CLOUD_FOLDER = 'cloud_folder',
+  CLOUD_GALLERY = 'cloud_gallery',
+  FORM = 'form',
+  SPOTLIGHT_PROJECT = 'spotlight_project',
+  EVENT = 'event',
+  REPORT = 'report',
+  PDF = 'pdf',
+  BEAM = 'beam',
+}
+
+export enum ShareTargetType {
+  USER = 'USER',
+  TEAM = 'TEAM',
+  ORGANIZATION = 'ORGANIZATION',
+  PROJECT = 'PROJECT',
+  LINK = 'LINK',
+}
+
+export enum SharePermission {
+  VIEW = 'VIEW',
+  EDIT = 'EDIT',
+  MANAGE = 'MANAGE',
+}
+
+export enum ContentShareScope {
+  ORGANIZATION = 'ORGANIZATION',
+  ORG_USER = 'ORG_USER',
+  ORG_TEAM = 'ORG_TEAM',
+  ORG_PROJECT = 'ORG_PROJECT',
+}

package/src/types/enum/document-type.enum.ts

@@ -0,0 +1,10 @@
+// Document types supported by AbyssExtract. bank_statement is the legacy RCB profile.
+export enum DocumentType {
+  BANK_STATEMENT = 'bank_statement',
+  INVOICE = 'invoice',
+  RECEIPT = 'receipt',
+  ID_CARD = 'id_card',
+  RIB = 'rib',
+  FINANCIAL_STATEMENT = 'financial_statement',
+  GENERIC = 'generic',
+}

package/src/types/enum/extraction-feedback-issue-type.enum.ts

@@ -0,0 +1,10 @@
+// Global, document-type-agnostic feedback issue taxonomy for AbyssExtract.
+// fieldKey localizes the issue to a specific extracted field when relevant.
+export enum ExtractionFeedbackIssueType {
+  WRONG_VALUE = 'WRONG_VALUE',
+  MISSING_FIELD = 'MISSING_FIELD',
+  WRONG_DOCUMENT_TYPE = 'WRONG_DOCUMENT_TYPE',
+  EXTRA_RECORD = 'EXTRA_RECORD',
+  WRONG_RECORD = 'WRONG_RECORD',
+  OTHER = 'OTHER',
+}

package/src/types/enum/extraction-warning.enum.ts

@@ -0,0 +1,21 @@
+// ──────────────────────────────────────────────
+// ExtractionWarningCode — structured warning codes emitted by the extraction
+// orchestrator. The `code` is the i18n key suffix; `data` carries numeric/
+// string values the UI formats locally (currencies, dates, etc.).
+// ──────────────────────────────────────────────
+
+export enum ExtractionWarningCode {
+  NO_RECORDS = 'no_records',
+  NO_IBAN = 'no_iban',
+  NO_BALANCES = 'no_balances',
+  BALANCE_MISMATCH = 'balance_mismatch',
+  /**
+   * A coherence validation error produced by an adapter's `validate()` call.
+   * `data.type` carries the adapter-specific error/warning type (e.g.
+   * `ACTIF_PASSIF_MISMATCH`, `TOTAL_MISMATCH`, `MRZ_INVALID`) and
+   * `data.message` carries the human-readable explanation. This allows
+   * arbitrary adapter validation results to surface without extending the
+   * enum for each domain-specific rule.
+   */
+  ADAPTER_VALIDATION_ERROR = 'adapter_validation_error',
+}

package/src/types/enum/index.ts

@@ -1,6 +1,13 @@
-export * from './api-error.enum';
-export * from './board-activity.enum';
-export * from './board-column-type.enum';
-export * from './content-share.enum';
-export * from './pdf-operation.enum';
-export * from './rcb-bank.enum';
+export * from './api-error.enum';
+export * from './board-activity.enum';
+export * from './board-column-type.enum';
+export * from './content-share.enum';
+export * from './beam.enum';
+export * from './document-type.enum';
+export * from './pdf-operation.enum';
+export * from './rcb-bank.enum';
+export * from './extraction-warning.enum';
+export * from './extraction-feedback-issue-type.enum';
+export * from './provider-kind.enum';
+export * from './interpreter-kind.enum';
+export * from './combine-strategy.enum';

package/src/types/enum/interpreter-kind.enum.ts

@@ -0,0 +1,7 @@
+// Interpreter kind enum — mirror apps/api interpreter.interface.ts exactly.
+
+export enum InterpreterKind {
+  ALGORITHMIC = 'algorithmic',
+  TEMPLATE = 'template',
+  LLM = 'llm',
+}