@veruna/api-contracts 20.0.0 → 20.2.0

package/build/v1/client-file/schemas/client-file-pages.schema.d.ts

@@ -0,0 +1,195 @@
+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 declare enum ClientFileContentKind {
+    /** A PDF the user uploaded. Pages. */
+    PDF = "PDF",
+    /** Word / ODT / RTF: text extracted directly, paged by the converted PDF's pages. */
+    DOCUMENT = "DOCUMENT",
+    /** PowerPoint / ODP: a page is a slide (slide text + notes). */
+    PRESENTATION = "PRESENTATION",
+    /** Excel / ODS / CSV: sheets and rows, no pages. */
+    SHEET = "SHEET",
+    /** Plain text, markdown, code, JSON, HTML-as-text: lines, no pages. */
+    TEXT = "TEXT",
+    /** A picture: nothing to read, the model looks at it. */
+    IMAGE = "IMAGE"
+}
+/** Where the stored text of a page came from. */
+export declare enum ClientFilePageSource {
+    TEXT_LAYER = "TEXT_LAYER",
+    OCR = "OCR",
+    DOCUMENT = "DOCUMENT",
+    PRESENTATION = "PRESENTATION"
+}
+export declare enum ClientFilePageStatus {
+    /** Usable text is stored for the page. */
+    TEXT = "TEXT",
+    /** No usable text (a scan, a garbled text layer): reading the page runs OCR once. */
+    NEEDS_OCR = "NEEDS_OCR",
+    /** A blank page: nothing to read. */
+    EMPTY = "EMPTY",
+    /** OCR failed on this page CLIENT_FILE_OCR_MAX_FAILURES times: it is not retried (no paid loop). */
+    UNREADABLE = "UNREADABLE"
+}
+/** Where the extraction of a file stands. `extractedAt` alone cannot tell pending from failed. */
+export declare enum ClientFileExtractionState {
+    /** Queued or running; pages may be missing. Ask again in a few seconds. */
+    PENDING = "PENDING",
+    /** Every page is classified. */
+    READY = "READY",
+    /** Stopped at the page / time bound: pages after `pageCount` of the outline were not extracted (read them by OCR). */
+    PARTIAL = "PARTIAL",
+    /** Extraction failed (bad or hostile file, parser error); pages are NEEDS_OCR and readable by OCR. */
+    FAILED = "FAILED"
+}
+/** OCR failures after which a page becomes UNREADABLE. */
+export declare 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 declare const CLIENT_FILE_MAX_PAGES_PER_READ = 5;
+/** Most spreadsheet rows one read may return. */
+export declare const CLIENT_FILE_MAX_ROWS_PER_READ = 50;
+/** Most text lines one read may return. */
+export declare const CLIENT_FILE_MAX_LINES_PER_READ = 400;
+/** Longest page hint: the first heading or the first characters of the page. */
+export declare const CLIENT_FILE_PAGE_HINT_MAX = 120;
+export declare const ClientFileIdParamsSchema: z.ZodObject<{
+    fileId: z.ZodUUID;
+}, z.core.$strip>;
+export type ClientFileIdParams = z.infer<typeof ClientFileIdParamsSchema>;
+export declare const ClientFilePageParamsSchema: z.ZodObject<{
+    fileId: z.ZodUUID;
+    page: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export type ClientFilePageParams = z.infer<typeof ClientFilePageParamsSchema>;
+export declare const ClientFilePageOutlineSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    status: z.ZodEnum<typeof ClientFilePageStatus>;
+    source: z.ZodNullable<z.ZodEnum<typeof ClientFilePageSource>>;
+    chars: z.ZodNumber;
+    hint: z.ZodString;
+    hasFigures: z.ZodBoolean;
+}, z.core.$strip>;
+export type ClientFilePageOutline = z.infer<typeof ClientFilePageOutlineSchema>;
+export declare const ClientFileSheetOutlineSchema: z.ZodObject<{
+    index: z.ZodNumber;
+    name: z.ZodString;
+    rows: z.ZodNumber;
+    columns: z.ZodNumber;
+    header: z.ZodArray<z.ZodString>;
+}, z.core.$strip>;
+export type ClientFileSheetOutline = z.infer<typeof ClientFileSheetOutlineSchema>;
+export declare const ClientFileOutlineResponseSchema: z.ZodObject<{
+    fileId: z.ZodUUID;
+    kind: z.ZodEnum<typeof ClientFileContentKind>;
+    pageCount: z.ZodNullable<z.ZodNumber>;
+    lineCount: z.ZodNullable<z.ZodNumber>;
+    pages: z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        status: z.ZodEnum<typeof ClientFilePageStatus>;
+        source: z.ZodNullable<z.ZodEnum<typeof ClientFilePageSource>>;
+        chars: z.ZodNumber;
+        hint: z.ZodString;
+        hasFigures: z.ZodBoolean;
+    }, z.core.$strip>>;
+    sheets: z.ZodArray<z.ZodObject<{
+        index: z.ZodNumber;
+        name: z.ZodString;
+        rows: z.ZodNumber;
+        columns: z.ZodNumber;
+        header: z.ZodArray<z.ZodString>;
+    }, z.core.$strip>>;
+    extractedAt: z.ZodNullable<z.ZodISODateTime>;
+    extraction: z.ZodEnum<typeof ClientFileExtractionState>;
+}, z.core.$strip>;
+export type ClientFileOutlineResponse = z.infer<typeof ClientFileOutlineResponseSchema>;
+export declare const ClientFilePagesQuerySchema: z.ZodObject<{
+    from: z.ZodCoercedNumber<unknown>;
+    to: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export type ClientFilePagesQuery = z.infer<typeof ClientFilePagesQuerySchema>;
+export declare const ClientFilePageTextSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    status: z.ZodEnum<typeof ClientFilePageStatus>;
+    source: z.ZodNullable<z.ZodEnum<typeof ClientFilePageSource>>;
+    chars: z.ZodNumber;
+    hint: z.ZodString;
+    hasFigures: z.ZodBoolean;
+    text: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ClientFilePageText = z.infer<typeof ClientFilePageTextSchema>;
+export declare const ClientFilePagesResponseSchema: z.ZodObject<{
+    extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    fileId: z.ZodUUID;
+    pages: z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        status: z.ZodEnum<typeof ClientFilePageStatus>;
+        source: z.ZodNullable<z.ZodEnum<typeof ClientFilePageSource>>;
+        chars: z.ZodNumber;
+        hint: z.ZodString;
+        hasFigures: z.ZodBoolean;
+        text: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ClientFilePagesResponse = z.infer<typeof ClientFilePagesResponseSchema>;
+/** OCR text the API recognised for pages that had none; file-service stores it with source OCR. */
+export declare const ClientFileOcrWriteRequestSchema: z.ZodObject<{
+    pages: z.ZodArray<z.ZodObject<{
+        page: z.ZodNumber;
+        text: z.ZodPipe<z.ZodString, z.ZodTransform<string, string>>;
+        failed: z.ZodOptional<z.ZodBoolean>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type ClientFileOcrWriteRequest = z.infer<typeof ClientFileOcrWriteRequestSchema>;
+export declare const ClientFileOcrWriteResponseSchema: z.ZodObject<{
+    stored: z.ZodNumber;
+}, z.core.$strip>;
+export type ClientFileOcrWriteResponse = z.infer<typeof ClientFileOcrWriteResponseSchema>;
+/** A one-page PDF (for OCR) or a rendered page image (for "look at the page"), produced once and kept in storage. */
+export declare const ClientFilePageAssetResponseSchema: z.ZodObject<{
+    page: z.ZodNumber;
+    url: z.ZodURL;
+    contentType: z.ZodEnum<{
+        "image/jpeg": "image/jpeg";
+        "application/pdf": "application/pdf";
+    }>;
+}, z.core.$strip>;
+export type ClientFilePageAssetResponse = z.infer<typeof ClientFilePageAssetResponseSchema>;
+export declare const ClientFileSheetRowsParamsSchema: z.ZodObject<{
+    fileId: z.ZodUUID;
+    sheet: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export type ClientFileSheetRowsParams = z.infer<typeof ClientFileSheetRowsParamsSchema>;
+/** 1-based data rows (the header is row 0 and always returned separately). */
+export declare const ClientFileSheetRowsQuerySchema: z.ZodObject<{
+    from: z.ZodCoercedNumber<unknown>;
+    to: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export type ClientFileSheetRowsQuery = z.infer<typeof ClientFileSheetRowsQuerySchema>;
+export declare const ClientFileSheetRowsResponseSchema: z.ZodObject<{
+    extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    fileId: z.ZodUUID;
+    sheet: z.ZodNumber;
+    name: z.ZodString;
+    header: z.ZodArray<z.ZodString>;
+    rows: z.ZodArray<z.ZodArray<z.ZodString>>;
+    totalRows: z.ZodNumber;
+}, z.core.$strip>;
+export type ClientFileSheetRowsResponse = z.infer<typeof ClientFileSheetRowsResponseSchema>;
+export declare const ClientFileTextLinesQuerySchema: z.ZodObject<{
+    from: z.ZodCoercedNumber<unknown>;
+    to: z.ZodCoercedNumber<unknown>;
+}, z.core.$strip>;
+export type ClientFileTextLinesQuery = z.infer<typeof ClientFileTextLinesQuerySchema>;
+export declare const ClientFileTextLinesResponseSchema: z.ZodObject<{
+    extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+    fileId: z.ZodUUID;
+    from: z.ZodNumber;
+    lines: z.ZodArray<z.ZodString>;
+    totalLines: z.ZodNumber;
+}, z.core.$strip>;
+export type ClientFileTextLinesResponse = z.infer<typeof ClientFileTextLinesResponseSchema>;

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

@@ -0,0 +1,180 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientFileTextLinesResponseSchema = exports.ClientFileTextLinesQuerySchema = exports.ClientFileSheetRowsResponseSchema = exports.ClientFileSheetRowsQuerySchema = exports.ClientFileSheetRowsParamsSchema = exports.ClientFilePageAssetResponseSchema = exports.ClientFileOcrWriteResponseSchema = exports.ClientFileOcrWriteRequestSchema = exports.ClientFilePagesResponseSchema = exports.ClientFilePageTextSchema = exports.ClientFilePagesQuerySchema = exports.ClientFileOutlineResponseSchema = exports.ClientFileSheetOutlineSchema = exports.ClientFilePageOutlineSchema = exports.ClientFilePageParamsSchema = exports.ClientFileIdParamsSchema = exports.CLIENT_FILE_PAGE_HINT_MAX = exports.CLIENT_FILE_MAX_LINES_PER_READ = exports.CLIENT_FILE_MAX_ROWS_PER_READ = exports.CLIENT_FILE_MAX_PAGES_PER_READ = exports.CLIENT_FILE_OCR_MAX_FAILURES = exports.ClientFileExtractionState = exports.ClientFilePageStatus = exports.ClientFilePageSource = exports.ClientFileContentKind = void 0;
+const zod_1 = require("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. */
+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 || (exports.ClientFileContentKind = ClientFileContentKind = {}));
+/** Where the stored text of a page came from. */
+var ClientFilePageSource;
+(function (ClientFilePageSource) {
+    ClientFilePageSource["TEXT_LAYER"] = "TEXT_LAYER";
+    ClientFilePageSource["OCR"] = "OCR";
+    ClientFilePageSource["DOCUMENT"] = "DOCUMENT";
+    ClientFilePageSource["PRESENTATION"] = "PRESENTATION";
+})(ClientFilePageSource || (exports.ClientFilePageSource = ClientFilePageSource = {}));
+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 || (exports.ClientFilePageStatus = ClientFilePageStatus = {}));
+/** Where the extraction of a file stands. `extractedAt` alone cannot tell pending from failed. */
+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 || (exports.ClientFileExtractionState = ClientFileExtractionState = {}));
+/** OCR failures after which a page becomes UNREADABLE. */
+exports.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. */
+exports.CLIENT_FILE_MAX_PAGES_PER_READ = 5;
+/** Most spreadsheet rows one read may return. */
+exports.CLIENT_FILE_MAX_ROWS_PER_READ = 50;
+/** Most text lines one read may return. */
+exports.CLIENT_FILE_MAX_LINES_PER_READ = 400;
+/** Longest page hint: the first heading or the first characters of the page. */
+exports.CLIENT_FILE_PAGE_HINT_MAX = 120;
+const PageNumberSchema = zod_1.z.coerce.number().int().min(1);
+exports.ClientFileIdParamsSchema = zod_1.z.object({ fileId: zod_1.z.uuid() });
+exports.ClientFilePageParamsSchema = zod_1.z.object({ fileId: zod_1.z.uuid(), page: PageNumberSchema });
+exports.ClientFilePageOutlineSchema = zod_1.z.object({
+    page: zod_1.z.number().int().min(1),
+    status: zod_1.z.enum(ClientFilePageStatus),
+    /** null while the page waits for OCR. */
+    source: zod_1.z.enum(ClientFilePageSource).nullable(),
+    chars: zod_1.z.number().int().min(0),
+    /** The first heading or the first characters of the page; '' when there is no text yet. */
+    hint: zod_1.z.string().max(exports.CLIENT_FILE_PAGE_HINT_MAX),
+    /** The page carries pictures or charts the text does not convey: look at it as an image. */
+    hasFigures: zod_1.z.boolean(),
+});
+exports.ClientFileSheetOutlineSchema = zod_1.z.object({
+    /** 0-based sheet index. */
+    index: zod_1.z.number().int().min(0),
+    name: zod_1.z.string(),
+    rows: zod_1.z.number().int().min(0),
+    columns: zod_1.z.number().int().min(0),
+    /** The first row's cells as text. */
+    header: zod_1.z.array(zod_1.z.string()),
+});
+exports.ClientFileOutlineResponseSchema = zod_1.z.object({
+    fileId: zod_1.z.uuid(),
+    kind: zod_1.z.enum(ClientFileContentKind),
+    /** Pages for PDF / DOCUMENT / PRESENTATION, null otherwise. */
+    pageCount: zod_1.z.number().int().min(0).nullable(),
+    /** Lines for TEXT, null otherwise. */
+    lineCount: zod_1.z.number().int().min(0).nullable(),
+    /** One entry per page (PDF / DOCUMENT / PRESENTATION); [] otherwise. */
+    pages: zod_1.z.array(exports.ClientFilePageOutlineSchema),
+    /** SHEET only; [] otherwise. */
+    sheets: zod_1.z.array(exports.ClientFileSheetOutlineSchema),
+    /** When extraction finished; null while it is pending or after it failed (then pages may all be NEEDS_OCR). */
+    extractedAt: zod_1.z.iso.datetime().nullable(),
+    extraction: zod_1.z.enum(ClientFileExtractionState),
+});
+exports.ClientFilePagesQuerySchema = zod_1.z
+    .object({ from: PageNumberSchema, to: PageNumberSchema })
+    .refine((range) => range.to >= range.from, { message: 'CLIENT_FILE_PAGE_RANGE_INVALID' })
+    .refine((range) => range.to - range.from < exports.CLIENT_FILE_MAX_PAGES_PER_READ, {
+    message: 'CLIENT_FILE_PAGE_RANGE_TOO_LONG',
+});
+exports.ClientFilePageTextSchema = exports.ClientFilePageOutlineSchema.extend({
+    /** The stored text; null when the page is NEEDS_OCR or EMPTY. */
+    text: zod_1.z.string().nullable(),
+});
+exports.ClientFilePagesResponseSchema = zod_1.z.object({
+    /** null while preparation is pending; optional for older file-service deployments. */
+    extractedAt: zod_1.z.iso.datetime().nullable().optional(),
+    fileId: zod_1.z.uuid(),
+    pages: zod_1.z.array(exports.ClientFilePageTextSchema),
+});
+/** OCR text the API recognised for pages that had none; file-service stores it with source OCR. */
+exports.ClientFileOcrWriteRequestSchema = zod_1.z.object({
+    pages: zod_1.z
+        .array(zod_1.z.object({
+        page: zod_1.z.number().int().min(1),
+        /** Recognised text; '' with `failed: true` when OCR failed (counts towards UNREADABLE). */
+        text: zod_1.z
+            .string()
+            .transform((text) => text.length > 200_000
+            ? text.slice(0, 200_000 - 16) + '\n[... truncated]'
+            : text),
+        failed: zod_1.z.boolean().optional(),
+    }))
+        .min(1)
+        .max(exports.CLIENT_FILE_MAX_PAGES_PER_READ),
+});
+exports.ClientFileOcrWriteResponseSchema = zod_1.z.object({ stored: zod_1.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. */
+exports.ClientFilePageAssetResponseSchema = zod_1.z.object({
+    page: zod_1.z.number().int().min(1),
+    url: zod_1.z.url(),
+    contentType: zod_1.z.enum(['application/pdf', 'image/jpeg']),
+});
+exports.ClientFileSheetRowsParamsSchema = zod_1.z.object({
+    fileId: zod_1.z.uuid(),
+    sheet: zod_1.z.coerce.number().int().min(0),
+});
+/** 1-based data rows (the header is row 0 and always returned separately). */
+exports.ClientFileSheetRowsQuerySchema = zod_1.z
+    .object({ from: PageNumberSchema, to: PageNumberSchema })
+    .refine((range) => range.to >= range.from, { message: 'CLIENT_FILE_ROW_RANGE_INVALID' })
+    .refine((range) => range.to - range.from < exports.CLIENT_FILE_MAX_ROWS_PER_READ, {
+    message: 'CLIENT_FILE_ROW_RANGE_TOO_LONG',
+});
+exports.ClientFileSheetRowsResponseSchema = zod_1.z.object({
+    /** null while preparation is pending; optional for older file-service deployments. */
+    extractedAt: zod_1.z.iso.datetime().nullable().optional(),
+    fileId: zod_1.z.uuid(),
+    sheet: zod_1.z.number().int().min(0),
+    name: zod_1.z.string(),
+    header: zod_1.z.array(zod_1.z.string()),
+    /** Cell values as text, one array per row, in the requested range (shorter at the end of the sheet). */
+    rows: zod_1.z.array(zod_1.z.array(zod_1.z.string())),
+    totalRows: zod_1.z.number().int().min(0),
+});
+exports.ClientFileTextLinesQuerySchema = zod_1.z
+    .object({ from: PageNumberSchema, to: PageNumberSchema })
+    .refine((range) => range.to >= range.from, { message: 'CLIENT_FILE_LINE_RANGE_INVALID' })
+    .refine((range) => range.to - range.from < exports.CLIENT_FILE_MAX_LINES_PER_READ, {
+    message: 'CLIENT_FILE_LINE_RANGE_TOO_LONG',
+});
+exports.ClientFileTextLinesResponseSchema = zod_1.z.object({
+    /** null while preparation is pending; optional for older file-service deployments. */
+    extractedAt: zod_1.z.iso.datetime().nullable().optional(),
+    fileId: zod_1.z.uuid(),
+    from: zod_1.z.number().int().min(1),
+    lines: zod_1.z.array(zod_1.z.string()),
+    totalLines: zod_1.z.number().int().min(0),
+});
+//# sourceMappingURL=client-file-pages.schema.js.map

package/build/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/v1/client-file/schemas/client-file-release-request.schema.d.ts

@@ -1,5 +1,10 @@
 import { z } from 'zod';
 import { S2SUploadAiImageOwnerType } from '../../s2s/schemas/s2s-upload-ai-image-owner-type.enum';
+/**
+ * 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 declare const ClientFileReleaseRequestSchema: z.ZodObject<{
     uuids: z.ZodArray<z.ZodString>;
     messageId: z.ZodString;

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

@@ -4,6 +4,11 @@ exports.ClientFileReleaseRequestSchema = void 0;
 const zod_1 = require("zod");
 const s2s_upload_ai_image_owner_type_enum_1 = require("../../s2s/schemas/s2s-upload-ai-image-owner-type.enum");
 const regex_1 = require("../../../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}
+ */
 exports.ClientFileReleaseRequestSchema = zod_1.z
     .object({
     uuids: zod_1.z

package/build/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,6BAAwB;AACxB,+GAAkG;AAClG,iDAAmD;AAOtC,QAAA,8BAA8B,GAAG,OAAC;KAC1C,MAAM,CAAC;IACJ,KAAK,EAAE,OAAC;SACH,KAAK,CACF,OAAC;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,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,IAAI,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IAClE,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,kBAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IAC/E,SAAS,EAAE,OAAC,CAAC,UAAU,CAAC,+DAAyB,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,6BAAwB;AACxB,+GAAkG;AAClG,iDAAmD;AAEnD;;;;GAIG;AACU,QAAA,8BAA8B,GAAG,OAAC;KAC1C,MAAM,CAAC;IACJ,KAAK,EAAE,OAAC;SACH,KAAK,CACF,OAAC;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,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,IAAI,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;IAClE,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;SAC9D,KAAK,CAAC,kBAAU,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IAC/E,SAAS,EAAE,OAAC,CAAC,UAAU,CAAC,+DAAyB,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/v1/client-file/schemas/client-file-release-response.schema.js

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

package/build/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,6BAAwB;AAEX,QAAA,+BAA+B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACJ,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAK7C,0BAA0B,EAAE,OAAC,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,6BAAwB;AAEX,QAAA,+BAA+B,GAAG,OAAC;KAC3C,MAAM,CAAC;IACJ,aAAa,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC7C;;;OAGG;IACH,0BAA0B,EAAE,OAAC,CAAC,OAAO,CAAC,IAAI,CAAC;CAC9C,CAAC;KACD,MAAM,EAAE,CAAC"}

package/build/v1/client-file/schemas/client-file-resolve-key.schema.d.ts

@@ -0,0 +1,8 @@
+import { z } from 'zod';
+export declare const ClientFileResolveKeyQuerySchema: z.ZodObject<{
+    chatId: z.ZodUUID;
+    key: z.ZodString;
+}, z.core.$strip>;
+export declare const ClientFileResolveKeyResponseSchema: z.ZodObject<{
+    fileId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientFileResolveKeyResponseSchema = exports.ClientFileResolveKeyQuerySchema = void 0;
+const zod_1 = require("zod");
+exports.ClientFileResolveKeyQuerySchema = zod_1.z.object({
+    chatId: zod_1.z.uuid({ error: 'ClientFileResolveKey.chatId.invalid' }),
+    key: zod_1.z
+        .string({ error: 'ClientFileResolveKey.key.required' })
+        .min(1, { message: 'ClientFileResolveKey.key.min' })
+        .max(2048, { message: 'ClientFileResolveKey.key.max' }),
+});
+exports.ClientFileResolveKeyResponseSchema = zod_1.z.object({ fileId: zod_1.z.uuid().nullable() });
+//# sourceMappingURL=client-file-resolve-key.schema.js.map

package/build/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,6BAAwB;AAEX,QAAA,+BAA+B,GAAG,OAAC,CAAC,MAAM,CAAC;IACpD,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,qCAAqC,EAAE,CAAC;IAChE,GAAG,EAAE,OAAC;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;AACU,QAAA,kCAAkC,GAAG,OAAC,CAAC,MAAM,CAAC,EAAE,MAAM,EAAE,OAAC,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC"}

package/build/v1/client-file/schemas/client-file-status.enum.d.ts

@@ -1,7 +1,25 @@
+/**
+ * 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 declare enum 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.
+     */
     UPLOADING = "UPLOADING",
+    /** Uploaded, not yet attached to a message. Default state after PUT upload. */
     PENDING = "PENDING",
+    /** Attached to a sent message; counts toward the user's chat history. */
     ATTACHED = "ATTACHED",
+    /** Generated by the assistant (image / file tool). Counts toward user quota — assistant outputs occupy real storage. */
     AI_GENERATED = "AI_GENERATED",
+    /** Soft-deleted by the user. Excluded from default listings and quota math. */
     DELETED = "DELETED"
 }

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

@@ -1,12 +1,30 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientFileStatus = void 0;
+/**
+ * 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.
+ */
 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 || (exports.ClientFileStatus = ClientFileStatus = {}));
 //# sourceMappingURL=client-file-status.enum.js.map

package/build/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,IAAY,gBAiBX;AAjBD,WAAY,gBAAgB;IAQxB,2CAAuB,CAAA;IAEvB,uCAAmB,CAAA;IAEnB,yCAAqB,CAAA;IAErB,iDAA6B,CAAA;IAE7B,uCAAmB,CAAA;AACvB,CAAC,EAjBW,gBAAgB,gCAAhB,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,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,gCAAhB,gBAAgB,QAiB3B"}

package/build/v1/client-file/schemas/client-file-upload-query.schema.d.ts

@@ -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 declare const ClientFileUploadQuerySchema: z.ZodObject<{
     marks: z.ZodPipe<z.ZodOptional<z.ZodUnion<readonly [z.ZodEnum<typeof ClientFileMark>, z.ZodArray<z.ZodEnum<typeof ClientFileMark>>]>>, z.ZodTransform<ClientFileMark[], ClientFileMark.PASTED | ClientFileMark.PASTED[] | undefined>>;
 }, z.core.$strip>;

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

@@ -3,6 +3,14 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientFileUploadQuerySchema = void 0;
 const zod_1 = require("zod");
 const client_file_mark_enum_1 = require("./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[]`.
+ */
 exports.ClientFileUploadQuerySchema = zod_1.z.object({
     marks: zod_1.z
         .union([zod_1.z.enum(client_file_mark_enum_1.ClientFileMark), zod_1.z.array(zod_1.z.enum(client_file_mark_enum_1.ClientFileMark))])

package/build/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,6BAAwB;AACxB,mEAAyD;AAU5C,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,KAAK,CAAC,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,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,6BAAwB;AACxB,mEAAyD;AAEzD;;;;;;;GAOG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC;SACH,KAAK,CAAC,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,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/v1/client-file/schemas/index.d.ts

@@ -19,3 +19,4 @@ 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';

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

@@ -35,4 +35,5 @@ __exportStar(require("./user-file-item-response.schema"), exports);
 __exportStar(require("./user-files-list-request.schema"), exports);
 __exportStar(require("./user-files-list-response.schema"), exports);
 __exportStar(require("./user-files-stats-response.schema"), exports);
+__exportStar(require("./client-file-pages.schema"), exports);
 //# sourceMappingURL=index.js.map

package/build/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,0DAAwC;AACxC,4DAA0C;AAC1C,0DAAwC;AACxC,gEAA8C;AAC9C,mEAAiD;AACjD,oEAAkD;AAClD,qEAAmD;AACnD,qEAAmD;AACnD,uEAAqD;AACrD,oEAAkD;AAClD,uEAAqD;AACrD,sEAAoD;AACpD,uEAAqD;AACrD,uEAAqD;AACrD,wEAAsD;AACtD,2DAAyC;AACzC,6DAA2C;AAC3C,mEAAiD;AACjD,mEAAiD;AACjD,oEAAkD;AAClD,qEAAmD"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,0DAAwC;AACxC,4DAA0C;AAC1C,0DAAwC;AACxC,gEAA8C;AAC9C,mEAAiD;AACjD,oEAAkD;AAClD,qEAAmD;AACnD,qEAAmD;AACnD,uEAAqD;AACrD,oEAAkD;AAClD,uEAAqD;AACrD,sEAAoD;AACpD,uEAAqD;AACrD,uEAAqD;AACrD,wEAAsD;AACtD,2DAAyC;AACzC,6DAA2C;AAC3C,mEAAiD;AACjD,mEAAiD;AACjD,oEAAkD;AAClD,qEAAmD;AACnD,6DAA2C"}

package/build/v1/client-file/schemas/processing-category.enum.d.ts

@@ -1,6 +1,15 @@
+/**
+ * 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 declare enum FileProcessingCategory {
+    /** Text-native files (csv, json, txt, md, code) — raw text inline, no PDF conversion */
     TEXT_NATIVE = "TEXT_NATIVE",
+    /** Visual documents (docx, pptx, xlsx, html) — Gotenberg PDF conversion, layout matters */
     VISUAL_DOC = "VISUAL_DOC",
+    /** PDF files — passed as-is, no conversion needed */
     PDF = "PDF",
+    /** Image files — passed as image_url to LLM */
     IMAGE = "IMAGE"
 }

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

@@ -1,11 +1,20 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.FileProcessingCategory = void 0;
+/**
+ * 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.
+ */
 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 || (exports.FileProcessingCategory = FileProcessingCategory = {}));
 //# sourceMappingURL=processing-category.enum.js.map

package/build/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,IAAY,sBASX;AATD,WAAY,sBAAsB;IAE9B,qDAA2B,CAAA;IAE3B,mDAAyB,CAAA;IAEzB,qCAAW,CAAA;IAEX,yCAAe,CAAA;AACnB,CAAC,EATW,sBAAsB,sCAAtB,sBAAsB,QASjC"}
+{"version":3,"file":"processing-category.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/processing-category.enum.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,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,sCAAtB,sBAAsB,QASjC"}