@abyss-project/tools 3.0.0 → 3.2.0

package/src/types/interface/api/responses/short-link.admin.response.ts

@@ -10,6 +10,7 @@ export interface IGetShortLinkAdminData {
 }
 export type IGetShortLinkAdminResponse = IResponse<IGetShortLinkAdminData>;
 
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface IDeleteShortLinkAdminData {}
 export type IDeleteShortLinkAdminResponse = IResponse<IDeleteShortLinkAdminData>;
 

package/src/types/interface/api/responses/short-link.response.ts

@@ -20,6 +20,7 @@ export interface IUpdateShortLinkData {
 }
 export type IUpdateShortLinkResponse = IResponse<IUpdateShortLinkData>;
 
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface IDeleteShortLinkData {}
 export type IDeleteShortLinkResponse = IResponse<IDeleteShortLinkData>;
 

package/src/types/interface/api/responses/tag.response.ts

@@ -16,6 +16,7 @@ export interface IUpdateTagData {
 }
 export type IUpdateTagResponse = IResponse<IUpdateTagData>;
 
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface IDeleteTagData {}
 export type IDeleteTagResponse = IResponse<IDeleteTagData>;
 
@@ -24,6 +25,7 @@ export interface IAssignTagData {
 }
 export type IAssignTagResponse = IResponse<IAssignTagData>;
 
+// eslint-disable-next-line @typescript-eslint/no-empty-object-type
 export interface IUnassignTagData {}
 export type IUnassignTagResponse = IResponse<IUnassignTagData>;
 

package/src/types/interface/models/content-share.dto.ts

@@ -1,4 +1,8 @@
-import { ShareableContentType, SharePermission, ShareTargetType } from '../../enum/content-share.enum';
+import {
+  ShareableContentType,
+  SharePermission,
+  ShareTargetType,
+} from '../../enum/content-share.enum';
 
 export interface IContentShare {
   id: string;

package/src/types/interface/models/extraction-fetched-provenance.dto.test.ts

@@ -80,14 +80,16 @@ for (const sig of fvWithSignals.signals) {
   if (sig.kind === 'format' || sig.kind === 'coherence') {
     const _check: string = sig.check;
     const _passed: boolean = sig.passed;
-    void _check; void _passed;
+    void _check;
+    void _passed;
   } else if (sig.kind === 'anchor') {
     const _detail: string = sig.detail;
     void _detail;
   } else {
     const _agreed: boolean = sig.agreed;
     const _modes: number = sig.modes;
-    void _agreed; void _modes;
+    void _agreed;
+    void _modes;
   }
 }
 
@@ -102,7 +104,12 @@ const manifest: IExecutionManifest = {
   },
   combine: CombineStrategy.MAX_CONFIDENCE,
   passes: [
-    { providerId: 'pdf-auto', providerVersion: '1.0.0', interpreterId: 'algo-v1', interpreterVersion: '1.0.0' },
+    {
+      providerId: 'pdf-auto',
+      providerVersion: '1.0.0',
+      interpreterId: 'algo-v1',
+      interpreterVersion: '1.0.0',
+    },
   ],
   createdAt: '2026-06-28T00:00:00.000Z',
 };
@@ -154,12 +161,13 @@ const totalTtc = (fetched.fieldsJson ?? {}).totalTtc;
 if (totalTtc) {
   const _chosenId: string = totalTtc.chosen.interpreterId;
   const _sourceCount: number = totalTtc.sources.length;
-  void _chosenId; void _sourceCount;
+  void _chosenId;
+  void _sourceCount;
 }
 
 // Backward-compat: an old reader that only knows value+confidence still works.
-const _legacyRead: { value: unknown; confidence: number } | undefined =
-  (fetched.fieldsJson ?? {}).totalTtc;
+const _legacyRead: { value: unknown; confidence: number } | undefined = (fetched.fieldsJson ?? {})
+  .totalTtc;
 void _legacyRead;
 
 // The GET extraction response data exposes the same superset under `fields`
@@ -174,7 +182,8 @@ void getData;
 // usedOcr/ocrPageCount remain readable as before.
 const _usedOcr: boolean | undefined = fetched.usedOcr;
 const _ocrPages: number | undefined = fetched.ocrPageCount;
-void _usedOcr; void _ocrPages;
+void _usedOcr;
+void _ocrPages;
 
 // A CONSUMER reads the manifest + globalConfidence fields that the backend
 // actually persists/surfaces (createdAt — NOT resolvedAt — and the stats block),
@@ -182,12 +191,14 @@ void _usedOcr; void _ocrPages;
 if (fetched.executionManifest) {
   const _createdAt: string = fetched.executionManifest.createdAt;
   const _passCount: number = fetched.executionManifest.passes.length;
-  void _createdAt; void _passCount;
+  void _createdAt;
+  void _passCount;
 }
 if (fetched.globalConfidence) {
   const _overall: number = fetched.globalConfidence.stats.overall;
   const _agg: 'weighted-by-field-importance' = fetched.globalConfidence.aggregation;
-  void _overall; void _agg;
+  void _overall;
+  void _agg;
 }
 
 export {};

package/src/types/interface/models/extraction-plan.dto.test.ts

@@ -3,13 +3,20 @@
 // Run: npx tsc --noEmit (from packages/abyss_tools_core).
 
 import { ProviderKind, InterpreterKind, CombineStrategy } from '../../enum';
-import type { IExtractionPlan, IFieldValue, IExtractModesData, IPositionedToken } from './extraction-plan.dto';
+import type {
+  IExtractionPlan,
+  IFieldValue,
+  IExtractModesData,
+  IPositionedToken,
+} from './extraction-plan.dto';
 
 // Verify enum string values match the api side.
 const _pk: string = ProviderKind.TEXT; // 'text'
 const _ik: string = InterpreterKind.TEMPLATE; // 'template'
 const _cs: string = CombineStrategy.MAX_CONFIDENCE; // 'maxConfidence'
-void _pk; void _ik; void _cs;
+void _pk;
+void _ik;
+void _cs;
 
 // Verify IFieldValue is a structural superset of {value,confidence}.
 const fv: IFieldValue = {
@@ -40,8 +47,14 @@ const _plan: IExtractionPlan = {
 void _plan;
 
 // Verify IPositionedToken is { text, page, bbox{x,y,w,h}, conf? } (conf optional).
-const _tok: IPositionedToken = { text: 'IBAN', page: 1, bbox: { x: 1, y: 2, w: 3, h: 4 }, conf: 95 };
+const _tok: IPositionedToken = {
+  text: 'IBAN',
+  page: 1,
+  bbox: { x: 1, y: 2, w: 3, h: 4 },
+  conf: 95,
+};
 const _tokNoConf: IPositionedToken = { text: 'x', page: 2, bbox: { x: 0, y: 0, w: 1, h: 1 } };
-void _tok; void _tokNoConf;
+void _tok;
+void _tokNoConf;
 
 export {};

package/src/types/interface/models/extraction-spatial-template.dto.test.ts

@@ -3,24 +3,45 @@
 // Run: npx tsc --noEmit (from packages/abyss_tools_core).
 
 import type {
-  ISpatialZone, ISpatialTemplateConfig, IExtractionTemplateVersionDto, ISpatialZoneExtractor,
+  ISpatialZone,
+  ISpatialTemplateConfig,
+  IExtractionTemplateVersionDto,
+  ISpatialZoneExtractor,
 } from './extraction-spatial-template.dto';
 import { DocumentType } from '../../enum/document-type.enum';
 
 // A spatial zone + config type correctly (mirrors the backend schema).
-const zone: ISpatialZone = { fieldKey: 'totalTtc', page: 1, rect: { x: 0.6, y: 0.8, w: 0.3, h: 0.05 }, extractor: 'amount', amountLocale: 'fr' };
-const config: ISpatialTemplateConfig = { kind: 'spatial', documentType: DocumentType.INVOICE, zones: [zone] };
+const zone: ISpatialZone = {
+  fieldKey: 'totalTtc',
+  page: 1,
+  rect: { x: 0.6, y: 0.8, w: 0.3, h: 0.05 },
+  extractor: 'amount',
+  amountLocale: 'fr',
+};
+const config: ISpatialTemplateConfig = {
+  kind: 'spatial',
+  documentType: DocumentType.INVOICE,
+  zones: [zone],
+};
 // The fieldKey + kind discriminant are reachable.
 const _fieldKey: string = config.zones[0].fieldKey; // 'totalTtc'
 const _kind: 'spatial' = config.kind;
-void _fieldKey; void _kind;
+void _fieldKey;
+void _kind;
 
 // Every extractor literal is assignable to the union.
 const _extractors: ISpatialZoneExtractor[] = ['raw', 'regex', 'date', 'amount', 'iban'];
 void _extractors;
 
 // A template version dto types (serialized dates, nullable comment).
-const v: IExtractionTemplateVersionDto = { id: 'v1', templateId: 't1', version: 1, templateJson: { kind: 'spatial' }, comment: null, createdAt: '2026-06-28T00:00:00.000Z' };
+const v: IExtractionTemplateVersionDto = {
+  id: 'v1',
+  templateId: 't1',
+  version: 1,
+  templateJson: { kind: 'spatial' },
+  comment: null,
+  createdAt: '2026-06-28T00:00:00.000Z',
+};
 const _version: number = v.version; // 1
 void _version;
 

package/src/types/interface/models/extraction.dto.ts

@@ -63,6 +63,23 @@ export interface IExtractionMetadata {
   [k: string]: unknown;
 }
 
+/**
+ * Payslip (fiche de paie) metadata, extracted generically by FR labels — no
+ * per-employer template. Amounts are integer cents; `pasRatePct` is a percent
+ * (e.g. 3.6 for 3,6 %). `period` is a stable label (ISO month or a "du … au …"
+ * span). Every field is optional: a field is present only when confidently found.
+ */
+export interface IPayslipMetadata {
+  netCents?: number;
+  grossCents?: number;
+  netTaxableCents?: number;
+  pasRatePct?: number;
+  pasAmountCents?: number;
+  period?: string;
+  employer?: string;
+  currency?: string;
+}
+
 export interface IExtractionFile {
   id: string;
   userId: string;
@@ -113,6 +130,24 @@ export interface IExtractionWarning {
     type?: string;
     /** Human-readable explanation from the adapter's ValidationResult. */
     message?: string;
+    /**
+     * The withheld field's name. Present for the per-field withdrawal codes
+     * (`FIELD_BELOW_PUBLISH_FLOOR`, `FIELD_FORMAT_ONLY_DATE` #575,
+     * `FIELD_MRZ_OUT_OF_DOMAIN` #614).
+     */
+    fieldKey?: string;
+    /**
+     * The field's calibrated confidence at the time it was withheld. Present
+     * for the per-field withdrawal codes. Never the value itself.
+     */
+    confidence?: number;
+    /**
+     * The publish floor the field missed. Present only for
+     * `FIELD_BELOW_PUBLISH_FLOOR` — neither a `FIELD_FORMAT_ONLY_DATE` nor a
+     * `FIELD_MRZ_OUT_OF_DOMAIN` withdrawal is a floor comparison, and their
+     * confidence can sit above the field's floor.
+     */
+    floor?: number;
   };
 }
 

package/src/types/interface/models/index.ts

@@ -34,3 +34,4 @@ export * from './extraction-spatial-template.dto';
 export * from './probe-scan.dto';
 export * from './probe-webhook.dto';
 export * from './probe-webhook-delivery.dto';
+export * from './upload-session.dto';

package/src/types/interface/models/probe-webhook.dto.ts

@@ -1,8 +1,7 @@
 // Mirrors apps/api/src/api/controllers/probe-webhook.controller.ts's local
-// WebhookResponseData / CreateWebhookResponseData. Public shape of a
-// registered `probe_webhooks` row — never echoes the internal ownership
-// columns (userId/organizationId/applicationId), same discipline as the
-// scan models.
+// WebhookResponseData. Public shape of a registered `probe_webhooks` row —
+// never echoes the internal ownership columns
+// (userId/organizationId/applicationId), same discipline as the scan models.
 //
 // WS5-7 (AbyssProbe UX rework): `secret` is ALWAYS re-displayable now —
 // returned on every read (GET /webhook list, and PATCH /webhook/:id), not

package/src/types/interface/models/project.dto.ts

@@ -8,7 +8,8 @@ import { IUser } from './user.dto';
 export interface IProject {
   id?: string;
   name: string;
-  createdByUserId: string; // Historical creator of the project. NOT used for access control.
+  // Historical creator of the project, null once their account is deleted. NOT used for access control.
+  createdByUserId: string | null;
   organizationId: string;
   updatedAt?: Date;
   createdAt?: Date;

package/src/types/interface/models/short-link.dto.ts

@@ -40,6 +40,8 @@ export interface IShortLinkWithStats extends IShortLink {
     clicksByBrowser: { browser: string; clicks: number }[];
     clicksByReferer: { referer: string; clicks: number }[];
     clicksByUtmSource: { utmSource: string; clicks: number }[];
+    clicksByUtmMedium: { utmMedium: string; clicks: number }[];
+    clicksByUtmCampaign: { utmCampaign: string; clicks: number }[];
     clicksByLanguage: { language: string; clicks: number }[];
     clicksByRefererDomain: { refererDomain: string; clicks: number }[];
     clicksLast24h: number;

package/src/types/interface/models/upload-session.dto.ts

@@ -0,0 +1,24 @@
+/**
+ * SP3 — transparent multipart upload.
+ *
+ * Mirrors @abyss-project/storage's `UploadSession` (the return type of
+ * `initiateUpload`) as a LOCAL type instead of importing storage's own type,
+ * decoupling abyss-tools's public API contract from storage's package
+ * boundary — a front consumer of @abyss-project/tools should not need to
+ * also depend on @abyss-project/storage just to type a presign response
+ * (same mirroring rationale as abyss-memories's `IUploadSession`, abyss-form's
+ * `IUploadSession` and abyss-cloud's `IUploadSession`).
+ *
+ * `kind: 'single'` — size at or below storage's single-shot threshold:
+ * `token` is the one-shot pre-signed upload URL to PUT the whole file to.
+ * `kind: 'multipart'` — above the threshold: `multipartToken` identifies the
+ * multipart session and `partSizeOctet` is the fixed part size the front must
+ * chunk the file into (see @abyss-project/storage's `uploadWithSession`).
+ *
+ * Shared by every presign response DTO that proxies a *UploadUrl service
+ * method's `UploadSession` result as-is: board-card-document upload and
+ * atlas-document upload.
+ */
+export type IUploadSession =
+  | { kind: 'single'; token: string }
+  | { kind: 'multipart'; multipartToken: string; partSizeOctet: number };

package/src/types/interface/models/user.dto.ts

@@ -14,6 +14,9 @@ export interface IUser {
   // a mirrored key that must no longer authenticate.
   personalApiKeyLookupHash?: string | null;
   personalApiKeyRevokedAt?: Date | null;
+  // Set when the account was deleted in abyss-main (USER_DELETED, #199): the row stays, marked,
+  // and a session token signed before the deletion no longer authenticates.
+  accountDeletedAt?: Date | null;
   updatedAt?: Date;
   createdAt?: Date;
 

package/src/utils/extraction-webhook.utils.ts

@@ -18,7 +18,7 @@ export interface VerifyExtractionWebhookInput {
 
 export function verifyExtractionWebhook(input: VerifyExtractionWebhookInput): boolean {
   if (!input.signatureHeader || !input.secret) return false;
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
   const crypto = require('crypto');
   const provided = input.signatureHeader.replace(/^sha256=/, '');
   const computed: string = crypto

package/src/utils/probe-webhook-signature.utils.ts

@@ -34,7 +34,7 @@ export interface VerifyProbeWebhookSignatureInput {
 export function verifyProbeWebhookSignature(input: VerifyProbeWebhookSignatureInput): boolean {
   if (!input.signatureHeader || !input.secret) return false;
 
-  // eslint-disable-next-line @typescript-eslint/no-var-requires
+  // eslint-disable-next-line @typescript-eslint/no-require-imports
   const crypto = require('crypto');
   const computed: string = crypto
     .createHmac('sha256', input.secret)

package/tsconfig.check.json

@@ -0,0 +1,15 @@
+{
+  // Perimetre de VERIFICATION, distinct de celui du build.
+  //
+  // `tsconfig.json` exclut `src/**/*.spec.ts` parce qu'il sert a emettre `dist/`, ou une spec
+  // n'a rien a faire. Mais eslint s'appuie sur ce meme fichier via `parserOptions.project` :
+  // les cinq specs du paquet sortaient donc en « Parsing error: that TSConfig does not include
+  // this file », mesure du 2026-09-09, et n'etaient lintees par personne.
+  //
+  // Ce fichier sert uniquement a eslint. Il n'emet rien et ne change pas ce que `build` produit.
+  "extends": "./tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true
+  },
+  "exclude": ["./dist/**/*"]
+}