@veruna/api-contracts 19.1.0 → 20.1.0

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

@@ -1,3 +1,19 @@
+/**
+ * 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 var UploadMagicType;
 (function (UploadMagicType) {
     UploadMagicType["PNG"] = "PNG";
@@ -5,12 +21,17 @@ export 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 || (UploadMagicType = {}));
+/** Bytes the classifier needs. OLE2 needs 8; read at least this many. */
 export const UPLOAD_MAGIC_PROBE_BYTES = 16;
 function startsWith(bytes, signature) {
     if (bytes.length < signature.length) {
@@ -27,14 +48,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]) &&
@@ -43,6 +75,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.
+ */
 export function detectUploadMagicType(bytes) {
     if (isWebp(bytes)) {
         return UploadMagicType.WEBP;
@@ -54,27 +90,75 @@ export 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.
+ */
 export const 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.
+ */
 export function reconcileImageContentType(declaredContentType, bytes) {
     const declared = declaredContentType.toLowerCase();
     const accepted = Object.values(CONTENT_TYPE_BY_IMAGE_MAGIC);
@@ -86,20 +170,37 @@ export function reconcileImageContentType(declaredContentType, bytes) {
 }
 export 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 || (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.
+ */
 export 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(EXPECTED_MAGIC_BY_CONTENT_TYPE, key)
         ? 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-esm/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":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAN,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,KAAf,eAAe,QAe1B;AAED,yEAAyE;AACzE,MAAM,CAAC,MAAM,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,MAAM,UAAU,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;AACH,MAAM,CAAC,MAAM,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,MAAM,UAAU,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,MAAM,CAAN,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,KAAZ,YAAY,QAOvB;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,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,8BAA8B,EAAE,GAAG,CAAC;QAC/D,CAAC,CAAC,8BAA8B,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-esm/v1/connector/connector-runtime.constants.js

@@ -1,2 +1,11 @@
+/**
+ * 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 const CONNECTOR_GATEWAY_HANDLER_KEY = 'CONNECTOR_GATEWAY';
 //# sourceMappingURL=connector-runtime.constants.js.map

package/build-esm/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,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAAmB,CAAC"}
+{"version":3,"file":"connector-runtime.constants.js","sourceRoot":"","sources":["../../../v1/connector/connector-runtime.constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,mBAAmB,CAAC"}

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

@@ -20,9 +20,17 @@ export 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 || (ConnectorErrorCode = {}));
 export const CONNECTOR_ERRORS = {

package/build-esm/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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"}

package/build-esm/v1/connector/schemas/connection.schema.js

@@ -6,12 +6,22 @@ import { ConnectorToolSnapshotItemSchema } from './tool-snapshot.schema';
 export const UserConnectionTypeSchema = z.enum(UserConnectionType);
 export const UserConnectionStatusSchema = z.enum(UserConnectionStatus);
 const MCP_HEADER_NAME_REGEX = /^[A-Za-z0-9-]+$/;
+/**
+ * Max tools a connection may advertise — mirrors the runtime snapshot cap
+ * (TOOLS_SNAPSHOT_MAX_TOOLS / MCP_TOOLS_MAX = 32). The wire contract must not
+ * promise a bound the runtime rejects, so both stay 32.
+ */
 const CONNECTOR_MAX_TOOLS = 32;
+/**
+ * Safe view of a user connection. NEVER contains credentials, tokens or the
+ * full MCP URL — `mcpUrl` is host-only (e.g. "mcp.example.com") for display.
+ */
 export const UserConnectionSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     type: UserConnectionTypeSchema,
     providerKey: z.string().max(120).nullable(),
     providerTitle: z.string().max(255).nullable(),
+    /** Provider logo; null for custom MCP connections, which have no provider. */
     providerIcon: z.string().max(2048).nullable(),
     title: z.string().max(128).nullable(),
     mcpUrl: z.string().max(255).nullable(),
@@ -27,6 +37,9 @@ export const UserConnectionListSchema = z.object({
 export const DeleteConnectionResponseSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
 });
+/**
+ * Result of a live health check against the connection's backing service.
+ */
 export const CheckConnectionResponseSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     status: UserConnectionStatusSchema,
@@ -50,9 +63,18 @@ export const CreateCustomMcpRequestSchema = z.object({
         .regex(MCP_HEADER_NAME_REGEX, { message: 'CreateCustomMcpRequest.headerName.invalid' })
         .optional(),
 });
+/**
+ * Create-custom-MCP response. Extends the safe connection view with the
+ * (neutralized) tools the server advertised at connect time — names + FULL
+ * descriptions — so the client can show the user exactly what each tool claims
+ * to do before they rely on it (informed-consent / line-jumping defense).
+ */
 export const CreateCustomMcpResponseSchema = UserConnectionSchema.extend({
     tools: z.array(ConnectorToolSnapshotItemSchema).max(CONNECTOR_MAX_TOOLS),
 });
+// NOTE: the endpoint `url` is intentionally NOT patchable here. Changing it
+// invalidates the pinned tools snapshot and its dedup url-hash, so switching
+// endpoints must be a delete + recreate, never an in-place PATCH.
 export const UpdateCustomMcpRequestSchema = z.object({
     title: z
         .string({ error: 'UpdateCustomMcpRequest.title.required' })
@@ -66,6 +88,11 @@ export const UpdateCustomMcpRequestSchema = z.object({
         .regex(MCP_HEADER_NAME_REGEX, { message: 'UpdateCustomMcpRequest.headerName.invalid' })
         .optional(),
 });
+/**
+ * Re-sync a custom MCP tool snapshot. `confirmSnapshotHash` acknowledges a
+ * previously observed snapshot; the server rejects a resync as stale if the
+ * live snapshot diverged from an unacknowledged hash.
+ */
 export const ResyncCustomMcpRequestSchema = z.object({
     confirmSnapshotHash: z
         .string()

package/build-esm/v1/connector/schemas/connection.schema.js.map

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

package/build-esm/v1/connector/schemas/connector-access.schema.js

@@ -1,5 +1,9 @@
 import { z } from 'zod';
 import { DATETIME_REGEX, UUID_REGEX } from '../../../shared';
+/**
+ * A single allowlist grant: which user is permitted to use an ALLOWLIST-mode
+ * provider.
+ */
 export const ConnectorAccessGrantSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     userUuid: z.string().regex(UUID_REGEX),

package/build-esm/v1/connector/schemas/connector-access.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-access.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/connector-access.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAM7D,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;CAC9C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;CAC9C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,QAAQ,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,IAAI,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;CACzE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;CACzC,CAAC,CAAC"}
+{"version":3,"file":"connector-access.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/connector-access.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAE7D;;;GAGG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;CAC9C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,0BAA0B,CAAC;CAC9C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAC,CAAC,MAAM,CAAC;IACtD,QAAQ,EAAE,CAAC;SACN,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,IAAI,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;CACzE,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;CACzC,CAAC,CAAC"}

package/build-esm/v1/connector/schemas/connector-provider.schema.js

@@ -14,16 +14,41 @@ export const ConnectorVisibilitySchema = z.enum(ConnectorVisibility);
 export const ConnectorSensitivitySchema = z.enum(ConnectorSensitivity);
 export const ConnectorProviderStatusSchema = z.enum(ConnectorProviderStatus);
 const PROVIDER_KEY_REGEX = /^[a-z][a-z0-9_-]*$/;
+/**
+ * Provider logo. An absolute https URL, mirroring the `icon` convention already
+ * used by AI providers, models and tools. Deliberately NOT a free-form URL: the
+ * value is rendered by every user's browser, so a third-party host would turn an
+ * admin field into a tracking beacon that leaks referrers and IPs. Constrained to
+ * our own asset CDN; the FE renders a placeholder when null.
+ */
 const ICON_URL_REGEX = /^https:\/\/acdn\.veruna\.io\/[A-Za-z0-9._~\-/]+$/;
+/**
+ * Request-side icon validation. A factory rather than a shared constant so each
+ * request schema owns its own i18n keys (`SchemaName.field.rule`), which is what
+ * the locale lookup expects.
+ */
 const iconUrlSchema = (schemaName) => z
     .string()
     .max(2048, { message: `${schemaName}.icon.max` })
     .regex(ICON_URL_REGEX, { message: `${schemaName}.icon.invalid` });
+/** Response-side: plain string, matching how tool/ai-provider icons are typed. */
 const IconUrlResponseSchema = z.string().max(2048);
+/**
+ * Compact status of the caller's own connection to a provider, surfaced inside
+ * the public catalog so the FE can render "Connected / Connect" without a
+ * second round-trip. Never leaks credentials — status + connection uuid only.
+ */
 export const MyConnectionSummarySchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     status: z.enum(UserConnectionStatus),
 });
+/**
+ * Provider config, discriminated by `mode`:
+ *  - internal: MCP server hosted by the internal-MCP gateway; optional `path`
+ *              override (defaults to `/mcp/<key>`).
+ *  - external: absolute https URL of a third-party remote MCP server.
+ * Secrets (client id/secret, tokens) are never part of the API contract.
+ */
 export const ConnectorInternalConfigSchema = z.object({
     mode: z.literal('internal'),
     path: z.string().max(2048).optional(),
@@ -36,6 +61,9 @@ export const ConnectorProviderConfigSchema = z.discriminatedUnion('mode', [
     ConnectorInternalConfigSchema,
     ConnectorExternalConfigSchema,
 ]);
+/**
+ * Public catalog view of a provider — safe fields only.
+ */
 export const ConnectorProviderPublicSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     key: z.string().max(120).regex(PROVIDER_KEY_REGEX),
@@ -50,6 +78,9 @@ export const ConnectorProviderPublicSchema = z.object({
 export const ConnectorCatalogResponseSchema = z.object({
     providers: z.array(ConnectorProviderPublicSchema),
 });
+/**
+ * Admin full view of a provider.
+ */
 export const ConnectorProviderAdminSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
     key: z.string().max(120).regex(PROVIDER_KEY_REGEX),
@@ -142,6 +173,9 @@ export const UpdateConnectorProviderRequestSchema = z.object({
 export const DeleteConnectorProviderResponseSchema = z.object({
     uuid: z.string().regex(UUID_REGEX),
 });
+/**
+ * OAuth authorize kick-off response: the URL the FE should redirect the user to.
+ */
 export const AuthorizeConnectorResponseSchema = z.object({
     authorizeUrl: z.string().url().max(2048),
 });

package/build-esm/v1/connector/schemas/connector-provider.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-provider.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/connector-provider.schema.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"connector-provider.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/connector-provider.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AAErE,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;AAC7D,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;AACjE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;AAE7E,MAAM,kBAAkB,GAAG,oBAAoB,CAAC;AAEhD;;;;;;GAMG;AACH,MAAM,cAAc,GAAG,kDAAkD,CAAC;AAE1E;;;;GAIG;AACH,MAAM,aAAa,GAAG,CAAC,UAAkB,EAAE,EAAE,CACzC,CAAC;KACI,MAAM,EAAE;KACR,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,GAAG,UAAU,WAAW,EAAE,CAAC;KAChD,KAAK,CAAC,cAAc,EAAE,EAAE,OAAO,EAAE,GAAG,UAAU,eAAe,EAAE,CAAC,CAAC;AAE1E,kFAAkF;AAClF,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAEnD;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC9C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,oBAAoB,CAAC;CACvC,CAAC,CAAC;AAIH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;CAClC,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IACtE,6BAA6B;IAC7B,6BAA6B;CAChC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC,CAAC,MAAM,CAAC;IAClD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,uBAAuB;IACjC,WAAW,EAAE,0BAA0B;IACvC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,YAAY,EAAE,yBAAyB,CAAC,QAAQ,EAAE;CACrD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,8BAA8B,GAAG,CAAC,CAAC,MAAM,CAAC;IACnD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC;CACpD,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,MAAM,CAAC;IACjD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;IAClC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IAC1B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;IACjC,IAAI,EAAE,qBAAqB,CAAC,QAAQ,EAAE;IACtC,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,yBAAyB;IACrC,UAAU,EAAE,yBAAyB;IACrC,WAAW,EAAE,0BAA0B;IACvC,MAAM,EAAE,6BAA6B;IACrC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;IACvB,MAAM,EAAE,6BAA6B;IACrC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,cAAc,CAAC;CAC9C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,4BAA4B,CAAC;CACnD,CAAC,CAAC;AAIH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,IAAI,EAAE,CAAC;SACF,MAAM,EAAE;SACR,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,kCAAkC,EAAE,CAAC;SAC1D,QAAQ,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IACvC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;IAC3B,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,sCAAsC,EAAE,CAAC;SACzD,GAAG,CAAC,EAAE,OAAO,EAAE,qCAAqC,EAAE,CAAC;SACvD,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,iCAAiC,EAAE,CAAC;CACjE,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC3E,yBAAyB;IACzB,yBAAyB;CAC5B,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,GAAG,EAAE,CAAC;SACD,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;SAC7D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;SAC/D,KAAK,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,4CAA4C,EAAE,CAAC;IACzF,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC/D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;IACtE,WAAW,EAAE,CAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;SACxE,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;IAC7E,IAAI,EAAE,aAAa,CAAC,gCAAgC,CAAC,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC;IAC9E,MAAM,EAAE,qBAAqB;IAC7B,QAAQ,EAAE,uBAAuB;IACjC,UAAU,EAAE,yBAAyB;IACrC,UAAU,EAAE,yBAAyB;IACrC,WAAW,EAAE,0BAA0B;IACvC,MAAM,EAAE,6BAA6B,CAAC,OAAO,CAAC,uBAAuB,CAAC,MAAM,CAAC;IAC7E,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,GAAG,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;SAChE,WAAW,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;SACxE,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACpE,OAAO,CAAC,CAAC,CAAC;IACf,MAAM,EAAE,kCAAkC;CAC7C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,oCAAoC,GAAG,CAAC,CAAC,MAAM,CAAC;IACzD,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SAC/D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACjE,QAAQ,EAAE;IACf,WAAW,EAAE,CAAC;SACT,MAAM,CAAC,EAAE,KAAK,EAAE,qDAAqD,EAAE,CAAC;SACxE,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,gDAAgD,EAAE,CAAC;SACxE,QAAQ,EAAE;IACf,IAAI,EAAE,aAAa,CAAC,gCAAgC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3E,UAAU,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAChD,UAAU,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAChD,WAAW,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IAClD,MAAM,EAAE,6BAA6B,CAAC,QAAQ,EAAE;IAChD,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,+CAA+C,EAAE,CAAC;SAClE,GAAG,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;SAChE,WAAW,CAAC,EAAE,OAAO,EAAE,8CAA8C,EAAE,CAAC;SACxE,GAAG,CAAC,MAAM,EAAE,EAAE,OAAO,EAAE,0CAA0C,EAAE,CAAC;SACpE,QAAQ,EAAE;IACf,MAAM,EAAE,kCAAkC,CAAC,QAAQ,EAAE;CACxD,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,qCAAqC,GAAG,CAAC,CAAC,MAAM,CAAC;IAC1D,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC;CACrC,CAAC,CAAC;AAIH;;GAEG;AACH,MAAM,CAAC,MAAM,gCAAgC,GAAG,CAAC,CAAC,MAAM,CAAC;IACrD,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC;CAC3C,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,mCAAmC,GAAG,CAAC,CAAC,MAAM,CAAC;IACxD,IAAI,EAAE,CAAC;SACF,MAAM,CAAC,EAAE,KAAK,EAAE,6CAA6C,EAAE,CAAC;SAChE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;SAC7D,GAAG,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,wCAAwC,EAAE,CAAC;IACrE,KAAK,EAAE,CAAC;SACH,MAAM,CAAC,EAAE,KAAK,EAAE,8CAA8C,EAAE,CAAC;SACjE,GAAG,CAAC,CAAC,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;SAC9D,GAAG,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,yCAAyC,EAAE,CAAC;CACxE,CAAC,CAAC"}

package/build-esm/v1/connector/schemas/connector-selection.schema.js

@@ -1,4 +1,8 @@
 import { z } from 'zod';
+/**
+ * Connector selection from the client for a message: which active connection to
+ * enable, optionally narrowed to specific tool names exposed by that connection.
+ */
 export const ConnectorSelectionSchema = z.object({
     connectionUuid: z
         .string({ error: 'ConnectorSelection.connectionUuid.required' })

package/build-esm/v1/connector/schemas/connector-selection.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"connector-selection.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/connector-selection.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,cAAc,EAAE,CAAC;SACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,IAAI,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACnE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KACzC,KAAK,CAAC,wBAAwB,CAAC;KAC/B,GAAG,CAAC,EAAE,CAAC;KACP,WAAW,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,QAAQ,CAAC;gBACb,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC;gBAC/B,OAAO,EAAE,kDAAkD;aAC9D,CAAC,CAAC;YACH,SAAS;QACb,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"connector-selection.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/connector-selection.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;GAGG;AACH,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC7C,cAAc,EAAE,CAAC;SACZ,MAAM,CAAC,EAAE,KAAK,EAAE,4CAA4C,EAAE,CAAC;SAC/D,IAAI,CAAC,EAAE,OAAO,EAAE,2CAA2C,EAAE,CAAC;IACnE,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC7D,CAAC,CAAC;AAIH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAC;KACzC,KAAK,CAAC,wBAAwB,CAAC;KAC/B,GAAG,CAAC,EAAE,CAAC;KACP,WAAW,CAAC,CAAC,UAAU,EAAE,OAAO,EAAE,EAAE;IACjC,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IAEvC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE,CAAC;QACrD,MAAM,SAAS,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC;YACrC,OAAO,CAAC,QAAQ,CAAC;gBACb,IAAI,EAAE,CAAC,CAAC,YAAY,CAAC,MAAM;gBAC3B,IAAI,EAAE,CAAC,KAAK,EAAE,gBAAgB,CAAC;gBAC/B,OAAO,EAAE,kDAAkD;aAC9D,CAAC,CAAC;YACH,SAAS;QACb,CAAC;QAED,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IAC9C,CAAC;AACL,CAAC,CAAC,CAAC"}

package/build-esm/v1/connector/schemas/tool-snapshot.schema.js

@@ -1,4 +1,9 @@
 import { z } from 'zod';
+/**
+ * Single tool exposed by a connector (native provider tool or MCP server tool).
+ * `inputSchema` is the raw JSON-schema object advertised by the tool; kept as a
+ * bounded record so we never store an unbounded remote payload.
+ */
 export const ConnectorToolSnapshotItemSchema = z.object({
     name: z.string().max(255),
     description: z.string().max(5000).optional(),

package/build-esm/v1/connector/schemas/tool-snapshot.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"tool-snapshot.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/tool-snapshot.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAOxB,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrE,CAAC,CAAC"}
+{"version":3,"file":"tool-snapshot.schema.js","sourceRoot":"","sources":["../../../../v1/connector/schemas/tool-snapshot.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;GAIG;AACH,MAAM,CAAC,MAAM,+BAA+B,GAAG,CAAC,CAAC,MAAM,CAAC;IACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC;IACzB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,QAAQ,EAAE;CACrE,CAAC,CAAC"}

package/build-esm/v1/daily-rewards/commands/admin-delete-reward-config.command.js

@@ -4,6 +4,7 @@ export var AdminDeleteRewardConfigCommand;
 (function (AdminDeleteRewardConfigCommand) {
     AdminDeleteRewardConfigCommand.Request = z.object({});
     AdminDeleteRewardConfigCommand.Response = z.void();
+    // Note: URL is parameterized - use REST_API.V1.DAILY_REWARDS.ADMIN.REWARD_CONFIG_BY_ID(id)
     AdminDeleteRewardConfigCommand.METHOD = HttpMethod.DELETE;
 })(AdminDeleteRewardConfigCommand || (AdminDeleteRewardConfigCommand = {}));
 //# sourceMappingURL=admin-delete-reward-config.command.js.map

package/build-esm/v1/daily-rewards/commands/admin-delete-reward-config.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-delete-reward-config.command.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/commands/admin-delete-reward-config.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,8BAA8B,CAS9C;AATD,WAAiB,8BAA8B;IAC9B,sCAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,uCAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAGpB,qCAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EATgB,8BAA8B,KAA9B,8BAA8B,QAS9C"}
+{"version":3,"file":"admin-delete-reward-config.command.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/commands/admin-delete-reward-config.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,8BAA8B,CAS9C;AATD,WAAiB,8BAA8B;IAC9B,sCAAO,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACvB,uCAAQ,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAEjC,2FAA2F;IAC9E,qCAAM,GAAG,UAAU,CAAC,MAAM,CAAC;AAI5C,CAAC,EATgB,8BAA8B,KAA9B,8BAA8B,QAS9C"}

package/build-esm/v1/daily-rewards/commands/admin-update-reward-config.command.js

@@ -4,6 +4,7 @@ export var AdminUpdateRewardConfigCommand;
 (function (AdminUpdateRewardConfigCommand) {
     AdminUpdateRewardConfigCommand.Request = AdminUpdateRewardConfigRequestSchema;
     AdminUpdateRewardConfigCommand.Response = AdminRewardConfigSchema;
+    // Note: URL is parameterized - use REST_API.V1.DAILY_REWARDS.ADMIN.REWARD_CONFIG_BY_ID(id)
     AdminUpdateRewardConfigCommand.METHOD = HttpMethod.PUT;
 })(AdminUpdateRewardConfigCommand || (AdminUpdateRewardConfigCommand = {}));
 //# sourceMappingURL=admin-update-reward-config.command.js.map

package/build-esm/v1/daily-rewards/commands/admin-update-reward-config.command.js.map

@@ -1 +1 @@
-{"version":3,"file":"admin-update-reward-config.command.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/commands/admin-update-reward-config.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,oCAAoC,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,8BAA8B,CAS9C;AATD,WAAiB,8BAA8B;IAC9B,sCAAO,GAAG,oCAAoC,CAAC;IAC/C,uCAAQ,GAAG,uBAAuB,CAAC;IAGnC,qCAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,8BAA8B,KAA9B,8BAA8B,QAS9C"}
+{"version":3,"file":"admin-update-reward-config.command.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/commands/admin-update-reward-config.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,uBAAuB,EAAE,oCAAoC,EAAE,MAAM,YAAY,CAAC;AAC3F,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D,MAAM,KAAW,8BAA8B,CAS9C;AATD,WAAiB,8BAA8B;IAC9B,sCAAO,GAAG,oCAAoC,CAAC;IAC/C,uCAAQ,GAAG,uBAAuB,CAAC;IAEhD,2FAA2F;IAC9E,qCAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,8BAA8B,KAA9B,8BAA8B,QAS9C"}

package/build-esm/v1/daily-rewards/queries/get-unreg-reward-table.query.js

@@ -2,6 +2,18 @@ import { z } from 'zod';
 import { UnregRewardTableResponseSchema } from '../schemas';
 import { REST_API } from '../../../rest-api';
 import { HttpMethod } from '../../../shared/http-method.enum';
+/**
+ * Public (unauthenticated) endpoint that returns the daily-rewards
+ * preview table shown to visitors before they register.
+ *
+ * **Authentication:** none — callable by SSR, crawlers, and anonymous
+ * browsers without any bearer or unreg token.
+ *
+ * **Response semantics:** the payload is global marketing content
+ * (active `DailyRewardConfig` rows) with a fixed
+ * `claimStatus: FORBIDDEN` to signal the client that no claim flow
+ * is available for unregistered users. No per-user state is returned.
+ */
 export var GetUnregRewardTableQuery;
 (function (GetUnregRewardTableQuery) {
     GetUnregRewardTableQuery.Request = z.void();

package/build-esm/v1/daily-rewards/queries/get-unreg-reward-table.query.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-unreg-reward-table.query.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/queries/get-unreg-reward-table.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAc9D,MAAM,KAAW,wBAAwB,CASxC;AATD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,iCAAQ,GAAG,8BAA8B,CAAC;IAE1C,4BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC;IACnD,+BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,wBAAwB,KAAxB,wBAAwB,QASxC"}
+{"version":3,"file":"get-unreg-reward-table.query.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/queries/get-unreg-reward-table.query.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAC7C,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAE9D;;;;;;;;;;;GAWG;AACH,MAAM,KAAW,wBAAwB,CASxC;AATD,WAAiB,wBAAwB;IACxB,gCAAO,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACnB,iCAAQ,GAAG,8BAA8B,CAAC;IAE1C,4BAAG,GAAG,QAAQ,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,YAAY,CAAC;IACnD,+BAAM,GAAG,UAAU,CAAC,GAAG,CAAC;AAIzC,CAAC,EATgB,wBAAwB,KAAxB,wBAAwB,QASxC"}

package/build-esm/v1/daily-rewards/schemas/streak-status-response.schema.js

@@ -11,6 +11,11 @@ export const StreakStatusResponseSchema = z.object({
     todayRewardAmount: z.string(),
     nextResetAt: z.string(),
     serverTime: z.string(),
+    /**
+     * Anti-fraud gate for the daily bonus: whether the user may claim it right now,
+     * and (when blocked) why + which CTA to show. `available` reflects the same gate
+     * the claim endpoint enforces; the claim itself re-checks server-side.
+     */
     bonusAvailability: BonusAvailabilitySchema,
 });
 //# sourceMappingURL=streak-status-response.schema.js.map

package/build-esm/v1/daily-rewards/schemas/streak-status-response.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"streak-status-response.schema.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/schemas/streak-status-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IAMtB,iBAAiB,EAAE,uBAAuB;CAC7C,CAAC,CAAC"}
+{"version":3,"file":"streak-status-response.schema.js","sourceRoot":"","sources":["../../../../v1/daily-rewards/schemas/streak-status-response.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,uBAAuB,EAAE,MAAM,mDAAmD,CAAC;AAE5F,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE;IACrB,cAAc,EAAE,CAAC,CAAC,OAAO,EAAE;IAC3B,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE;IAC1B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,iBAAiB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE;IACvB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB;;;;OAIG;IACH,iBAAiB,EAAE,uBAAuB;CAC7C,CAAC,CAAC"}

package/build-esm/v1/daily-rewards/unreg-reward-claim-status.enum.js

@@ -1,3 +1,8 @@
+/**
+ * Status returned to unregistered users when they attempt to claim a
+ * daily reward — currently signals only that claiming is forbidden
+ * for this audience.
+ */
 export var UnregRewardClaimStatus;
 (function (UnregRewardClaimStatus) {
     UnregRewardClaimStatus["FORBIDDEN"] = "FORBIDDEN";

package/build-esm/v1/daily-rewards/unreg-reward-claim-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"unreg-reward-claim-status.enum.js","sourceRoot":"","sources":["../../../v1/daily-rewards/unreg-reward-claim-status.enum.ts"],"names":[],"mappings":"AAKA,MAAM,CAAN,IAAY,sBAEX;AAFD,WAAY,sBAAsB;IAC9B,iDAAuB,CAAA;AAC3B,CAAC,EAFW,sBAAsB,KAAtB,sBAAsB,QAEjC"}
+{"version":3,"file":"unreg-reward-claim-status.enum.js","sourceRoot":"","sources":["../../../v1/daily-rewards/unreg-reward-claim-status.enum.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,CAAN,IAAY,sBAEX;AAFD,WAAY,sBAAsB;IAC9B,iDAAuB,CAAA;AAC3B,CAAC,EAFW,sBAAsB,KAAtB,sBAAsB,QAEjC"}