@veruna/api-contracts 20.0.0 → 20.2.0

package/build-esm/v1/client-file/schemas/client-file-pages.schema.js

@@ -0,0 +1,177 @@
+import { z } from 'zod';
+/**
+ * Reading a user file page by page (the "lazy reading" flow): file-service extracts what it can for free at upload
+ * (the PDF text layer, Word / PowerPoint text, spreadsheet structure) and stores every page; the API reads pages on
+ * demand, runs OCR only for pages without usable text and writes the result back, so a page is recognised once.
+ */
+/** What the file is, for reading purposes. Decides which reading routes apply. */
+export var ClientFileContentKind;
+(function (ClientFileContentKind) {
+    /** A PDF the user uploaded. Pages. */
+    ClientFileContentKind["PDF"] = "PDF";
+    /** Word / ODT / RTF: text extracted directly, paged by the converted PDF's pages. */
+    ClientFileContentKind["DOCUMENT"] = "DOCUMENT";
+    /** PowerPoint / ODP: a page is a slide (slide text + notes). */
+    ClientFileContentKind["PRESENTATION"] = "PRESENTATION";
+    /** Excel / ODS / CSV: sheets and rows, no pages. */
+    ClientFileContentKind["SHEET"] = "SHEET";
+    /** Plain text, markdown, code, JSON, HTML-as-text: lines, no pages. */
+    ClientFileContentKind["TEXT"] = "TEXT";
+    /** A picture: nothing to read, the model looks at it. */
+    ClientFileContentKind["IMAGE"] = "IMAGE";
+})(ClientFileContentKind || (ClientFileContentKind = {}));
+/** Where the stored text of a page came from. */
+export var ClientFilePageSource;
+(function (ClientFilePageSource) {
+    ClientFilePageSource["TEXT_LAYER"] = "TEXT_LAYER";
+    ClientFilePageSource["OCR"] = "OCR";
+    ClientFilePageSource["DOCUMENT"] = "DOCUMENT";
+    ClientFilePageSource["PRESENTATION"] = "PRESENTATION";
+})(ClientFilePageSource || (ClientFilePageSource = {}));
+export var ClientFilePageStatus;
+(function (ClientFilePageStatus) {
+    /** Usable text is stored for the page. */
+    ClientFilePageStatus["TEXT"] = "TEXT";
+    /** No usable text (a scan, a garbled text layer): reading the page runs OCR once. */
+    ClientFilePageStatus["NEEDS_OCR"] = "NEEDS_OCR";
+    /** A blank page: nothing to read. */
+    ClientFilePageStatus["EMPTY"] = "EMPTY";
+    /** OCR failed on this page CLIENT_FILE_OCR_MAX_FAILURES times: it is not retried (no paid loop). */
+    ClientFilePageStatus["UNREADABLE"] = "UNREADABLE";
+})(ClientFilePageStatus || (ClientFilePageStatus = {}));
+/** Where the extraction of a file stands. `extractedAt` alone cannot tell pending from failed. */
+export var ClientFileExtractionState;
+(function (ClientFileExtractionState) {
+    /** Queued or running; pages may be missing. Ask again in a few seconds. */
+    ClientFileExtractionState["PENDING"] = "PENDING";
+    /** Every page is classified. */
+    ClientFileExtractionState["READY"] = "READY";
+    /** Stopped at the page / time bound: pages after `pageCount` of the outline were not extracted (read them by OCR). */
+    ClientFileExtractionState["PARTIAL"] = "PARTIAL";
+    /** Extraction failed (bad or hostile file, parser error); pages are NEEDS_OCR and readable by OCR. */
+    ClientFileExtractionState["FAILED"] = "FAILED";
+})(ClientFileExtractionState || (ClientFileExtractionState = {}));
+/** OCR failures after which a page becomes UNREADABLE. */
+export const CLIENT_FILE_OCR_MAX_FAILURES = 2;
+/** Most pages one read may return: the model reads a document at most this many pages at a time. */
+export const CLIENT_FILE_MAX_PAGES_PER_READ = 5;
+/** Most spreadsheet rows one read may return. */
+export const CLIENT_FILE_MAX_ROWS_PER_READ = 50;
+/** Most text lines one read may return. */
+export const CLIENT_FILE_MAX_LINES_PER_READ = 400;
+/** Longest page hint: the first heading or the first characters of the page. */
+export const CLIENT_FILE_PAGE_HINT_MAX = 120;
+const PageNumberSchema = z.coerce.number().int().min(1);
+export const ClientFileIdParamsSchema = z.object({ fileId: z.uuid() });
+export const ClientFilePageParamsSchema = z.object({ fileId: z.uuid(), page: PageNumberSchema });
+export const ClientFilePageOutlineSchema = z.object({
+    page: z.number().int().min(1),
+    status: z.enum(ClientFilePageStatus),
+    /** null while the page waits for OCR. */
+    source: z.enum(ClientFilePageSource).nullable(),
+    chars: z.number().int().min(0),
+    /** The first heading or the first characters of the page; '' when there is no text yet. */
+    hint: z.string().max(CLIENT_FILE_PAGE_HINT_MAX),
+    /** The page carries pictures or charts the text does not convey: look at it as an image. */
+    hasFigures: z.boolean(),
+});
+export const ClientFileSheetOutlineSchema = z.object({
+    /** 0-based sheet index. */
+    index: z.number().int().min(0),
+    name: z.string(),
+    rows: z.number().int().min(0),
+    columns: z.number().int().min(0),
+    /** The first row's cells as text. */
+    header: z.array(z.string()),
+});
+export const ClientFileOutlineResponseSchema = z.object({
+    fileId: z.uuid(),
+    kind: z.enum(ClientFileContentKind),
+    /** Pages for PDF / DOCUMENT / PRESENTATION, null otherwise. */
+    pageCount: z.number().int().min(0).nullable(),
+    /** Lines for TEXT, null otherwise. */
+    lineCount: z.number().int().min(0).nullable(),
+    /** One entry per page (PDF / DOCUMENT / PRESENTATION); [] otherwise. */
+    pages: z.array(ClientFilePageOutlineSchema),
+    /** SHEET only; [] otherwise. */
+    sheets: z.array(ClientFileSheetOutlineSchema),
+    /** When extraction finished; null while it is pending or after it failed (then pages may all be NEEDS_OCR). */
+    extractedAt: z.iso.datetime().nullable(),
+    extraction: z.enum(ClientFileExtractionState),
+});
+export const ClientFilePagesQuerySchema = z
+    .object({ from: PageNumberSchema, to: PageNumberSchema })
+    .refine((range) => range.to >= range.from, { message: 'CLIENT_FILE_PAGE_RANGE_INVALID' })
+    .refine((range) => range.to - range.from < CLIENT_FILE_MAX_PAGES_PER_READ, {
+    message: 'CLIENT_FILE_PAGE_RANGE_TOO_LONG',
+});
+export const ClientFilePageTextSchema = ClientFilePageOutlineSchema.extend({
+    /** The stored text; null when the page is NEEDS_OCR or EMPTY. */
+    text: z.string().nullable(),
+});
+export const ClientFilePagesResponseSchema = z.object({
+    /** null while preparation is pending; optional for older file-service deployments. */
+    extractedAt: z.iso.datetime().nullable().optional(),
+    fileId: z.uuid(),
+    pages: z.array(ClientFilePageTextSchema),
+});
+/** OCR text the API recognised for pages that had none; file-service stores it with source OCR. */
+export const ClientFileOcrWriteRequestSchema = z.object({
+    pages: z
+        .array(z.object({
+        page: z.number().int().min(1),
+        /** Recognised text; '' with `failed: true` when OCR failed (counts towards UNREADABLE). */
+        text: z
+            .string()
+            .transform((text) => text.length > 200_000
+            ? text.slice(0, 200_000 - 16) + '\n[... truncated]'
+            : text),
+        failed: z.boolean().optional(),
+    }))
+        .min(1)
+        .max(CLIENT_FILE_MAX_PAGES_PER_READ),
+});
+export const ClientFileOcrWriteResponseSchema = z.object({ stored: z.number().int().min(0) });
+/** A one-page PDF (for OCR) or a rendered page image (for "look at the page"), produced once and kept in storage. */
+export const ClientFilePageAssetResponseSchema = z.object({
+    page: z.number().int().min(1),
+    url: z.url(),
+    contentType: z.enum(['application/pdf', 'image/jpeg']),
+});
+export const ClientFileSheetRowsParamsSchema = z.object({
+    fileId: z.uuid(),
+    sheet: z.coerce.number().int().min(0),
+});
+/** 1-based data rows (the header is row 0 and always returned separately). */
+export const ClientFileSheetRowsQuerySchema = z
+    .object({ from: PageNumberSchema, to: PageNumberSchema })
+    .refine((range) => range.to >= range.from, { message: 'CLIENT_FILE_ROW_RANGE_INVALID' })
+    .refine((range) => range.to - range.from < CLIENT_FILE_MAX_ROWS_PER_READ, {
+    message: 'CLIENT_FILE_ROW_RANGE_TOO_LONG',
+});
+export const ClientFileSheetRowsResponseSchema = z.object({
+    /** null while preparation is pending; optional for older file-service deployments. */
+    extractedAt: z.iso.datetime().nullable().optional(),
+    fileId: z.uuid(),
+    sheet: z.number().int().min(0),
+    name: z.string(),
+    header: z.array(z.string()),
+    /** Cell values as text, one array per row, in the requested range (shorter at the end of the sheet). */
+    rows: z.array(z.array(z.string())),
+    totalRows: z.number().int().min(0),
+});
+export const ClientFileTextLinesQuerySchema = z
+    .object({ from: PageNumberSchema, to: PageNumberSchema })
+    .refine((range) => range.to >= range.from, { message: 'CLIENT_FILE_LINE_RANGE_INVALID' })
+    .refine((range) => range.to - range.from < CLIENT_FILE_MAX_LINES_PER_READ, {
+    message: 'CLIENT_FILE_LINE_RANGE_TOO_LONG',
+});
+export const ClientFileTextLinesResponseSchema = z.object({
+    /** null while preparation is pending; optional for older file-service deployments. */
+    extractedAt: z.iso.datetime().nullable().optional(),
+    fileId: z.uuid(),
+    from: z.number().int().min(1),
+    lines: z.array(z.string()),
+    totalLines: z.number().int().min(0),
+});
+//# sourceMappingURL=client-file-pages.schema.js.map

package/build-esm/v1/client-file/schemas/client-file-pages.schema.js.map

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

package/build-esm/v1/client-file/schemas/client-file-release-request.schema.js

@@ -1,6 +1,11 @@
 import { z } from 'zod';
 import { S2SUploadAiImageOwnerType } from '../../s2s/schemas/s2s-upload-ai-image-owner-type.enum';
 import { UUID_REGEX } from '../../../shared/regex';
+/**
+ * S2S compensation request for reverting an ATTACHED batch to PENDING.
+ * Ownership plus the original message id make the transition fail closed.
+ * Error messages: ClientFileReleaseRequest.{field}.{rule}
+ */
 export const ClientFileReleaseRequestSchema = z
     .object({
     uuids: z

package/build-esm/v1/client-file/schemas/client-file-release-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-file-release-request.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-release-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAOnD,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACJ,KAAK,EAAE,CAAC;SACH,KAAK,CACF,CAAC;SACI,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;SAC5D,IAAI,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CACjE;SACA,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IAC5D,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,IAAI,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IAClE,OAAO,EAAE,CAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IAC/E,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,yBAAyB,EAAE;QAC/C,KAAK,EAAE,4CAA4C;KACtD,CAAC;CACL,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;IACvE,OAAO,EAAE,2CAA2C;IACpD,IAAI,EAAE,CAAC,OAAO,CAAC;CAClB,CAAC,CAAC"}
+{"version":3,"file":"client-file-release-request.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-release-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yBAAyB,EAAE,MAAM,uDAAuD,CAAC;AAClG,OAAO,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC;KAC1C,MAAM,CAAC;IACJ,KAAK,EAAE,CAAC;SACH,KAAK,CACF,CAAC;SACI,MAAM,CAAC,EAAE,KAAK,EAAE,yCAAyC,EAAE,CAAC;SAC5D,IAAI,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC,CACjE;SACA,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;IAC5D,SAAS,EAAE,CAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,IAAI,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IAClE,OAAO,EAAE,CAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,UAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IAC/E,SAAS,EAAE,CAAC,CAAC,UAAU,CAAC,yBAAyB,EAAE;QAC/C,KAAK,EAAE,4CAA4C;KACtD,CAAC;CACL,CAAC;KACD,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE;IACvE,OAAO,EAAE,2CAA2C;IACpD,IAAI,EAAE,CAAC,OAAO,CAAC;CAClB,CAAC,CAAC"}

package/build-esm/v1/client-file/schemas/client-file-release-response.schema.js

@@ -2,6 +2,10 @@ import { z } from 'zod';
 export const ClientFileReleaseResponseSchema = z
     .object({
     releasedCount: z.number().int().nonnegative(),
+    /**
+     * Rollout capability proof: only file-service versions that persist a
+     * durable CANCELLED attempt fence may return this literal.
+     */
     attachmentFenceEstablished: z.literal(true),
 })
     .strict();

package/build-esm/v1/client-file/schemas/client-file-release-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-file-release-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-release-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACJ,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAK7C,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC"}
+{"version":3,"file":"client-file-release-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-release-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC;KAC3C,MAAM,CAAC;IACJ,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC7C;;;OAGG;IACH,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/build-esm/v1/client-file/schemas/client-file-resolve-key.schema.js

@@ -0,0 +1,10 @@
+import { z } from 'zod';
+export const ClientFileResolveKeyQuerySchema = z.object({
+    chatId: z.uuid({ error: 'ClientFileResolveKey.chatId.invalid' }),
+    key: z
+        .string({ error: 'ClientFileResolveKey.key.required' })
+        .min(1, { message: 'ClientFileResolveKey.key.min' })
+        .max(2048, { message: 'ClientFileResolveKey.key.max' }),
+});
+export const ClientFileResolveKeyResponseSchema = z.object({ fileId: z.uuid().nullable() });
+//# sourceMappingURL=client-file-resolve-key.schema.js.map

package/build-esm/v1/client-file/schemas/client-file-resolve-key.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-file-resolve-key.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-resolve-key.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IAChE,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;SACnD,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,8BAA8B,EAAE,CAAC;CAC9D,CAAC,CAAC;AACH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC"}

package/build-esm/v1/client-file/schemas/client-file-status.enum.js

@@ -1,9 +1,27 @@
+/**
+ * Lifecycle status of a `client_file_objects` row.
+ *
+ * Persisted as UPPERCASE strings in PostgreSQL (`status` column,
+ * VARCHAR(20)). Use this enum for any contract-level filtering or
+ * response shape — never raw string literals.
+ */
 export var ClientFileStatus;
 (function (ClientFileStatus) {
+    /**
+     * Reserved row inserted before the S3 PUT. Counts toward the
+     * owner's quota so concurrent uploads cannot race past the cap;
+     * excluded from user-visible listings until the upload finalises.
+     * A stale UPLOADING row (process crash / S3 timeout) is reaped by
+     * the periodic cleanup worker.
+     */
     ClientFileStatus["UPLOADING"] = "UPLOADING";
+    /** Uploaded, not yet attached to a message. Default state after PUT upload. */
     ClientFileStatus["PENDING"] = "PENDING";
+    /** Attached to a sent message; counts toward the user's chat history. */
     ClientFileStatus["ATTACHED"] = "ATTACHED";
+    /** Generated by the assistant (image / file tool). Counts toward user quota — assistant outputs occupy real storage. */
     ClientFileStatus["AI_GENERATED"] = "AI_GENERATED";
+    /** Soft-deleted by the user. Excluded from default listings and quota math. */
     ClientFileStatus["DELETED"] = "DELETED";
 })(ClientFileStatus || (ClientFileStatus = {}));
 //# sourceMappingURL=client-file-status.enum.js.map

package/build-esm/v1/client-file/schemas/client-file-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-file-status.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-status.enum.ts"],"names":[],"mappings":"AAOA,MAAM,CAAN,IAAY,gBAiBX;AAjBD,WAAY,gBAAgB;IAQxB,2CAAuB,CAAA;IAEvB,uCAAmB,CAAA;IAEnB,yCAAqB,CAAA;IAErB,iDAA6B,CAAA;IAE7B,uCAAmB,CAAA;AACvB,CAAC,EAjBW,gBAAgB,KAAhB,gBAAgB,QAiB3B"}
+{"version":3,"file":"client-file-status.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-status.enum.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAN,IAAY,gBAiBX;AAjBD,WAAY,gBAAgB;IACxB;;;;;;OAMG;IACH,2CAAuB,CAAA;IACvB,+EAA+E;IAC/E,uCAAmB,CAAA;IACnB,yEAAyE;IACzE,yCAAqB,CAAA;IACrB,wHAAwH;IACxH,iDAA6B,CAAA;IAC7B,+EAA+E;IAC/E,uCAAmB,CAAA;AACvB,CAAC,EAjBW,gBAAgB,KAAhB,gBAAgB,QAiB3B"}

package/build-esm/v1/client-file/schemas/client-file-upload-query.schema.js

@@ -1,5 +1,13 @@
 import { z } from 'zod';
 import { ClientFileMark } from './client-file-mark.enum';
+/**
+ * Optional upload-time query string. The frontend uses `marks` to flag
+ * the file before persistence — currently only `PASTED` is meaningful,
+ * the field stays an array so future flags don't require a schema bump.
+ *
+ * Accepts either a single value (`?marks=PASTED`) or a repeated key
+ * (`?marks=PASTED&marks=FOO`); both are normalised to `ClientFileMark[]`.
+ */
 export const ClientFileUploadQuerySchema = z.object({
     marks: z
         .union([z.enum(ClientFileMark), z.array(z.enum(ClientFileMark))])

package/build-esm/v1/client-file/schemas/client-file-upload-query.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-file-upload-query.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-upload-query.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAUzD,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC;SACH,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;SAChE,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,KAAK,EAAoB,EAAE;QACnC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;CACT,CAAC,CAAC"}
+{"version":3,"file":"client-file-upload-query.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-upload-query.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC;SACH,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;SAChE,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,KAAK,EAAoB,EAAE;QACnC,IAAI,KAAK,KAAK,SAAS;YAAE,OAAO,EAAE,CAAC;QACnC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClD,CAAC,CAAC;CACT,CAAC,CAAC"}

package/build-esm/v1/client-file/schemas/index.js

@@ -19,4 +19,5 @@ export * from './user-file-item-response.schema';
 export * from './user-files-list-request.schema';
 export * from './user-files-list-response.schema';
 export * from './user-files-stats-response.schema';
+export * from './client-file-pages.schema';
 //# sourceMappingURL=index.js.map

package/build-esm/v1/client-file/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,mCAAmC,CAAC;AAClD,cAAc,sCAAsC,CAAC;AACrD,cAAc,qCAAqC,CAAC;AACpD,cAAc,sCAAsC,CAAC;AACrD,cAAc,sCAAsC,CAAC;AACrD,cAAc,uCAAuC,CAAC;AACtD,cAAc,0BAA0B,CAAC;AACzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kCAAkC,CAAC;AACjD,cAAc,kCAAkC,CAAC;AACjD,cAAc,mCAAmC,CAAC;AAClD,cAAc,oCAAoC,CAAC;AACnD,cAAc,4BAA4B,CAAC"}

package/build-esm/v1/client-file/schemas/processing-category.enum.js

@@ -1,8 +1,17 @@
+/**
+ * Category assigned to an uploaded file at upload time.
+ * Determines how the file is processed (Gotenberg, inline text, as-is)
+ * and how it is presented in the LLM context.
+ */
 export var FileProcessingCategory;
 (function (FileProcessingCategory) {
+    /** Text-native files (csv, json, txt, md, code) — raw text inline, no PDF conversion */
     FileProcessingCategory["TEXT_NATIVE"] = "TEXT_NATIVE";
+    /** Visual documents (docx, pptx, xlsx, html) — Gotenberg PDF conversion, layout matters */
     FileProcessingCategory["VISUAL_DOC"] = "VISUAL_DOC";
+    /** PDF files — passed as-is, no conversion needed */
     FileProcessingCategory["PDF"] = "PDF";
+    /** Image files — passed as image_url to LLM */
     FileProcessingCategory["IMAGE"] = "IMAGE";
 })(FileProcessingCategory || (FileProcessingCategory = {}));
 //# sourceMappingURL=processing-category.enum.js.map

package/build-esm/v1/client-file/schemas/processing-category.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"processing-category.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/processing-category.enum.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,sBASX;AATD,WAAY,sBAAsB;IAE9B,qDAA2B,CAAA;IAE3B,mDAAyB,CAAA;IAEzB,qCAAW,CAAA;IAEX,yCAAe,CAAA;AACnB,CAAC,EATW,sBAAsB,KAAtB,sBAAsB,QASjC"}
+{"version":3,"file":"processing-category.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/processing-category.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,sBASX;AATD,WAAY,sBAAsB;IAC9B,wFAAwF;IACxF,qDAA2B,CAAA;IAC3B,2FAA2F;IAC3F,mDAAyB,CAAA;IACzB,qDAAqD;IACrD,qCAAW,CAAA;IACX,+CAA+C;IAC/C,yCAAe,CAAA;AACnB,CAAC,EATW,sBAAsB,KAAtB,sBAAsB,QASjC"}

package/build-esm/v1/client-file/schemas/user-file-item-response.schema.js

@@ -4,6 +4,14 @@ import { ClientFileType } from './client-file-type.enum';
 import { ClientFileStatus } from './client-file-status.enum';
 import { ClientFileMark } from './client-file-mark.enum';
 import { FileProcessingCategory } from './processing-category.enum';
+/**
+ * Single row in the cross-chat user file listing.
+ *
+ * Superset of `ClientFileItemResponseSchema`: adds lifecycle status, the
+ * owning chat reference (id only — FE resolves the title locally), an
+ * optional message reference, the processing category, and ISO-8601
+ * timestamps.
+ */
 export const UserFileItemResponseSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     type: z.enum(ClientFileType),

package/build-esm/v1/client-file/schemas/user-file-item-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-file-item-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-file-item-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAUpE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACnC,CAAC;IACF,UAAU,EAAE,CAAC;SACR,MAAM,CAAC;QACJ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACnC,CAAC;SACD,QAAQ,EAAE;IACf,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAC7D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}
+{"version":3,"file":"user-file-item-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-file-item-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAEpE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC;IAC5B,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,gBAAgB,CAAC;IAChC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,mBAAmB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC;QACd,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACnC,CAAC;IACF,UAAU,EAAE,CAAC;SACR,MAAM,CAAC;QACJ,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;KACnC,CAAC;SACD,QAAQ,EAAE;IACf,kBAAkB,EAAE,CAAC,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IAC7D,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}

package/build-esm/v1/client-file/schemas/user-files-list-request.schema.js

@@ -1,8 +1,25 @@
 import { z } from 'zod';
 import { ClientFileStatus } from './client-file-status.enum';
 import { ClientFileType } from './client-file-type.enum';
+/**
+ * Cardinality of each enum, derived once so the array `.max(...)`
+ * caps don't drift when a new status / type is introduced. The cap is
+ * defensive only — it stops a caller from blowing up the SQL `IN (...)`
+ * list with duplicates, not a business rule.
+ */
 const STATUS_FILTER_MAX = Object.values(ClientFileStatus).length;
 const TYPE_FILTER_MAX = Object.values(ClientFileType).length;
+/**
+ * Query string for `GET /file-api/v1/client/files`.
+ *
+ * - `cursor` is opaque (encoded `(updatedAt, uuid)` tuple from the server).
+ * - `limit` is clamped to [1, 100], defaults to 50.
+ * - `status` / `type` are repeatable and act as inclusive filters.
+ *   The DELETED status is always excluded server-side regardless of the
+ *   filter — there is no `includeDeleted` toggle.
+ *
+ * Error keys: `UserFilesListRequest.<field>.<rule>`.
+ */
 export const UserFilesListRequestSchema = z.object({
     cursor: z
         .string({ error: 'UserFilesListRequest.cursor.invalid' })

package/build-esm/v1/client-file/schemas/user-files-list-request.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-files-list-request.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-files-list-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAQzD,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;AACjE,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;AAa7D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,QAAQ,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM;SACV,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACvD,GAAG,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SAClD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACrD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACvD,OAAO,CAAC,EAAE,CAAC;IAChB,MAAM,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC,CAAC;SACjF,GAAG,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtE,QAAQ,EAAE;IACf,IAAI,EAAE,CAAC;SACF,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC;SAC7E,GAAG,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SAClE,QAAQ,EAAE;CAClB,CAAC,CAAC"}
+{"version":3,"file":"user-files-list-request.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-files-list-request.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC;AACjE,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC;AAE7D;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,CAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;SACxD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACxD,QAAQ,EAAE;IACf,KAAK,EAAE,CAAC,CAAC,MAAM;SACV,MAAM,CAAC,EAAE,KAAK,EAAE,oCAAoC,EAAE,CAAC;SACvD,GAAG,CAAC,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SAClD,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACrD,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAC;SACvD,OAAO,CAAC,EAAE,CAAC;IAChB,MAAM,EAAE,CAAC;SACJ,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC,CAAC;SACjF,GAAG,CAAC,iBAAiB,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;SACtE,QAAQ,EAAE;IACf,IAAI,EAAE,CAAC;SACF,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC,CAAC;SAC7E,GAAG,CAAC,eAAe,EAAE,EAAE,OAAO,EAAE,+BAA+B,EAAE,CAAC;SAClE,QAAQ,EAAE;CAClB,CAAC,CAAC"}

package/build-esm/v1/client-file/schemas/user-files-list-response.schema.js

@@ -1,5 +1,12 @@
 import { z } from 'zod';
 import { UserFileItemResponseSchema } from './user-file-item-response.schema';
+/**
+ * Cursor-paginated page of user files across all chats.
+ *
+ * `nextCursor` is null iff `hasMore` is false — the server uses a
+ * "fetch limit + 1" pattern, so the two flags are derived from the same
+ * computation and stay in sync.
+ */
 export const UserFilesListResponseSchema = z.object({
     items: z.array(UserFileItemResponseSchema),
     nextCursor: z.string().nullable(),

package/build-esm/v1/client-file/schemas/user-files-list-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-files-list-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-files-list-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAS9E,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}
+{"version":3,"file":"user-files-list-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-files-list-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,0BAA0B,EAAE,MAAM,kCAAkC,CAAC;AAE9E;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}

package/build-esm/v1/client-file/schemas/user-files-stats-response.schema.js

@@ -1,6 +1,27 @@
 import { z } from 'zod';
 import { ClientFileStatus } from './client-file-status.enum';
 import { ClientFileType } from './client-file-type.enum';
+/**
+ * Aggregate stats for the current user's file storage.
+ *
+ * `totalBytes` sums every active row (`status <> DELETED`), including
+ * UPLOADING reservations and AI_GENERATED outputs — both occupy real
+ * S3 storage and count toward the quota.
+ *
+ * `byStatus` / `byType` carry the row-count breakdown.
+ * `bytesByStatus` / `bytesByType` carry the byte-sum breakdown for the
+ * same buckets — both maps sum to `totalBytes` (modulo bigint coercion).
+ * The bytes maps are what the donut chart renders; the count maps stay
+ * around for "X files in Y status" labels.
+ *
+ * `UPLOADING` is exposed as its own bucket so the donut invariant
+ * (`pending + attached + aiGenerated + uploading = totalBytes`)
+ * holds without smearing semantics across buckets. In normal use the
+ * UPLOADING slice is near zero — uploads finalize within seconds.
+ *
+ * `DELETED` is intentionally absent everywhere — the API never exposes
+ * deletion data in this surface.
+ */
 export const UserFilesStatsResponseSchema = z.object({
     totalFiles: z.number().int().nonnegative(),
     totalBytes: z.number().int().nonnegative(),

package/build-esm/v1/client-file/schemas/user-files-stats-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-files-stats-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-files-stats-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAuBzD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;CACL,CAAC,CAAC"}
+{"version":3,"file":"user-files-stats-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/user-files-stats-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAC7D,OAAO,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC;QACf,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC;QACb,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,aAAa,EAAE,CAAC,CAAC,MAAM,CAAC;QACpB,CAAC,gBAAgB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,gBAAgB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,gBAAgB,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,gBAAgB,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;QAClB,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;CACL,CAAC,CAAC"}