@veruna/api-contracts 19.1.0 → 20.1.0

package/build/v1/client-file/queries/client-file-reading.s2s.d.ts

@@ -0,0 +1,183 @@
+import { z } from 'zod';
+import { HttpMethod } from '../../../shared/http-method.enum';
+/** S2S (api → file-service): the reading outline of one client file — kind, pages with status/hint, sheets. */
+export declare namespace ClientFileOutlineS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        fileId: z.ZodUUID;
+        kind: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFileContentKind>;
+        pageCount: z.ZodNullable<z.ZodNumber>;
+        lineCount: z.ZodNullable<z.ZodNumber>;
+        pages: z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            status: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageStatus>;
+            source: z.ZodNullable<z.ZodEnum<typeof import("../schemas/client-file-pages.schema").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 import("../schemas/client-file-pages.schema").ClientFileExtractionState>;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: stored text of up to CLIENT_FILE_MAX_PAGES_PER_READ pages (`?from=&to=`); NEEDS_OCR pages have text null. */
+export declare namespace ClientFilePagesS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Query: z.ZodObject<{
+        from: z.ZodCoercedNumber<unknown>;
+        to: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        extractedAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
+        fileId: z.ZodUUID;
+        pages: z.ZodArray<z.ZodObject<{
+            page: z.ZodNumber;
+            status: z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageStatus>;
+            source: z.ZodNullable<z.ZodEnum<typeof import("../schemas/client-file-pages.schema").ClientFilePageSource>>;
+            chars: z.ZodNumber;
+            hint: z.ZodString;
+            hasFigures: z.ZodBoolean;
+            text: z.ZodNullable<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: store OCR text the API recognised; a page that already has text keeps it (first write wins). */
+export declare namespace ClientFileOcrPagesS2SCommand {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Request: 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>;
+    const Response: z.ZodObject<{
+        stored: z.ZodNumber;
+    }, z.core.$strip>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.PUT;
+    type ParamsType = z.infer<typeof Params>;
+    type RequestType = z.infer<typeof Request>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: a one-page PDF of the page (for OCR), cut once and kept in storage. */
+export declare namespace ClientFilePagePdfS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+        page: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        page: z.ZodNumber;
+        url: z.ZodURL;
+        contentType: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "application/pdf": "application/pdf";
+        }>;
+    }, z.core.$strip>;
+    const URL: (fileId: string, page: number) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: the page rendered as a JPEG (for "look at the page"), rendered once and kept in storage. */
+export declare namespace ClientFilePageImageS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+        page: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        page: z.ZodNumber;
+        url: z.ZodURL;
+        contentType: z.ZodEnum<{
+            "image/jpeg": "image/jpeg";
+            "application/pdf": "application/pdf";
+        }>;
+    }, z.core.$strip>;
+    const URL: (fileId: string, page: number) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: up to CLIENT_FILE_MAX_ROWS_PER_READ data rows of one sheet (`?from=&to=`, 1-based data rows). */
+export declare namespace ClientFileSheetRowsS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+        sheet: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Query: z.ZodObject<{
+        from: z.ZodCoercedNumber<unknown>;
+        to: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: 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>;
+    const URL: (fileId: string, sheet: number) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: up to CLIENT_FILE_MAX_LINES_PER_READ lines of a text file (`?from=&to=`, 1-based). */
+export declare namespace ClientFileTextLinesS2SQuery {
+    const Params: z.ZodObject<{
+        fileId: z.ZodUUID;
+    }, z.core.$strip>;
+    const Query: z.ZodObject<{
+        from: z.ZodCoercedNumber<unknown>;
+        to: z.ZodCoercedNumber<unknown>;
+    }, z.core.$strip>;
+    const Response: 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>;
+    const URL: (fileId: string) => string;
+    const METHOD = HttpMethod.GET;
+    type ParamsType = z.infer<typeof Params>;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}
+/** S2S: resolve a legacy attachment's storage key within its authorized chat. */
+export declare namespace ClientFileResolveKeyS2SQuery {
+    const Query: z.ZodObject<{
+        chatId: z.ZodUUID;
+        key: z.ZodString;
+    }, z.core.$strip>;
+    const Response: z.ZodObject<{
+        fileId: z.ZodNullable<z.ZodUUID>;
+    }, z.core.$strip>;
+    const URL: "/file-api/s2s/files/client-file/resolve-key";
+    const METHOD = HttpMethod.GET;
+    type QueryType = z.infer<typeof Query>;
+    type ResponseType = z.infer<typeof Response>;
+}

package/build/v1/client-file/queries/client-file-reading.s2s.js

@@ -0,0 +1,76 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ClientFileResolveKeyS2SQuery = exports.ClientFileTextLinesS2SQuery = exports.ClientFileSheetRowsS2SQuery = exports.ClientFilePageImageS2SQuery = exports.ClientFilePagePdfS2SQuery = exports.ClientFileOcrPagesS2SCommand = exports.ClientFilePagesS2SQuery = exports.ClientFileOutlineS2SQuery = void 0;
+const client_file_resolve_key_schema_1 = require("../schemas/client-file-resolve-key.schema");
+const client_file_pages_schema_1 = require("../schemas/client-file-pages.schema");
+const rest_api_1 = require("../../../rest-api");
+const http_method_enum_1 = require("../../../shared/http-method.enum");
+/** S2S (api → file-service): the reading outline of one client file — kind, pages with status/hint, sheets. */
+var ClientFileOutlineS2SQuery;
+(function (ClientFileOutlineS2SQuery) {
+    ClientFileOutlineS2SQuery.Params = client_file_pages_schema_1.ClientFileIdParamsSchema;
+    ClientFileOutlineS2SQuery.Response = client_file_pages_schema_1.ClientFileOutlineResponseSchema;
+    ClientFileOutlineS2SQuery.URL = (fileId) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_OUTLINE(fileId);
+    ClientFileOutlineS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFileOutlineS2SQuery || (exports.ClientFileOutlineS2SQuery = ClientFileOutlineS2SQuery = {}));
+/** S2S: stored text of up to CLIENT_FILE_MAX_PAGES_PER_READ pages (`?from=&to=`); NEEDS_OCR pages have text null. */
+var ClientFilePagesS2SQuery;
+(function (ClientFilePagesS2SQuery) {
+    ClientFilePagesS2SQuery.Params = client_file_pages_schema_1.ClientFileIdParamsSchema;
+    ClientFilePagesS2SQuery.Query = client_file_pages_schema_1.ClientFilePagesQuerySchema;
+    ClientFilePagesS2SQuery.Response = client_file_pages_schema_1.ClientFilePagesResponseSchema;
+    ClientFilePagesS2SQuery.URL = (fileId) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_PAGES(fileId);
+    ClientFilePagesS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFilePagesS2SQuery || (exports.ClientFilePagesS2SQuery = ClientFilePagesS2SQuery = {}));
+/** S2S: store OCR text the API recognised; a page that already has text keeps it (first write wins). */
+var ClientFileOcrPagesS2SCommand;
+(function (ClientFileOcrPagesS2SCommand) {
+    ClientFileOcrPagesS2SCommand.Params = client_file_pages_schema_1.ClientFileIdParamsSchema;
+    ClientFileOcrPagesS2SCommand.Request = client_file_pages_schema_1.ClientFileOcrWriteRequestSchema;
+    ClientFileOcrPagesS2SCommand.Response = client_file_pages_schema_1.ClientFileOcrWriteResponseSchema;
+    ClientFileOcrPagesS2SCommand.URL = (fileId) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_OCR_PAGES(fileId);
+    ClientFileOcrPagesS2SCommand.METHOD = http_method_enum_1.HttpMethod.PUT;
+})(ClientFileOcrPagesS2SCommand || (exports.ClientFileOcrPagesS2SCommand = ClientFileOcrPagesS2SCommand = {}));
+/** S2S: a one-page PDF of the page (for OCR), cut once and kept in storage. */
+var ClientFilePagePdfS2SQuery;
+(function (ClientFilePagePdfS2SQuery) {
+    ClientFilePagePdfS2SQuery.Params = client_file_pages_schema_1.ClientFilePageParamsSchema;
+    ClientFilePagePdfS2SQuery.Response = client_file_pages_schema_1.ClientFilePageAssetResponseSchema;
+    ClientFilePagePdfS2SQuery.URL = (fileId, page) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_PAGE_PDF(fileId, page);
+    ClientFilePagePdfS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFilePagePdfS2SQuery || (exports.ClientFilePagePdfS2SQuery = ClientFilePagePdfS2SQuery = {}));
+/** S2S: the page rendered as a JPEG (for "look at the page"), rendered once and kept in storage. */
+var ClientFilePageImageS2SQuery;
+(function (ClientFilePageImageS2SQuery) {
+    ClientFilePageImageS2SQuery.Params = client_file_pages_schema_1.ClientFilePageParamsSchema;
+    ClientFilePageImageS2SQuery.Response = client_file_pages_schema_1.ClientFilePageAssetResponseSchema;
+    ClientFilePageImageS2SQuery.URL = (fileId, page) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_PAGE_IMAGE(fileId, page);
+    ClientFilePageImageS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFilePageImageS2SQuery || (exports.ClientFilePageImageS2SQuery = ClientFilePageImageS2SQuery = {}));
+/** S2S: up to CLIENT_FILE_MAX_ROWS_PER_READ data rows of one sheet (`?from=&to=`, 1-based data rows). */
+var ClientFileSheetRowsS2SQuery;
+(function (ClientFileSheetRowsS2SQuery) {
+    ClientFileSheetRowsS2SQuery.Params = client_file_pages_schema_1.ClientFileSheetRowsParamsSchema;
+    ClientFileSheetRowsS2SQuery.Query = client_file_pages_schema_1.ClientFileSheetRowsQuerySchema;
+    ClientFileSheetRowsS2SQuery.Response = client_file_pages_schema_1.ClientFileSheetRowsResponseSchema;
+    ClientFileSheetRowsS2SQuery.URL = (fileId, sheet) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_SHEET_ROWS(fileId, sheet);
+    ClientFileSheetRowsS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFileSheetRowsS2SQuery || (exports.ClientFileSheetRowsS2SQuery = ClientFileSheetRowsS2SQuery = {}));
+/** S2S: up to CLIENT_FILE_MAX_LINES_PER_READ lines of a text file (`?from=&to=`, 1-based). */
+var ClientFileTextLinesS2SQuery;
+(function (ClientFileTextLinesS2SQuery) {
+    ClientFileTextLinesS2SQuery.Params = client_file_pages_schema_1.ClientFileIdParamsSchema;
+    ClientFileTextLinesS2SQuery.Query = client_file_pages_schema_1.ClientFileTextLinesQuerySchema;
+    ClientFileTextLinesS2SQuery.Response = client_file_pages_schema_1.ClientFileTextLinesResponseSchema;
+    ClientFileTextLinesS2SQuery.URL = (fileId) => rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_TEXT_LINES(fileId);
+    ClientFileTextLinesS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFileTextLinesS2SQuery || (exports.ClientFileTextLinesS2SQuery = ClientFileTextLinesS2SQuery = {}));
+/** S2S: resolve a legacy attachment's storage key within its authorized chat. */
+var ClientFileResolveKeyS2SQuery;
+(function (ClientFileResolveKeyS2SQuery) {
+    ClientFileResolveKeyS2SQuery.Query = client_file_resolve_key_schema_1.ClientFileResolveKeyQuerySchema;
+    ClientFileResolveKeyS2SQuery.Response = client_file_resolve_key_schema_1.ClientFileResolveKeyResponseSchema;
+    ClientFileResolveKeyS2SQuery.URL = rest_api_1.REST_API.V1.FILE_S2S.CLIENT_FILE_RESOLVE_KEY;
+    ClientFileResolveKeyS2SQuery.METHOD = http_method_enum_1.HttpMethod.GET;
+})(ClientFileResolveKeyS2SQuery || (exports.ClientFileResolveKeyS2SQuery = ClientFileResolveKeyS2SQuery = {}));
+//# sourceMappingURL=client-file-reading.s2s.js.map

package/build/v1/client-file/queries/client-file-reading.s2s.js.map

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

package/build/v1/client-file/queries/index.d.ts

@@ -1,3 +1,4 @@
 export * from './client-file-list.query';
 export * from './user-files-list.query';
 export * from './user-files-stats.query';
+export * from './client-file-reading.s2s';

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

@@ -17,4 +17,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./client-file-list.query"), exports);
 __exportStar(require("./user-files-list.query"), exports);
 __exportStar(require("./user-files-stats.query"), exports);
+__exportStar(require("./client-file-reading.s2s"), exports);
 //# sourceMappingURL=index.js.map

package/build/v1/client-file/queries/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/client-file/queries/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,0DAAwC;AACxC,2DAAyC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../v1/client-file/queries/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2DAAyC;AACzC,0DAAwC;AACxC,2DAAyC;AACzC,4DAA0C"}

package/build/v1/client-file/queries/user-files-list.query.d.ts

@@ -1,5 +1,10 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * `GET /file-api/v1/client/files`
+ *
+ * Cursor-paginated cross-chat listing for the current user.
+ */
 export declare namespace UserFilesListQuery {
     const Request: z.ZodObject<{
         cursor: z.ZodOptional<z.ZodString>;

package/build/v1/client-file/queries/user-files-list.query.js

@@ -4,6 +4,11 @@ exports.UserFilesListQuery = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * `GET /file-api/v1/client/files`
+ *
+ * Cursor-paginated cross-chat listing for the current user.
+ */
 var UserFilesListQuery;
 (function (UserFilesListQuery) {
     UserFilesListQuery.Request = schemas_1.UserFilesListRequestSchema;

package/build/v1/client-file/queries/user-files-list.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-files-list.query.js","sourceRoot":"","sources":["../../../../v1/client-file/queries/user-files-list.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAO9D,IAAiB,kBAAkB,CAQlC;AARD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,oCAA0B,CAAC;IACrC,2BAAQ,GAAG,qCAA2B,CAAC;IACvC,sBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,yBAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EARgB,kBAAkB,kCAAlB,kBAAkB,QAQlC"}
+{"version":3,"file":"user-files-list.query.js","sourceRoot":"","sources":["../../../../v1/client-file/queries/user-files-list.query.ts"],"names":[],"mappings":";;;AACA,wCAGoB;AACpB,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;GAIG;AACH,IAAiB,kBAAkB,CAQlC;AARD,WAAiB,kBAAkB;IAClB,0BAAO,GAAG,oCAA0B,CAAC;IACrC,2BAAQ,GAAG,qCAA2B,CAAC;IACvC,sBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC;IACtC,yBAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EARgB,kBAAkB,kCAAlB,kBAAkB,QAQlC"}

package/build/v1/client-file/queries/user-files-stats.query.d.ts

@@ -1,5 +1,11 @@
 import { z } from 'zod';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * `GET /file-api/v1/client/files/stats`
+ *
+ * Aggregate file storage stats for the current user (totals, quota,
+ * by-status / by-type breakdowns).
+ */
 export declare namespace UserFilesStatsQuery {
     const Response: z.ZodObject<{
         totalFiles: z.ZodNumber;

package/build/v1/client-file/queries/user-files-stats.query.js

@@ -4,6 +4,12 @@ exports.UserFilesStatsQuery = void 0;
 const schemas_1 = require("../schemas");
 const rest_api_1 = require("../../../rest-api");
 const http_method_enum_1 = require("../../../shared/http-method.enum");
+/**
+ * `GET /file-api/v1/client/files/stats`
+ *
+ * Aggregate file storage stats for the current user (totals, quota,
+ * by-status / by-type breakdowns).
+ */
 var UserFilesStatsQuery;
 (function (UserFilesStatsQuery) {
     UserFilesStatsQuery.Response = schemas_1.UserFilesStatsResponseSchema;

package/build/v1/client-file/queries/user-files-stats.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"user-files-stats.query.js","sourceRoot":"","sources":["../../../../v1/client-file/queries/user-files-stats.query.ts"],"names":[],"mappings":";;;AACA,wCAA0D;AAC1D,gDAA6C;AAC7C,uEAA8D;AAQ9D,IAAiB,mBAAmB,CAMnC;AAND,WAAiB,mBAAmB;IACnB,4BAAQ,GAAG,sCAA4B,CAAC;IACxC,uBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;IACvC,0BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EANgB,mBAAmB,mCAAnB,mBAAmB,QAMnC"}
+{"version":3,"file":"user-files-stats.query.js","sourceRoot":"","sources":["../../../../v1/client-file/queries/user-files-stats.query.ts"],"names":[],"mappings":";;;AACA,wCAA0D;AAC1D,gDAA6C;AAC7C,uEAA8D;AAE9D;;;;;GAKG;AACH,IAAiB,mBAAmB,CAMnC;AAND,WAAiB,mBAAmB;IACnB,4BAAQ,GAAG,sCAA4B,CAAC;IACxC,uBAAG,GAAG,mBAAQ,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC;IACvC,0BAAM,GAAG,6BAAU,CAAC,GAAG,CAAC;AAGzC,CAAC,EANgB,mBAAmB,mCAAnB,mBAAmB,QAMnC"}

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

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { S2SUploadAiImageOwnerType } from '../../s2s/schemas/s2s-upload-ai-image-owner-type.enum';
+/**
+ * Client File Attach Request
+ * Error messages: ClientFileAttachRequest.{field}.{rule}
+ */
 export declare const ClientFileAttachRequestSchema: z.ZodObject<{
     uuids: z.ZodArray<z.ZodString>;
     messageId: z.ZodString;

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

@@ -4,6 +4,10 @@ exports.ClientFileAttachRequestSchema = 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");
+/**
+ * Client File Attach Request
+ * Error messages: ClientFileAttachRequest.{field}.{rule}
+ */
 exports.ClientFileAttachRequestSchema = zod_1.z
     .object({
     uuids: zod_1.z

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

@@ -1 +1 @@
-{"version":3,"file":"client-file-attach-request.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-attach-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+GAAkG;AAClG,iDAAmD;AAMtC,QAAA,6BAA6B,GAAG,OAAC;KACzC,MAAM,CAAC;IACJ,KAAK,EAAE,OAAC;SACH,KAAK,CACF,OAAC;SACI,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;SAC3D,IAAI,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAChE;SACA,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IAC3D,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,IAAI,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IACjE,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;SAC7D,KAAK,CAAC,kBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IAC9E,SAAS,EAAE,OAAC,CAAC,UAAU,CAAC,+DAAyB,EAAE;QAC/C,KAAK,EAAE,2CAA2C;KACrD,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,0CAA0C;IACnD,IAAI,EAAE,CAAC,OAAO,CAAC;CAClB,CAAC,CAAC"}
+{"version":3,"file":"client-file-attach-request.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-attach-request.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,+GAAkG;AAClG,iDAAmD;AAEnD;;;GAGG;AACU,QAAA,6BAA6B,GAAG,OAAC;KACzC,MAAM,CAAC;IACJ,KAAK,EAAE,OAAC;SACH,KAAK,CACF,OAAC;SACI,MAAM,CAAC,EAAE,KAAK,EAAE,wCAAwC,EAAE,CAAC;SAC3D,IAAI,CAAC,EAAE,KAAK,EAAE,uCAAuC,EAAE,CAAC,CAChE;SACA,GAAG,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;IAC3D,SAAS,EAAE,OAAC;SACP,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,IAAI,CAAC,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC;IACjE,OAAO,EAAE,OAAC;SACL,MAAM,CAAC,EAAE,KAAK,EAAE,0CAA0C,EAAE,CAAC;SAC7D,KAAK,CAAC,kBAAU,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;IAC9E,SAAS,EAAE,OAAC,CAAC,UAAU,CAAC,+DAAyB,EAAE;QAC/C,KAAK,EAAE,2CAA2C;KACrD,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,0CAA0C;IACnD,IAAI,EAAE,CAAC,OAAO,CAAC;CAClB,CAAC,CAAC"}

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

@@ -16,12 +16,19 @@ exports.ClientFileAttachmentItemSchema = zod_1.z.object({
     originalFilename: zod_1.z.string().min(1),
     originalContentType: zod_1.z.string().min(1),
     originalSize: zod_1.z.number().int().nonnegative(),
+    /** S3 key for the original unprocessed file. Null for legacy uploads. */
     originalKey: zod_1.z.string().nullable().optional(),
+    /** How the file was processed (text_native, visual_doc, pdf, image). */
     processingCategory: zod_1.z.string().nullable().optional(),
+    /** Approximate token count for text-native files. */
     extractedTokenCount: zod_1.z.number().int().nullable().optional(),
+    /** Truncated preview for large text-native files. */
     textPreview: zod_1.z.string().nullable().optional(),
+    /** Number of pages for PDF/visual_doc files. */
     pageCount: zod_1.z.number().int().nullable().optional(),
+    /** Public URL of the first-N-pages preview PDF (when pageCount exceeds threshold). */
     shortPreviewUrl: zod_1.z.string().url().nullable().optional(),
+    /** Frontend-facing flags propagated from the client-file row. */
     marks: zod_1.z.array(zod_1.z.enum(client_file_mark_enum_1.ClientFileMark)),
 });
 exports.ClientFileAttachResponseSchema = zod_1.z.object({

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

@@ -1 +1 @@
-{"version":3,"file":"client-file-attach-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-attach-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,mEAAyD;AACzD,mEAAyD;AAE5C,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAE5C,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE7C,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEpD,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE3D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE7C,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEjD,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEvD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;CACzC,CAAC,CAAC;AAEU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,sCAA8B,CAAC;CACjD,CAAC,CAAC"}
+{"version":3,"file":"client-file-attach-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-attach-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,mEAAyD;AACzD,mEAAyD;AAE5C,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC;IAC5B,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,MAAM,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,yEAAyE;IACzE,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,wEAAwE;IACxE,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,qDAAqD;IACrD,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3D,qDAAqD;IACrD,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,gDAAgD;IAChD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,sFAAsF;IACtF,eAAe,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvD,iEAAiE;IACjE,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;CACzC,CAAC,CAAC;AAEU,QAAA,8BAA8B,GAAG,OAAC,CAAC,MAAM,CAAC;IACnD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,sCAA8B,CAAC;CACjD,CAAC,CAAC"}

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

@@ -1,4 +1,7 @@
 import { z } from 'zod';
+/**
+ * Client File Params (chatId)
+ */
 export declare const ClientFileChatParamsSchema: z.ZodObject<{
     chatId: z.ZodString;
 }, z.core.$strip>;

package/build/v1/client-file/schemas/client-file-chat-params.schema.js

@@ -2,5 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientFileChatParamsSchema = void 0;
 const schemas_1 = require("../../chat/schemas");
+/**
+ * Client File Params (chatId)
+ */
 exports.ClientFileChatParamsSchema = schemas_1.ChatIdParamSchema;
 //# sourceMappingURL=client-file-chat-params.schema.js.map

package/build/v1/client-file/schemas/client-file-chat-params.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-file-chat-params.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-chat-params.schema.ts"],"names":[],"mappings":";;;AACA,gDAAuD;AAK1C,QAAA,0BAA0B,GAAG,2BAAiB,CAAC"}
+{"version":3,"file":"client-file-chat-params.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-chat-params.schema.ts"],"names":[],"mappings":";;;AACA,gDAAuD;AAEvD;;GAEG;AACU,QAAA,0BAA0B,GAAG,2BAAiB,CAAC"}

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

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Client File ID Param Schema
+ * Error messages: ClientFileIdParam.{field}.{rule}
+ */
 export declare const ClientFileIdParamSchema: z.ZodObject<{
     fileId: z.ZodString;
 }, z.core.$strip>;

package/build/v1/client-file/schemas/client-file-id-param.schema.js

@@ -2,6 +2,10 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientFileIdParamSchema = void 0;
 const zod_1 = require("zod");
+/**
+ * Client File ID Param Schema
+ * Error messages: ClientFileIdParam.{field}.{rule}
+ */
 exports.ClientFileIdParamSchema = zod_1.z.object({
     fileId: zod_1.z
         .string({ error: 'ClientFileIdParam.fileId.required' })

package/build/v1/client-file/schemas/client-file-id-param.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"client-file-id-param.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-id-param.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAMX,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,IAAI,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;CAC3D,CAAC,CAAC"}
+{"version":3,"file":"client-file-id-param.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-id-param.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB;;;GAGG;AACU,QAAA,uBAAuB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC5C,MAAM,EAAE,OAAC;SACJ,MAAM,CAAC,EAAE,KAAK,EAAE,mCAAmC,EAAE,CAAC;SACtD,IAAI,CAAC,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;CAC3D,CAAC,CAAC"}

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

@@ -2,6 +2,20 @@ import { z } from 'zod';
 import { ClientFileType } from './client-file-type.enum';
 import { ClientFileStatus } from './client-file-status.enum';
 import { ClientFileMark } from './client-file-mark.enum';
+/**
+ * Per-chat client file row. `status` reflects the lifecycle of the
+ * underlying `client_file_objects` record — see {@link ClientFileStatus}.
+ * The chat-scoped list endpoint only ever returns `PENDING` rows, but the
+ * field is included so a single response shape works across the
+ * cross-chat user-files endpoint as well.
+ *
+ * The processing fields at the bottom mirror the ones on
+ * {@link ClientFileAttachmentItemSchema}. They are what tells a caller how
+ * much of the file will actually reach the model — a small text file is
+ * inlined whole, a long one only as a preview, a 200-page PDF only as its
+ * first pages. The api needs that BEFORE attaching, to refuse an upload it
+ * could not read in full; the attach response alone comes too late.
+ */
 export declare const ClientFileItemResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     type: z.ZodEnum<typeof ClientFileType>;

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

@@ -6,6 +6,20 @@ const shared_1 = require("../../../shared");
 const client_file_type_enum_1 = require("./client-file-type.enum");
 const client_file_status_enum_1 = require("./client-file-status.enum");
 const client_file_mark_enum_1 = require("./client-file-mark.enum");
+/**
+ * Per-chat client file row. `status` reflects the lifecycle of the
+ * underlying `client_file_objects` record — see {@link ClientFileStatus}.
+ * The chat-scoped list endpoint only ever returns `PENDING` rows, but the
+ * field is included so a single response shape works across the
+ * cross-chat user-files endpoint as well.
+ *
+ * The processing fields at the bottom mirror the ones on
+ * {@link ClientFileAttachmentItemSchema}. They are what tells a caller how
+ * much of the file will actually reach the model — a small text file is
+ * inlined whole, a long one only as a preview, a 200-page PDF only as its
+ * first pages. The api needs that BEFORE attaching, to refuse an upload it
+ * could not read in full; the attach response alone comes too late.
+ */
 exports.ClientFileItemResponseSchema = zod_1.z.object({
     uuid: zod_1.z.string().regex(shared_1.UUID_REGEX),
     type: zod_1.z.enum(client_file_type_enum_1.ClientFileType),
@@ -17,9 +31,13 @@ exports.ClientFileItemResponseSchema = zod_1.z.object({
     originalFilename: zod_1.z.string().min(1),
     originalContentType: zod_1.z.string().min(1),
     marks: zod_1.z.array(zod_1.z.enum(client_file_mark_enum_1.ClientFileMark)),
+    /** How the file was processed (TEXT_NATIVE, VISUAL_DOC, PDF, IMAGE). */
     processingCategory: zod_1.z.string().nullable().optional(),
+    /** Number of pages for PDF/visual-doc files. */
     pageCount: zod_1.z.number().int().nullable().optional(),
+    /** Approximate token count for text-native files. */
     extractedTokenCount: zod_1.z.number().int().nullable().optional(),
+    /** Set only when the file was too long to inline whole. */
     textPreview: zod_1.z.string().nullable().optional(),
 });
 //# sourceMappingURL=client-file-item-response.schema.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"client-file-item-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-item-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,mEAAyD;AACzD,uEAA6D;AAC7D,mEAAyD;AAgB5C,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC;IAC5B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;IAEtC,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEpD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAEjD,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAE3D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}
+{"version":3,"file":"client-file-item-response.schema.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-item-response.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,4CAA6C;AAC7C,mEAAyD;AACzD,uEAA6D;AAC7D,mEAAyD;AAEzD;;;;;;;;;;;;;GAaG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;IAClC,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC;IAC5B,MAAM,EAAE,OAAC,CAAC,IAAI,CAAC,0CAAgB,CAAC;IAChC,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IACpC,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC5C,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACnC,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IACtC,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;IACtC,wEAAwE;IACxE,kBAAkB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACpD,gDAAgD;IAChD,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,qDAAqD;IACrD,mBAAmB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3D,2DAA2D;IAC3D,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;CAChD,CAAC,CAAC"}

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

@@ -1,3 +1,13 @@
+/**
+ * Client-file marks/flags. Stored as an array so a single file can carry
+ * multiple marks. The marks are populated by the client (frontend) and
+ * round-tripped on every response shape — the backend doesn't act on
+ * them, it only persists the list.
+ */
 export declare enum ClientFileMark {
+    /**
+     * File was pasted from the clipboard rather than picked through the
+     * file dialog. Used by the FE to render the file differently.
+     */
     PASTED = "PASTED"
 }

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

@@ -1,8 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ClientFileMark = void 0;
+/**
+ * Client-file marks/flags. Stored as an array so a single file can carry
+ * multiple marks. The marks are populated by the client (frontend) and
+ * round-tripped on every response shape — the backend doesn't act on
+ * them, it only persists the list.
+ */
 var ClientFileMark;
 (function (ClientFileMark) {
+    /**
+     * File was pasted from the clipboard rather than picked through the
+     * file dialog. Used by the FE to render the file differently.
+     */
     ClientFileMark["PASTED"] = "PASTED";
 })(ClientFileMark || (exports.ClientFileMark = ClientFileMark = {}));
 //# sourceMappingURL=client-file-mark.enum.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"client-file-mark.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-mark.enum.ts"],"names":[],"mappings":";;;AAMA,IAAY,cAMX;AAND,WAAY,cAAc;IAKtB,mCAAiB,CAAA;AACrB,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB"}
+{"version":3,"file":"client-file-mark.enum.js","sourceRoot":"","sources":["../../../../v1/client-file/schemas/client-file-mark.enum.ts"],"names":[],"mappings":";;;AAAA;;;;;GAKG;AACH,IAAY,cAMX;AAND,WAAY,cAAc;IACtB;;;OAGG;IACH,mCAAiB,CAAA;AACrB,CAAC,EANW,cAAc,8BAAd,cAAc,QAMzB"}