@veruna/api-contracts 20.0.0 → 20.2.0

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

@@ -3,6 +3,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 declare const UserFileItemResponseSchema: z.ZodObject<{
     uuid: z.ZodString;
     type: z.ZodEnum<typeof ClientFileType>;

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

@@ -7,6 +7,14 @@ 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");
 const processing_category_enum_1 = require("./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.
+ */
 exports.UserFileItemResponseSchema = 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),

package/build/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,6BAAwB;AACxB,4CAA6C;AAC7C,mEAAyD;AACzD,uEAA6D;AAC7D,mEAAyD;AACzD,yEAAoE;AAUvD,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,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,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QACd,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;KACnC,CAAC;IACF,UAAU,EAAE,OAAC;SACR,MAAM,CAAC;QACJ,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;KACnC,CAAC;SACD,QAAQ,EAAE;IACf,kBAAkB,EAAE,OAAC,CAAC,IAAI,CAAC,iDAAsB,CAAC,CAAC,QAAQ,EAAE;IAC7D,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;IACtC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,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,6BAAwB;AACxB,4CAA6C;AAC7C,mEAAyD;AACzD,uEAA6D;AAC7D,mEAAyD;AACzD,yEAAoE;AAEpE;;;;;;;GAOG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,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,OAAO,EAAE,OAAC,CAAC,MAAM,CAAC;QACd,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;KACnC,CAAC;IACF,UAAU,EAAE,OAAC;SACR,MAAM,CAAC;QACJ,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,mBAAU,CAAC;KACnC,CAAC;SACD,QAAQ,EAAE;IACf,kBAAkB,EAAE,OAAC,CAAC,IAAI,CAAC,iDAAsB,CAAC,CAAC,QAAQ,EAAE;IAC7D,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,CAAC,CAAC;IACtC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC,CAAC"}

package/build/v1/client-file/schemas/user-files-list-request.schema.d.ts

@@ -1,6 +1,17 @@
 import { z } from 'zod';
 import { ClientFileStatus } from './client-file-status.enum';
 import { ClientFileType } from './client-file-type.enum';
+/**
+ * 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 declare const UserFilesListRequestSchema: z.ZodObject<{
     cursor: z.ZodOptional<z.ZodString>;
     limit: z.ZodDefault<z.ZodCoercedNumber<unknown>>;

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

@@ -4,8 +4,25 @@ exports.UserFilesListRequestSchema = void 0;
 const zod_1 = require("zod");
 const client_file_status_enum_1 = require("./client-file-status.enum");
 const client_file_type_enum_1 = require("./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(client_file_status_enum_1.ClientFileStatus).length;
 const TYPE_FILTER_MAX = Object.values(client_file_type_enum_1.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>`.
+ */
 exports.UserFilesListRequestSchema = zod_1.z.object({
     cursor: zod_1.z
         .string({ error: 'UserFilesListRequest.cursor.invalid' })

package/build/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,6BAAwB;AACxB,uEAA6D;AAC7D,mEAAyD;AAQzD,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,0CAAgB,CAAC,CAAC,MAAM,CAAC;AACjE,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,sCAAc,CAAC,CAAC,MAAM,CAAC;AAahD,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,OAAC;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,OAAC,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,OAAC;SACJ,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,0CAAgB,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,OAAC;SACF,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,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,6BAAwB;AACxB,uEAA6D;AAC7D,mEAAyD;AAEzD;;;;;GAKG;AACH,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC,0CAAgB,CAAC,CAAC,MAAM,CAAC;AACjE,MAAM,eAAe,GAAG,MAAM,CAAC,MAAM,CAAC,sCAAc,CAAC,CAAC,MAAM,CAAC;AAE7D;;;;;;;;;;GAUG;AACU,QAAA,0BAA0B,GAAG,OAAC,CAAC,MAAM,CAAC;IAC/C,MAAM,EAAE,OAAC;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,OAAC,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,OAAC;SACJ,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,0CAAgB,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,OAAC;SACF,KAAK,CAAC,OAAC,CAAC,IAAI,CAAC,sCAAc,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/v1/client-file/schemas/user-files-list-response.schema.d.ts

@@ -1,4 +1,11 @@
 import { z } from 'zod';
+/**
+ * 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 declare const UserFilesListResponseSchema: z.ZodObject<{
     items: z.ZodArray<z.ZodObject<{
         uuid: z.ZodString;

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

@@ -3,6 +3,13 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UserFilesListResponseSchema = void 0;
 const zod_1 = require("zod");
 const user_file_item_response_schema_1 = require("./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.
+ */
 exports.UserFilesListResponseSchema = zod_1.z.object({
     items: zod_1.z.array(user_file_item_response_schema_1.UserFileItemResponseSchema),
     nextCursor: zod_1.z.string().nullable(),

package/build/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,6BAAwB;AACxB,qFAA8E;AASjE,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,2DAA0B,CAAC;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,OAAC,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,6BAAwB;AACxB,qFAA8E;AAE9E;;;;;;GAMG;AACU,QAAA,2BAA2B,GAAG,OAAC,CAAC,MAAM,CAAC;IAChD,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,2DAA0B,CAAC;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,OAAO,EAAE,OAAC,CAAC,OAAO,EAAE;CACvB,CAAC,CAAC"}

package/build/v1/client-file/schemas/user-files-stats-response.schema.d.ts

@@ -1,4 +1,25 @@
 import { z } from 'zod';
+/**
+ * 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 declare const UserFilesStatsResponseSchema: z.ZodObject<{
     totalFiles: z.ZodNumber;
     totalBytes: z.ZodNumber;

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

@@ -4,6 +4,27 @@ exports.UserFilesStatsResponseSchema = void 0;
 const zod_1 = require("zod");
 const client_file_status_enum_1 = require("./client-file-status.enum");
 const client_file_type_enum_1 = require("./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.
+ */
 exports.UserFilesStatsResponseSchema = zod_1.z.object({
     totalFiles: zod_1.z.number().int().nonnegative(),
     totalBytes: zod_1.z.number().int().nonnegative(),

package/build/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,6BAAwB;AACxB,uEAA6D;AAC7D,mEAAyD;AAuB5C,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;QACf,CAAC,0CAAgB,CAAC,SAAS,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,0CAAgB,CAAC,OAAO,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,0CAAgB,CAAC,QAAQ,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,0CAAgB,CAAC,YAAY,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;QACb,CAAC,sCAAc,CAAC,KAAK,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,sCAAc,CAAC,GAAG,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;QACpB,CAAC,0CAAgB,CAAC,SAAS,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,0CAAgB,CAAC,OAAO,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,0CAAgB,CAAC,QAAQ,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,0CAAgB,CAAC,YAAY,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;QAClB,CAAC,sCAAc,CAAC,KAAK,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,sCAAc,CAAC,GAAG,CAAC,EAAE,OAAC,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,6BAAwB;AACxB,uEAA6D;AAC7D,mEAAyD;AAEzD;;;;;;;;;;;;;;;;;;;;GAoBG;AACU,QAAA,4BAA4B,GAAG,OAAC,CAAC,MAAM,CAAC;IACjD,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;IAC1C,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;IACvC,QAAQ,EAAE,OAAC,CAAC,MAAM,CAAC;QACf,CAAC,0CAAgB,CAAC,SAAS,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,0CAAgB,CAAC,OAAO,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,0CAAgB,CAAC,QAAQ,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,0CAAgB,CAAC,YAAY,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;QACb,CAAC,sCAAc,CAAC,KAAK,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,sCAAc,CAAC,GAAG,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;IACF,aAAa,EAAE,OAAC,CAAC,MAAM,CAAC;QACpB,CAAC,0CAAgB,CAAC,SAAS,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC5D,CAAC,0CAAgB,CAAC,OAAO,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC1D,CAAC,0CAAgB,CAAC,QAAQ,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QAC3D,CAAC,0CAAgB,CAAC,YAAY,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KAClE,CAAC;IACF,WAAW,EAAE,OAAC,CAAC,MAAM,CAAC;QAClB,CAAC,sCAAc,CAAC,KAAK,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;QACtD,CAAC,sCAAc,CAAC,GAAG,CAAC,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE;KACvD,CAAC;CACL,CAAC,CAAC"}

package/build/v1/client-file/upload-magic-bytes.d.ts

@@ -1,22 +1,94 @@
+/**
+ * Content sniffing for uploads: what the BYTES say a file is, as opposed to
+ * what its sender claimed.
+ *
+ * The upload path used to decide entirely on the multipart `Content-Type`
+ * header — a value the client writes itself. That made the allowlist advisory:
+ * `Content-Type: text/plain` on any bytes at all was admitted, and from there
+ * the routing table decided which pipeline received them. Sniffing turns the
+ * declared type into a claim that has to agree with the content.
+ *
+ * Deliberately narrow. It answers "which of the families we accept does this
+ * look like", plus "is this obviously an executable", and returns UNKNOWN for
+ * everything else. It is not a format validator and must not grow into one:
+ * a sniffer that tries to be clever starts accepting things on a guess, which
+ * is the failure it exists to prevent.
+ */
 export declare enum UploadMagicType {
     PNG = "PNG",
     JPEG = "JPEG",
     GIF = "GIF",
     WEBP = "WEBP",
     PDF = "PDF",
+    /** ZIP container. Every OOXML document (docx/xlsx/pptx) is one. */
     ZIP = "ZIP",
+    /** OLE2 compound file — legacy .doc/.xls/.ppt. */
     OLE2 = "OLE2",
     RTF = "RTF",
+    /** Windows PE, ELF, Mach-O, or a shebang script. Never uploadable. */
     EXECUTABLE = "EXECUTABLE",
+    /** No signature matched. Plain text has none, so this is not by itself a verdict. */
     UNKNOWN = "UNKNOWN"
 }
+/** Bytes the classifier needs. OLE2 needs 8; read at least this many. */
 export declare const UPLOAD_MAGIC_PROBE_BYTES = 16;
+/**
+ * Classify a byte prefix. Never guesses: anything unrecognised is UNKNOWN, and
+ * the caller decides what that means for the declared type.
+ */
 export declare function detectUploadMagicType(bytes: Uint8Array): UploadMagicType;
+/**
+ * Signatures a declared content type is allowed to carry.
+ *
+ * A type absent from this map is one whose bytes we cannot verify — plain text,
+ * csv, json, markdown, source code. Those legitimately have no signature, so
+ * the rule for them is inverted: any RECOGNISED signature is a contradiction
+ * (a PDF or a ZIP announced as `text/plain` is not plain text), while UNKNOWN
+ * is expected and fine.
+ */
 export declare const EXPECTED_MAGIC_BY_CONTENT_TYPE: Readonly<Record<string, readonly UploadMagicType[]>>;
+/**
+ * Let the BYTES name the type — but only inside the image family, and only
+ * between types we already accept.
+ *
+ * The case this exists for came from our own pipeline. A KIE CDN served a
+ * generated picture as `Content-Type: image/png` with a WebP body; the
+ * downloader trusted the header, so the object was stored under a `.png` name
+ * and handed to the person that way. Re-uploading it — our own artifact —
+ * failed, because the sniffer correctly saw WebP where PNG was declared. The
+ * same thing happens to any file saved from a site that serves WebP behind a
+ * `.png` URL, which browsers do constantly.
+ *
+ * Why this is not the "trust the payload" mistake the module warns about: it
+ * re-routes NOTHING. All three formats are handled by one image branch, so the
+ * pipeline is identical whichever of them wins. The only things that change are
+ * the stored extension and content type, and they change from wrong to right.
+ * An uploader gains nothing either — they could declare `image/webp` outright.
+ *
+ * Everything else keeps the old rule. A ZIP announced as `text/plain` still
+ * contradicts its declaration, and cross-family correction is exactly where
+ * honouring content over declaration WOULD hand someone a pipeline of their
+ * choosing — the converter that resolves what a document points at.
+ *
+ * Returns the content type the caller should proceed with: the detected one
+ * when both it and the declaration are accepted image types, otherwise the
+ * declaration untouched.
+ */
 export declare function reconcileImageContentType(declaredContentType: string, bytes: Uint8Array): string;
 export declare enum MagicVerdict {
+    /** Bytes match the declared type, or carry no signature where none is expected. */
     OK = "OK",
+    /** Bytes are an executable. Rejected whatever was declared. */
     EXECUTABLE = "EXECUTABLE",
+    /** Bytes contradict the declared type. */
     MISMATCH = "MISMATCH"
 }
+/**
+ * Does the content agree with what the uploader claimed it is.
+ *
+ * A mismatch is a rejection, never a correction. Re-routing a file to the
+ * pipeline its bytes suggest would mean honouring content over declaration —
+ * the same trust-the-payload mistake in a new direction, and it hands the
+ * uploader a way to pick their pipeline by crafting a header.
+ */
 export declare function verifyDeclaredContentType(declaredContentType: string, bytes: Uint8Array): MagicVerdict;

package/build/v1/client-file/upload-magic-bytes.js

@@ -4,6 +4,22 @@ exports.MagicVerdict = exports.EXPECTED_MAGIC_BY_CONTENT_TYPE = exports.UPLOAD_M
 exports.detectUploadMagicType = detectUploadMagicType;
 exports.reconcileImageContentType = reconcileImageContentType;
 exports.verifyDeclaredContentType = verifyDeclaredContentType;
+/**
+ * Content sniffing for uploads: what the BYTES say a file is, as opposed to
+ * what its sender claimed.
+ *
+ * The upload path used to decide entirely on the multipart `Content-Type`
+ * header — a value the client writes itself. That made the allowlist advisory:
+ * `Content-Type: text/plain` on any bytes at all was admitted, and from there
+ * the routing table decided which pipeline received them. Sniffing turns the
+ * declared type into a claim that has to agree with the content.
+ *
+ * Deliberately narrow. It answers "which of the families we accept does this
+ * look like", plus "is this obviously an executable", and returns UNKNOWN for
+ * everything else. It is not a format validator and must not grow into one:
+ * a sniffer that tries to be clever starts accepting things on a guess, which
+ * is the failure it exists to prevent.
+ */
 var UploadMagicType;
 (function (UploadMagicType) {
     UploadMagicType["PNG"] = "PNG";
@@ -11,12 +27,17 @@ var UploadMagicType;
     UploadMagicType["GIF"] = "GIF";
     UploadMagicType["WEBP"] = "WEBP";
     UploadMagicType["PDF"] = "PDF";
+    /** ZIP container. Every OOXML document (docx/xlsx/pptx) is one. */
     UploadMagicType["ZIP"] = "ZIP";
+    /** OLE2 compound file — legacy .doc/.xls/.ppt. */
     UploadMagicType["OLE2"] = "OLE2";
     UploadMagicType["RTF"] = "RTF";
+    /** Windows PE, ELF, Mach-O, or a shebang script. Never uploadable. */
     UploadMagicType["EXECUTABLE"] = "EXECUTABLE";
+    /** No signature matched. Plain text has none, so this is not by itself a verdict. */
     UploadMagicType["UNKNOWN"] = "UNKNOWN";
 })(UploadMagicType || (exports.UploadMagicType = UploadMagicType = {}));
+/** Bytes the classifier needs. OLE2 needs 8; read at least this many. */
 exports.UPLOAD_MAGIC_PROBE_BYTES = 16;
 function startsWith(bytes, signature) {
     if (bytes.length < signature.length) {
@@ -33,14 +54,25 @@ const SIGNATURES = [
     { type: UploadMagicType.ZIP, bytes: [0x50, 0x4b, 0x05, 0x06] },
     { type: UploadMagicType.OLE2, bytes: [0xd0, 0xcf, 0x11, 0xe0, 0xa1, 0xb1, 0x1a, 0xe1] },
     { type: UploadMagicType.RTF, bytes: [0x7b, 0x5c, 0x72, 0x74, 0x66] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0x4d, 0x5a] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0x7f, 0x45, 0x4c, 0x46] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0xcf, 0xfa, 0xed, 0xfe] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0xfe, 0xed, 0xfa, 0xcf] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0xce, 0xfa, 0xed, 0xfe] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0xca, 0xfe, 0xba, 0xbe] },
-    { type: UploadMagicType.EXECUTABLE, bytes: [0x00, 0x61, 0x73, 0x6d] },
+    // Compiled executables, checked like any other signature and rejected by
+    // the caller. The point is not that we would run them — we never do — but
+    // that converted uploads land in a public-read bucket, and a service that
+    // stores a stranger's PE under a link they choose is malware hosting.
+    //
+    // A shebang is deliberately NOT here. `#!` is two ASCII characters at the
+    // start of a shell or Python script, and shell and Python scripts are on
+    // the accepted list by name — rejecting them made the whitelist promise
+    // something the sniffer took back, while stopping nothing: the same script
+    // uploads fine with the line removed.
+    { type: UploadMagicType.EXECUTABLE, bytes: [0x4d, 0x5a] }, // MZ — PE
+    { type: UploadMagicType.EXECUTABLE, bytes: [0x7f, 0x45, 0x4c, 0x46] }, // ELF
+    { type: UploadMagicType.EXECUTABLE, bytes: [0xcf, 0xfa, 0xed, 0xfe] }, // Mach-O 64
+    { type: UploadMagicType.EXECUTABLE, bytes: [0xfe, 0xed, 0xfa, 0xcf] }, // Mach-O big-endian
+    { type: UploadMagicType.EXECUTABLE, bytes: [0xce, 0xfa, 0xed, 0xfe] }, // Mach-O 32
+    { type: UploadMagicType.EXECUTABLE, bytes: [0xca, 0xfe, 0xba, 0xbe] }, // fat binary / class
+    { type: UploadMagicType.EXECUTABLE, bytes: [0x00, 0x61, 0x73, 0x6d] }, // wasm
 ];
+/** RIFF….WEBP — the tag sits at offset 8, so it needs its own check. */
 function isWebp(bytes) {
     return (bytes.length >= 12 &&
         startsWith(bytes, [0x52, 0x49, 0x46, 0x46]) &&
@@ -49,6 +81,10 @@ function isWebp(bytes) {
         bytes[10] === 0x42 &&
         bytes[11] === 0x50);
 }
+/**
+ * Classify a byte prefix. Never guesses: anything unrecognised is UNKNOWN, and
+ * the caller decides what that means for the declared type.
+ */
 function detectUploadMagicType(bytes) {
     if (isWebp(bytes)) {
         return UploadMagicType.WEBP;
@@ -60,27 +96,75 @@ function detectUploadMagicType(bytes) {
     }
     return UploadMagicType.UNKNOWN;
 }
+/**
+ * Signatures a declared content type is allowed to carry.
+ *
+ * A type absent from this map is one whose bytes we cannot verify — plain text,
+ * csv, json, markdown, source code. Those legitimately have no signature, so
+ * the rule for them is inverted: any RECOGNISED signature is a contradiction
+ * (a PDF or a ZIP announced as `text/plain` is not plain text), while UNKNOWN
+ * is expected and fine.
+ */
 exports.EXPECTED_MAGIC_BY_CONTENT_TYPE = {
     'image/png': [UploadMagicType.PNG],
     'image/jpeg': [UploadMagicType.JPEG],
     'image/webp': [UploadMagicType.WEBP],
     'application/pdf': [UploadMagicType.PDF],
     'application/msword': [UploadMagicType.OLE2],
+    'application/rtf': [UploadMagicType.RTF],
+    'text/rtf': [UploadMagicType.RTF],
     'application/vnd.ms-excel': [UploadMagicType.OLE2],
     'application/vnd.ms-powerpoint': [UploadMagicType.OLE2],
     'application/vnd.openxmlformats-officedocument.wordprocessingml.document': [
         UploadMagicType.ZIP,
     ],
     'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet': [UploadMagicType.ZIP],
+    'application/vnd.oasis.opendocument.text': [UploadMagicType.ZIP],
+    'application/vnd.oasis.opendocument.presentation': [UploadMagicType.ZIP],
+    'application/vnd.oasis.opendocument.spreadsheet': [UploadMagicType.ZIP],
     'application/vnd.openxmlformats-officedocument.presentationml.presentation': [
         UploadMagicType.ZIP,
     ],
 };
+/**
+ * What each image signature actually IS, as a content type.
+ *
+ * Only the three formats the upload allowlist admits. A signature we detect
+ * but do not accept (GIF) is deliberately absent: recognising it is how we
+ * reject it, not a step towards letting it in.
+ */
 const CONTENT_TYPE_BY_IMAGE_MAGIC = {
     [UploadMagicType.PNG]: 'image/png',
     [UploadMagicType.JPEG]: 'image/jpeg',
     [UploadMagicType.WEBP]: 'image/webp',
 };
+/**
+ * Let the BYTES name the type — but only inside the image family, and only
+ * between types we already accept.
+ *
+ * The case this exists for came from our own pipeline. A KIE CDN served a
+ * generated picture as `Content-Type: image/png` with a WebP body; the
+ * downloader trusted the header, so the object was stored under a `.png` name
+ * and handed to the person that way. Re-uploading it — our own artifact —
+ * failed, because the sniffer correctly saw WebP where PNG was declared. The
+ * same thing happens to any file saved from a site that serves WebP behind a
+ * `.png` URL, which browsers do constantly.
+ *
+ * Why this is not the "trust the payload" mistake the module warns about: it
+ * re-routes NOTHING. All three formats are handled by one image branch, so the
+ * pipeline is identical whichever of them wins. The only things that change are
+ * the stored extension and content type, and they change from wrong to right.
+ * An uploader gains nothing either — they could declare `image/webp` outright.
+ *
+ * Everything else keeps the old rule. A ZIP announced as `text/plain` still
+ * contradicts its declaration, and cross-family correction is exactly where
+ * honouring content over declaration WOULD hand someone a pipeline of their
+ * choosing — the converter that resolves what a document points at.
+ *
+ * Returns the content type the caller should proceed with: the detected one
+ * when both it and the declaration are accepted image types, otherwise the
+ * declaration untouched.
+ */
 function reconcileImageContentType(declaredContentType, bytes) {
     const declared = declaredContentType.toLowerCase();
     const accepted = Object.values(CONTENT_TYPE_BY_IMAGE_MAGIC);
@@ -92,20 +176,37 @@ function reconcileImageContentType(declaredContentType, bytes) {
 }
 var MagicVerdict;
 (function (MagicVerdict) {
+    /** Bytes match the declared type, or carry no signature where none is expected. */
     MagicVerdict["OK"] = "OK";
+    /** Bytes are an executable. Rejected whatever was declared. */
     MagicVerdict["EXECUTABLE"] = "EXECUTABLE";
+    /** Bytes contradict the declared type. */
     MagicVerdict["MISMATCH"] = "MISMATCH";
 })(MagicVerdict || (exports.MagicVerdict = MagicVerdict = {}));
+/**
+ * Does the content agree with what the uploader claimed it is.
+ *
+ * A mismatch is a rejection, never a correction. Re-routing a file to the
+ * pipeline its bytes suggest would mean honouring content over declaration —
+ * the same trust-the-payload mistake in a new direction, and it hands the
+ * uploader a way to pick their pipeline by crafting a header.
+ */
 function verifyDeclaredContentType(declaredContentType, bytes) {
     const detected = detectUploadMagicType(bytes);
     if (detected === UploadMagicType.EXECUTABLE) {
         return MagicVerdict.EXECUTABLE;
     }
+    // `Object.hasOwn` rather than a bare lookup: the declared type is a string
+    // off the wire, and `__proto__` or `constructor` would otherwise resolve to
+    // something inherited instead of `undefined` — turning the signature-less
+    // branch below into a crash.
     const key = declaredContentType.toLowerCase();
     const expected = Object.hasOwn(exports.EXPECTED_MAGIC_BY_CONTENT_TYPE, key)
         ? exports.EXPECTED_MAGIC_BY_CONTENT_TYPE[key]
         : undefined;
     if (expected === undefined) {
+        // Signature-less family (text, csv, json, code). Unsigned is the norm;
+        // a recognised signature means the declaration is false.
         return detected === UploadMagicType.UNKNOWN ? MagicVerdict.OK : MagicVerdict.MISMATCH;
     }
     return expected.includes(detected) ? MagicVerdict.OK : MagicVerdict.MISMATCH;

package/build/v1/client-file/upload-magic-bytes.js.map

@@ -1 +1 @@
-{"version":3,"file":"upload-magic-bytes.js","sourceRoot":"","sources":["../../../v1/client-file/upload-magic-bytes.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"upload-magic-bytes.js","sourceRoot":"","sources":["../../../v1/client-file/upload-magic-bytes.ts"],"names":[],"mappings":";;;AAuFA,sDAYC;AA0ED,8DAWC;AAmBD,8DA0BC;AArOD;;;;;;;;;;;;;;;GAeG;AACH,IAAY,eAeX;AAfD,WAAY,eAAe;IACvB,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,8BAAW,CAAA;IACX,gCAAa,CAAA;IACb,8BAAW,CAAA;IACX,mEAAmE;IACnE,8BAAW,CAAA;IACX,kDAAkD;IAClD,gCAAa,CAAA;IACb,8BAAW,CAAA;IACX,sEAAsE;IACtE,4CAAyB,CAAA;IACzB,qFAAqF;IACrF,sCAAmB,CAAA;AACvB,CAAC,EAfW,eAAe,+BAAf,eAAe,QAe1B;AAED,yEAAyE;AAC5D,QAAA,wBAAwB,GAAG,EAAE,CAAC;AAE3C,SAAS,UAAU,CAAC,KAAiB,EAAE,SAA4B;IAC/D,IAAI,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QAClC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,IAAI,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,GAAuE;IACnF,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IACtF,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IACzD,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAC9D,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IACpE,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAC9D,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IAC9D,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IACvF,EAAE,IAAI,EAAE,eAAe,CAAC,GAAG,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE;IACpE,yEAAyE;IACzE,0EAA0E;IAC1E,0EAA0E;IAC1E,sEAAsE;IACtE,EAAE;IACF,0EAA0E;IAC1E,yEAAyE;IACzE,wEAAwE;IACxE,2EAA2E;IAC3E,sCAAsC;IACtC,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,UAAU;IACrE,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,MAAM;IAC7E,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,YAAY;IACnF,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,oBAAoB;IAC3F,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,YAAY;IACnF,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,qBAAqB;IAC5F,EAAE,IAAI,EAAE,eAAe,CAAC,UAAU,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,OAAO;CACjF,CAAC;AAEF,wEAAwE;AACxE,SAAS,MAAM,CAAC,KAAiB;IAC7B,OAAO,CACH,KAAK,CAAC,MAAM,IAAI,EAAE;QAClB,UAAU,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;QAC3C,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACjB,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI;QAClB,KAAK,CAAC,EAAE,CAAC,KAAK,IAAI,CACrB,CAAC;AACN,CAAC;AAED;;;GAGG;AACH,SAAgB,qBAAqB,CAAC,KAAiB;IACnD,IAAI,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC;QAChB,OAAO,eAAe,CAAC,IAAI,CAAC;IAChC,CAAC;IAED,KAAK,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,UAAU,EAAE,CAAC;QAClD,IAAI,UAAU,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IAED,OAAO,eAAe,CAAC,OAAO,CAAC;AACnC,CAAC;AAED;;;;;;;;GAQG;AACU,QAAA,8BAA8B,GACvC;IACI,WAAW,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IAClC,YAAY,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;IACpC,YAAY,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;IACpC,iBAAiB,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IACxC,oBAAoB,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;IAC5C,iBAAiB,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IACxC,UAAU,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IACjC,0BAA0B,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;IAClD,+BAA+B,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC;IACvD,yEAAyE,EAAE;QACvE,eAAe,CAAC,GAAG;KACtB;IACD,mEAAmE,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IAC1F,yCAAyC,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IAChE,iDAAiD,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IACxE,gDAAgD,EAAE,CAAC,eAAe,CAAC,GAAG,CAAC;IACvE,2EAA2E,EAAE;QACzE,eAAe,CAAC,GAAG;KACtB;CACJ,CAAC;AAEN;;;;;;GAMG;AACH,MAAM,2BAA2B,GAAuD;IACpF,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,WAAW;IAClC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY;IACpC,CAAC,eAAe,CAAC,IAAI,CAAC,EAAE,YAAY;CACvC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,SAAgB,yBAAyB,CAAC,mBAA2B,EAAE,KAAiB;IACpF,MAAM,QAAQ,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,2BAA2B,CAAC,CAAC;IAE5D,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC/B,OAAO,mBAAmB,CAAC;IAC/B,CAAC;IAED,MAAM,QAAQ,GAAG,2BAA2B,CAAC,qBAAqB,CAAC,KAAK,CAAC,CAAC,CAAC;IAE3E,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,QAAQ,CAAC;AACnE,CAAC;AAED,IAAY,YAOX;AAPD,WAAY,YAAY;IACpB,mFAAmF;IACnF,yBAAS,CAAA;IACT,+DAA+D;IAC/D,yCAAyB,CAAA;IACzB,0CAA0C;IAC1C,qCAAqB,CAAA;AACzB,CAAC,EAPW,YAAY,4BAAZ,YAAY,QAOvB;AAED;;;;;;;GAOG;AACH,SAAgB,yBAAyB,CACrC,mBAA2B,EAC3B,KAAiB;IAEjB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,QAAQ,KAAK,eAAe,CAAC,UAAU,EAAE,CAAC;QAC1C,OAAO,YAAY,CAAC,UAAU,CAAC;IACnC,CAAC;IAED,2EAA2E;IAC3E,4EAA4E;IAC5E,0EAA0E;IAC1E,6BAA6B;IAC7B,MAAM,GAAG,GAAG,mBAAmB,CAAC,WAAW,EAAE,CAAC;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,sCAA8B,EAAE,GAAG,CAAC;QAC/D,CAAC,CAAC,sCAA8B,CAAC,GAAG,CAAC;QACrC,CAAC,CAAC,SAAS,CAAC;IAEhB,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QACzB,uEAAuE;QACvE,yDAAyD;QACzD,OAAO,QAAQ,KAAK,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;IAC1F,CAAC;IAED,OAAO,QAAQ,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,EAAE,CAAC,CAAC,CAAC,YAAY,CAAC,QAAQ,CAAC;AACjF,CAAC"}

package/build/v1/connector/connector-runtime.constants.d.ts

@@ -1 +1,10 @@
+/**
+ * Stable handler key under which the unified connector gateway tool handler is
+ * registered. Connector tool resolution stamps this onto every
+ * ResolvedRuntimeTool it produces — both local first-party connectors (served
+ * in-process) and external custom-MCP connections — so a single handler routes
+ * every connector tool through the ToolsetProvider port. It lives in contracts
+ * so both the connector module (producer) and the tool module (consumer /
+ * executor registry) import a single source of truth.
+ */
 export declare const CONNECTOR_GATEWAY_HANDLER_KEY = "CONNECTOR_GATEWAY";

package/build/v1/connector/connector-runtime.constants.js

@@ -1,5 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CONNECTOR_GATEWAY_HANDLER_KEY = void 0;
+/**
+ * Stable handler key under which the unified connector gateway tool handler is
+ * registered. Connector tool resolution stamps this onto every
+ * ResolvedRuntimeTool it produces — both local first-party connectors (served
+ * in-process) and external custom-MCP connections — so a single handler routes
+ * every connector tool through the ToolsetProvider port. It lives in contracts
+ * so both the connector module (producer) and the tool module (consumer /
+ * executor registry) import a single source of truth.
+ */
 exports.CONNECTOR_GATEWAY_HANDLER_KEY = 'CONNECTOR_GATEWAY';
 //# sourceMappingURL=connector-runtime.constants.js.map

package/build/v1/connector/connector-runtime.constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-runtime.constants.js","sourceRoot":"","sources":["../../../v1/connector/connector-runtime.constants.ts"],"names":[],"mappings":";;;AASa,QAAA,6BAA6B,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"connector-runtime.constants.js","sourceRoot":"","sources":["../../../v1/connector/connector-runtime.constants.ts"],"names":[],"mappings":";;;AAAA;;;;;;;;GAQG;AACU,QAAA,6BAA6B,GAAG,mBAAmB,CAAC"}

package/build/v1/connector/connector.errors.d.ts

@@ -20,9 +20,17 @@ export declare enum ConnectorErrorCode {
     MCP_SERVER_UNREACHABLE = "MCP_SERVER_UNREACHABLE",
     MCP_TOOL_UNAVAILABLE = "MCP_TOOL_UNAVAILABLE",
     CONNECTOR_LIMIT_EXCEEDED = "CONNECTOR_LIMIT_EXCEEDED",
+    /** Upstream connector provider (e.g. Yandex Disk API) returned a non-auth error. */
     CONNECTOR_UPSTREAM_ERROR = "CONNECTOR_UPSTREAM_ERROR",
+    /** A referenced connector resource (file/folder/path) does not exist. */
     CONNECTOR_RESOURCE_NOT_FOUND = "CONNECTOR_RESOURCE_NOT_FOUND",
+    /** Requested connector write payload exceeds the allowed size cap. */
     CONNECTOR_CONTENT_TOO_LARGE = "CONNECTOR_CONTENT_TOO_LARGE",
+    /**
+     * The internal-MCP mount reported that the vendor's stored token is dead and
+     * the user must re-authorize the vendor (surfaced so the UI can prompt a
+     * reconnect). Distinct from CONNECTION_NOT_ACTIVE (our own OAuth leg).
+     */
     VENDOR_REAUTH_REQUIRED = "VENDOR_REAUTH_REQUIRED"
 }
 export declare const CONNECTOR_ERRORS: Record<ConnectorErrorCode, ErrorMetadata>;

package/build/v1/connector/connector.errors.js

@@ -23,9 +23,17 @@ var ConnectorErrorCode;
     ConnectorErrorCode["MCP_SERVER_UNREACHABLE"] = "MCP_SERVER_UNREACHABLE";
     ConnectorErrorCode["MCP_TOOL_UNAVAILABLE"] = "MCP_TOOL_UNAVAILABLE";
     ConnectorErrorCode["CONNECTOR_LIMIT_EXCEEDED"] = "CONNECTOR_LIMIT_EXCEEDED";
+    /** Upstream connector provider (e.g. Yandex Disk API) returned a non-auth error. */
     ConnectorErrorCode["CONNECTOR_UPSTREAM_ERROR"] = "CONNECTOR_UPSTREAM_ERROR";
+    /** A referenced connector resource (file/folder/path) does not exist. */
     ConnectorErrorCode["CONNECTOR_RESOURCE_NOT_FOUND"] = "CONNECTOR_RESOURCE_NOT_FOUND";
+    /** Requested connector write payload exceeds the allowed size cap. */
     ConnectorErrorCode["CONNECTOR_CONTENT_TOO_LARGE"] = "CONNECTOR_CONTENT_TOO_LARGE";
+    /**
+     * The internal-MCP mount reported that the vendor's stored token is dead and
+     * the user must re-authorize the vendor (surfaced so the UI can prompt a
+     * reconnect). Distinct from CONNECTION_NOT_ACTIVE (our own OAuth leg).
+     */
     ConnectorErrorCode["VENDOR_REAUTH_REQUIRED"] = "VENDOR_REAUTH_REQUIRED";
 })(ConnectorErrorCode || (exports.ConnectorErrorCode = ConnectorErrorCode = {}));
 exports.CONNECTOR_ERRORS = {

package/build/v1/connector/connector.errors.js.map

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