@nodaro/sdk 2.74.0 → 2.76.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (153) hide show
  1. package/dist/chunk-3WQ4UW3C.js +3 -0
  2. package/dist/chunk-3WQ4UW3C.js.map +1 -0
  3. package/dist/{chunk-IJAJTVEW.js → chunk-4Q3XZE5O.js} +17 -3
  4. package/dist/chunk-4Q3XZE5O.js.map +1 -0
  5. package/dist/{chunk-INRVOUKE.js → chunk-66IQZPPW.js} +47 -3
  6. package/dist/chunk-66IQZPPW.js.map +1 -0
  7. package/dist/{chunk-MQQA2E6J.cjs → chunk-6NIKAVI3.cjs} +2 -2
  8. package/dist/chunk-6NIKAVI3.cjs.map +1 -0
  9. package/dist/{chunk-YE6X5BQ2.js → chunk-6TR7QXSX.js} +3 -3
  10. package/dist/{chunk-YE6X5BQ2.js.map → chunk-6TR7QXSX.js.map} +1 -1
  11. package/dist/chunk-6YWXKDAY.cjs +190 -0
  12. package/dist/chunk-6YWXKDAY.cjs.map +1 -0
  13. package/dist/chunk-7NTMMIPC.cjs +4 -0
  14. package/dist/chunk-7NTMMIPC.cjs.map +1 -0
  15. package/dist/{chunk-CLBLAWH3.cjs → chunk-7PMOXQEO.cjs} +9 -9
  16. package/dist/{chunk-CLBLAWH3.cjs.map → chunk-7PMOXQEO.cjs.map} +1 -1
  17. package/dist/{chunk-BETFYVOR.cjs → chunk-7XKVBFKM.cjs} +5 -5
  18. package/dist/{chunk-BETFYVOR.cjs.map → chunk-7XKVBFKM.cjs.map} +1 -1
  19. package/dist/{chunk-HNUCPUIX.js → chunk-AOHDYZSZ.js} +3 -3
  20. package/dist/{chunk-HNUCPUIX.js.map → chunk-AOHDYZSZ.js.map} +1 -1
  21. package/dist/{chunk-TKSQCF2X.js → chunk-CSNYBGHP.js} +2 -2
  22. package/dist/chunk-CSNYBGHP.js.map +1 -0
  23. package/dist/{chunk-4AD3CBDK.cjs → chunk-E2NMFQNY.cjs} +18 -2
  24. package/dist/chunk-E2NMFQNY.cjs.map +1 -0
  25. package/dist/{chunk-NJ5ZFUWJ.js → chunk-FOC4VPGK.js} +4 -4
  26. package/dist/{chunk-NJ5ZFUWJ.js.map → chunk-FOC4VPGK.js.map} +1 -1
  27. package/dist/{chunk-KKQKJD7K.js → chunk-GWL4O3J2.js} +3 -3
  28. package/dist/chunk-GWL4O3J2.js.map +1 -0
  29. package/dist/{chunk-BNJUMQQ3.cjs → chunk-IKZIXM5C.cjs} +24 -8
  30. package/dist/{chunk-BNJUMQQ3.cjs.map → chunk-IKZIXM5C.cjs.map} +1 -1
  31. package/dist/{chunk-GU3YOOCK.cjs → chunk-IO7NEEZZ.cjs} +20 -18
  32. package/dist/chunk-IO7NEEZZ.cjs.map +1 -0
  33. package/dist/chunk-K53JD2ZC.js +187 -0
  34. package/dist/chunk-K53JD2ZC.js.map +1 -0
  35. package/dist/{chunk-6RH2SICN.cjs → chunk-KNBZFWVO.cjs} +22 -22
  36. package/dist/chunk-KNBZFWVO.cjs.map +1 -0
  37. package/dist/{chunk-UDRP64FX.js → chunk-NEGNTQLF.js} +24 -8
  38. package/dist/{chunk-UDRP64FX.js.map → chunk-NEGNTQLF.js.map} +1 -1
  39. package/dist/{chunk-VGY3WBNY.js → chunk-OO4AKYUN.js} +3 -3
  40. package/dist/{chunk-VGY3WBNY.js.map → chunk-OO4AKYUN.js.map} +1 -1
  41. package/dist/{chunk-CCXY4ZJM.js → chunk-SA7VTT7C.js} +3 -3
  42. package/dist/{chunk-CCXY4ZJM.js.map → chunk-SA7VTT7C.js.map} +1 -1
  43. package/dist/{chunk-SRL555ST.cjs → chunk-SGVJUVFD.cjs} +5 -5
  44. package/dist/{chunk-SRL555ST.cjs.map → chunk-SGVJUVFD.cjs.map} +1 -1
  45. package/dist/{chunk-VVVJW4DD.cjs → chunk-SGVTZ2J5.cjs} +31 -28
  46. package/dist/chunk-SGVTZ2J5.cjs.map +1 -0
  47. package/dist/{chunk-YUY56PT7.js → chunk-TZFZDEWI.js} +20 -19
  48. package/dist/chunk-TZFZDEWI.js.map +1 -0
  49. package/dist/{chunk-IKJNFENZ.js → chunk-U2F6IHHY.js} +20 -17
  50. package/dist/chunk-U2F6IHHY.js.map +1 -0
  51. package/dist/{chunk-C5GFDCK2.cjs → chunk-UKITRPXF.cjs} +2 -2
  52. package/dist/{chunk-C5GFDCK2.cjs.map → chunk-UKITRPXF.cjs.map} +1 -1
  53. package/dist/{chunk-VTHHSO2K.cjs → chunk-UPWAODYT.cjs} +4 -4
  54. package/dist/{chunk-VTHHSO2K.cjs.map → chunk-UPWAODYT.cjs.map} +1 -1
  55. package/dist/{chunk-YDRNPIUC.cjs → chunk-VMV5JH4U.cjs} +47 -3
  56. package/dist/chunk-VMV5JH4U.cjs.map +1 -0
  57. package/dist/{chunk-R5DTFY73.js → chunk-WY5QIOO4.js} +2 -2
  58. package/dist/{chunk-R5DTFY73.js.map → chunk-WY5QIOO4.js.map} +1 -1
  59. package/dist/{chunk-EJJIA765.cjs → chunk-XWPYN2VX.cjs} +5 -5
  60. package/dist/{chunk-EJJIA765.cjs.map → chunk-XWPYN2VX.cjs.map} +1 -1
  61. package/dist/{chunk-SZ67PDKE.js → chunk-YQ2Q4OM3.js} +3 -3
  62. package/dist/{chunk-SZ67PDKE.js.map → chunk-YQ2Q4OM3.js.map} +1 -1
  63. package/dist/{chunk-TQLOD7OL.cjs → chunk-ZJM5YBXY.cjs} +4 -4
  64. package/dist/{chunk-TQLOD7OL.cjs.map → chunk-ZJM5YBXY.cjs.map} +1 -1
  65. package/dist/entries/billing.cjs +2 -2
  66. package/dist/entries/billing.d.cts +93 -5
  67. package/dist/entries/billing.d.ts +93 -5
  68. package/dist/entries/billing.js +1 -1
  69. package/dist/entries/cast-swap.cjs +2 -2
  70. package/dist/entries/cast-swap.d.cts +2 -623
  71. package/dist/entries/cast-swap.d.ts +2 -623
  72. package/dist/entries/cast-swap.js +1 -1
  73. package/dist/entries/characters.d.cts +1 -1
  74. package/dist/entries/characters.d.ts +1 -1
  75. package/dist/entries/client.cjs +20 -20
  76. package/dist/entries/client.d.cts +7 -5
  77. package/dist/entries/client.d.ts +7 -5
  78. package/dist/entries/client.js +15 -15
  79. package/dist/entries/copilot.cjs +4 -4
  80. package/dist/entries/copilot.js +3 -3
  81. package/dist/entries/core.cjs +6 -6
  82. package/dist/entries/core.js +2 -2
  83. package/dist/entries/creatures.d.cts +1 -1
  84. package/dist/entries/creatures.d.ts +1 -1
  85. package/dist/entries/credits.cjs +2 -2
  86. package/dist/entries/credits.d.cts +49 -9
  87. package/dist/entries/credits.d.ts +49 -9
  88. package/dist/entries/credits.js +1 -1
  89. package/dist/entries/edit.cjs +7 -7
  90. package/dist/entries/edit.js +2 -2
  91. package/dist/entries/errors.cjs +36 -28
  92. package/dist/entries/errors.d.cts +24 -1
  93. package/dist/entries/errors.d.ts +24 -1
  94. package/dist/entries/errors.js +1 -1
  95. package/dist/entries/jobs.cjs +2 -2
  96. package/dist/entries/jobs.d.cts +4 -4
  97. package/dist/entries/jobs.d.ts +4 -4
  98. package/dist/entries/jobs.js +1 -1
  99. package/dist/entries/locations.d.cts +1 -1
  100. package/dist/entries/locations.d.ts +1 -1
  101. package/dist/entries/media.cjs +4 -4
  102. package/dist/entries/media.d.cts +1 -1
  103. package/dist/entries/media.d.ts +1 -1
  104. package/dist/entries/media.js +3 -3
  105. package/dist/entries/nodes.cjs +3 -3
  106. package/dist/entries/nodes.d.cts +1 -1
  107. package/dist/entries/nodes.d.ts +1 -1
  108. package/dist/entries/nodes.js +2 -2
  109. package/dist/entries/objects.d.cts +1 -1
  110. package/dist/entries/objects.d.ts +1 -1
  111. package/dist/entries/scene3d.d.cts +2 -2
  112. package/dist/entries/scene3d.d.ts +2 -2
  113. package/dist/entries/studio.cjs +5 -5
  114. package/dist/entries/studio.js +2 -2
  115. package/dist/entries/trends.cjs +2 -2
  116. package/dist/entries/trends.d.cts +26 -18
  117. package/dist/entries/trends.d.ts +26 -18
  118. package/dist/entries/trends.js +1 -1
  119. package/dist/entries/uploads.cjs +7 -2
  120. package/dist/entries/uploads.d.cts +60 -1
  121. package/dist/entries/uploads.d.ts +60 -1
  122. package/dist/entries/uploads.js +2 -1
  123. package/dist/entries/video-remake.cjs +13 -0
  124. package/dist/entries/video-remake.cjs.map +1 -0
  125. package/dist/entries/video-remake.d.cts +4 -0
  126. package/dist/entries/video-remake.d.ts +4 -0
  127. package/dist/entries/video-remake.js +4 -0
  128. package/dist/entries/video-remake.js.map +1 -0
  129. package/dist/index.cjs +82 -65
  130. package/dist/index.d.cts +6 -6
  131. package/dist/index.d.ts +6 -6
  132. package/dist/index.js +16 -15
  133. package/dist/{nodes-DEGPmZ9a.d.cts → nodes-BHtjh6gl.d.cts} +8 -5
  134. package/dist/{nodes-CHXTwiWW.d.ts → nodes-BaRqRB2Z.d.ts} +8 -5
  135. package/dist/video-remake-C-KR7YtT.d.ts +676 -0
  136. package/dist/video-remake-DTuCyhd9.d.cts +676 -0
  137. package/package.json +8 -3
  138. package/dist/chunk-4AD3CBDK.cjs.map +0 -1
  139. package/dist/chunk-6RH2SICN.cjs.map +0 -1
  140. package/dist/chunk-F6KAMECM.cjs +0 -72
  141. package/dist/chunk-F6KAMECM.cjs.map +0 -1
  142. package/dist/chunk-GU3YOOCK.cjs.map +0 -1
  143. package/dist/chunk-IJAJTVEW.js.map +0 -1
  144. package/dist/chunk-IKJNFENZ.js.map +0 -1
  145. package/dist/chunk-INRVOUKE.js.map +0 -1
  146. package/dist/chunk-KKQKJD7K.js.map +0 -1
  147. package/dist/chunk-MQQA2E6J.cjs.map +0 -1
  148. package/dist/chunk-TKSQCF2X.js.map +0 -1
  149. package/dist/chunk-VVVJW4DD.cjs.map +0 -1
  150. package/dist/chunk-YDRNPIUC.cjs.map +0 -1
  151. package/dist/chunk-YEOK5A5H.js +0 -70
  152. package/dist/chunk-YEOK5A5H.js.map +0 -1
  153. package/dist/chunk-YUY56PT7.js.map +0 -1
@@ -122,17 +122,33 @@ var CreditsResource = class {
122
122
  });
123
123
  }
124
124
  /**
125
- * `POST /v1/credits/welcome-offer/seen` → records that the one-time welcome
126
- * popup was shown, so `balance().welcomeOffer.popupSeen` turns true on every
127
- * app. Idempotent (the first stamp wins); a failed call only means the popup
128
- * may show once more, so callers usually ignore errors.
125
+ * `POST /v1/credits/welcome-offer/seen` → tells the server what happened to
126
+ * the welcome popup, which decides `balance().welcomeOffer.popupDue` from it
127
+ * on every app:
128
+ *
129
+ * - `"shown"`: the popup opened by itself (because `popupDue` was true).
130
+ * Counts one of the account's three showings while the popup is due;
131
+ * nothing is counted otherwise (a second call within 24 hours, after
132
+ * "Maybe later", after the third), so a repeated call is harmless.
133
+ * - `"later"`: the user answered "Maybe later". The popup does not open by
134
+ * itself again.
135
+ *
136
+ * A close without an answer (the ×, Escape, a click outside) is reported by
137
+ * not calling this at all. Called with no event, it sends no body, and the
138
+ * server reads that as `"later"` (what apps written before the event sent on
139
+ * any close). Both writes are idempotent; a failed call only means the
140
+ * popup may show once more, so callers usually ignore errors.
129
141
  *
130
142
  * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API
131
143
  * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is
132
144
  * off, 404 on a self-hosted instance.
133
145
  */
134
- markWelcomeOfferSeen() {
135
- return this.client.request("POST", "/v1/credits/welcome-offer/seen");
146
+ markWelcomeOfferSeen(event) {
147
+ return this.client.request(
148
+ "POST",
149
+ "/v1/credits/welcome-offer/seen",
150
+ event === void 0 ? {} : { body: { event } }
151
+ );
136
152
  }
137
153
  // NOTE: no `estimate(...)` helper. The backend exposes
138
154
  // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {
@@ -145,5 +161,5 @@ var CreditsResource = class {
145
161
  };
146
162
 
147
163
  exports.CreditsResource = CreditsResource;
148
- //# sourceMappingURL=chunk-BNJUMQQ3.cjs.map
149
- //# sourceMappingURL=chunk-BNJUMQQ3.cjs.map
164
+ //# sourceMappingURL=chunk-IKZIXM5C.cjs.map
165
+ //# sourceMappingURL=chunk-IKZIXM5C.cjs.map
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/resources/credits.ts"],"names":[],"mappings":";;;AA8cA,IAAM,iBAAA,GAAoB,EAAA;AAEnB,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,MAAM,OAAA,GAAgC;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,KAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,OAAA,GAAqC,EAAC,EAAoC;AACrF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,KAAA,EAAO,0BAAA,EAA4B;AAAA,MACpF,OAAO,EAAE,KAAA,EAAO,QAAQ,KAAA,EAAO,MAAA,EAAQ,QAAQ,MAAA;AAAO,KACvD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,YAAA,CAAa,OAAA,GAA+B,EAAC,EAA0B;AAC3E,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,OAAO,2BAAA,EAA6B;AAAA,MAChG,KAAA,EAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,IAAI,OAAA,CAAQ,EAAA,EAAI,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO,KACrE,CAAA;AACD,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAA,CAAQ,OAAA,GAAgC,EAAC,EAA+B;AACtE,IAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,GAAG,SAAQ,GAAI,OAAA;AACtC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA2B,KAAA,EAAO,qBAAA,EAAuB;AAAA,MAC1E,KAAA,EAAO,EAAE,KAAA,EAAO,MAAA,EAAQ,GAAG,OAAA;AAAQ,KACpC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAoB;AACjE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,WAAA,CAAY,KAAA,EAAO,qBAAA,EAAuB;AAAA,MAC3D,KAAA,EAAO,EAAE,GAAG,OAAA,EAAS,QAAQ,KAAA;AAAM,KACpC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAA,EAA0C;AACnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,MAAA,EAAQ,yBAAA,EAA2B;AAAA,MAC9E,MAAM,EAAE,MAAA,EAAQ,IAAI,KAAA,CAAM,CAAA,EAAG,iBAAiB,CAAA;AAAE,KACjD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,gBAAA,CAAiB,IAAA,GAAmB,EAAC,EAAoC;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAA,EAAkC;AAAA,MAC3F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,iBAAA,CAAkB,KAAA,GAAgC,EAAC,EAAqC;AACtF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,MAAA,EAAQ,iCAAA,EAAmC;AAAA,MAC7F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,oBAAA,GAAwD;AACtD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAgC,CAAA;AAAA,EAC7F;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUF","file":"chunk-BNJUMQQ3.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s\n * `data` field. Mirrors the canonical `UserBalance` from the backend billing\n * module (`backend/src/ee/billing/credits.ts`), the source of truth: keep this\n * in sync if that interface changes.\n */\nexport interface UserBalance {\n total: number\n subscription: number\n topup: number\n dailySpent: number\n dailyLimit: number | null\n monthlyAllocation: number\n /** Stored billing tier. Display should prefer `effectiveTier`. */\n tier: string\n /** Derived entitlement tier: \"payg\" when stored-free with purchased credits. */\n effectiveTier: string\n features: Record<string, unknown>\n periodEnd: string | null\n /** Credits earned for app usage (free tier only — earned by running flows). */\n appCreditsAllowance: number\n /** Present when a deployment uses an external shared wallet. Raw credits;\n * null means unavailable. Do not substitute the personal `total` balance. */\n externalWallet?: { available: number | null }\n /**\n * Where the account's free signup grant stands. `\"withheld\"` means the\n * account works but the grant did not land — show the activation path.\n * Absent where the deployment has no signup grant.\n */\n freeGrantState?: FreeGrantState\n /**\n * Present only with `freeGrantState: \"withheld\"`, when the claim showed no\n * browser signals at all: the app may say \"free credits need a regular\n * browser — reload\", because a reload in one judges the account again.\n */\n freeGrantNotice?: \"browser_unmeasured\"\n /**\n * The welcome-credits opt-in. PRESENT only while the deployment has the\n * offer switched on — absent means \"no popup, no banner, no block\".\n */\n welcomeOffer?: WelcomeOfferState\n /**\n * A deployment with a single payer only: the caller's own allowance, in\n * credits — the figure to show there, since `total` is the personal balance,\n * which does not fund runs on such a deployment. `null` for the billing\n * account itself, or when the figure could not be read (never treat it as 0).\n * Absent on every other deployment.\n */\n allowance?: BalanceAllowance | null\n /**\n * The same credit figures in the deployment's own unit, converted by the\n * server — present only on a deployment that shows its own unit instead of\n * credits. Render these as they are; never convert credits yourself. Absent\n * for the billing account's own read on a deployment with a single payer:\n * its balance is the deployment's pool, which stays in credits.\n */\n display?: BalanceDisplay\n}\n\n/** `UserBalance.allowance` — a deployment with a single payer: the caller's own allowance, in credits. */\nexport interface BalanceAllowance {\n /** Credits the caller was granted. */\n granted: number\n /** Credits the caller has left of it. */\n remaining: number\n /**\n * Whether the deployment refuses a run beyond the allowance. `false` = the\n * allowance is shown, not enforced: gate a run on `remaining` only when true.\n */\n enforced: boolean\n}\n\n/**\n * The unit a `display` object is in. A deployment can show its own unit\n * instead of credits; its figures are then converted by the server, so a\n * client renders them as they are and never multiplies by a rate.\n */\nexport interface DisplayUnitInfo {\n /** The unit's label — what the deployment calls its credits. */\n unit: string\n /** Decimal places the converted figures carry (0–4). */\n decimals: number\n /**\n * The unit's word per interface language, when the deployment gives one per\n * language (locale id → word, e.g. `{ en: \"points\", he: \"נקודות\" }`). Show\n * `unitLabels[locale] ?? unit`; a language without an entry uses `unit`.\n * The server does not know the viewer's interface language, so it sends the\n * words and the client picks.\n */\n unitLabels?: Record<string, string>\n}\n\n/**\n * `UserBalance.display` — the balance's credit figures in the deployment's own\n * unit, converted by the server. `null` = the figure is unavailable (show an em\n * dash, never 0). The optional keys are present exactly when the raw\n * `allowance`, `externalWallet` and `welcomeOffer` are.\n */\nexport interface BalanceDisplay extends DisplayUnitInfo {\n total: number | null\n subscription: number | null\n topup: number | null\n dailySpent: number | null\n dailyLimit: number | null\n monthlyAllocation: number | null\n appCreditsAllowance: number | null\n allowance?: { granted: number | null; remaining: number | null } | null\n externalWallet?: { available: number | null }\n welcomeOffer?: { credits: number | null }\n}\n\n/** `ModelCostsResult.display` — each priced identifier's credits, in the deployment's own unit. */\nexport interface ModelCostsDisplay extends DisplayUnitInfo {\n /** The same identifiers as `data`, converted. An id in `estimates` is an estimate here too. */\n data: Record<string, number | null>\n}\n\n/** `ModelCostResult.display` — the one identifier's credits, in the deployment's own unit. */\nexport interface ModelCostDisplay extends DisplayUnitInfo {\n creditCost: number | null\n}\n\n/** Where an account's free signup grant stands. */\nexport type FreeGrantState = \"unclaimed\" | \"granted\" | \"withheld\" | \"revoked\"\n\n/** `UserBalance.welcomeOffer` — what an app needs to show the welcome offer. */\nexport interface WelcomeOfferState {\n /** The one-time popup was already shown (see `markWelcomeOfferSeen`). */\n popupSeen: boolean\n /**\n * The account already has its credits (granted elsewhere) but still owes\n * the email consent: the web apps block creation until it is given — the\n * claim records it.\n */\n consentPending: boolean\n /** The credits a claim grants. Name this figure in the offer; never hard-code it. */\n credits: number\n}\n\n/** What `claimWelcomeOffer` sends: the browser signals plus the app answering. */\nexport interface WelcomeOfferClaimInput extends SignupKeys {\n /**\n * The answering app's slug (lowercase letters, digits and `-`, up to 40\n * characters), recorded with the consent. A value outside that grammar is\n * stored as absent, never refused.\n */\n sourceApp?: string\n /**\n * The interface language the user answered in — the id of a language Nodaro\n * ships, such as `\"en\"`, `\"ja\"` or `\"pt-BR\"`. Matched exactly and\n * case-sensitively: `\"en-US\"` or `\"pt-br\"` is stored as absent, never refused.\n * Recorded with the consent as the language of the LATEST consent: a later\n * \"yes\" in another language replaces it.\n */\n locale?: string\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/claim`. */\nexport interface WelcomeOfferClaimResult {\n /** The email consent is recorded. */\n consent: \"granted\"\n /** Where the free grant stands after the claim — `\"withheld\"` when the abuse gate refused it. */\n grant: FreeGrantState\n /** The grant's figure. A grant tops the subscription credits UP TO it (it is not added on top), so a claim that lands it leaves the subscription credits at no less than this. */\n credits: number\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/seen`. */\nexport interface WelcomeOfferSeenResult {\n ok: true\n}\n\n/**\n * Result of `POST /v1/credits/model-costs` — a batch cost lookup for editor\n * cost previews. `data` maps each priced identifier → its credit cost.\n *\n * Per-model fault isolation (the route runs the lookups under\n * `Promise.allSettled`): identifiers with no pricing row are reported in\n * `missing` (undisplayable until an operator seeds a price) and lookup\n * failures in `errors`, instead of failing the whole batch. Callers typically\n * render `'—'` for any identifier that lands in `missing`. The hard-fail\n * policy still triggers at reservation time when the user actually runs the\n * node — this preview lookup is intentionally lenient.\n */\nexport interface ModelCostsResult {\n data: Record<string, number>\n missing: string[]\n errors: string[]\n /**\n * Why each identifier in `errors` has no price — today only\n * `llm_model_unpriced`: a metered LLM price key whose model has no rate on\n * the lane it would be served on (it cannot be run). Omitted when `errors`\n * is empty.\n */\n errorCodes?: Record<string, ModelCostError>\n /**\n * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:\n * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,\n * `<feature>:<model>[:direct | :effort-<level>]`), charged on what the call actually uses.\n * Show these as `≈N`. Omitted when there are none, so a batch of fixed ids\n * answers exactly as it always has. A metered key that lands in `missing`\n * instead means the server is not pricing LLM calls per model — show no\n * price for it.\n */\n estimates?: string[]\n /**\n * The same prices in the deployment's own unit, converted by the server —\n * present only on a deployment that shows its own unit instead of credits.\n */\n display?: ModelCostsDisplay\n}\n\n/** {@link ModelCostsResult.errorCodes} — why an identifier has no price. */\nexport interface ModelCostError {\n /** Today only `llm_model_unpriced`; open to codes a newer server may add. */\n code: \"llm_model_unpriced\" | (string & {})\n /** A sentence to show the user. */\n message: string\n}\n\n/**\n * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one\n * identifier is charged. `estimate: true` marks a metered LLM price key's\n * figure as an estimate (show it as `≈N`); such an answer is never cached.\n */\nexport interface ModelCostResult {\n model: string\n creditCost: number\n estimate?: true\n /** `creditCost` in the deployment's own unit, converted by the server — present only where one is configured. */\n display?: ModelCostDisplay\n}\n\n/**\n * The two browser signals a claim reports — SHA-256 hex digests computed by\n * `@nodaro/sdk/signup-signals` (`collectSignupKeys`). Either may be absent:\n * a browser that cannot be measured still claims, and the server treats the\n * absence as what it is. Any other value is stored as absent server-side.\n */\nexport interface SignupKeys {\n browserKey?: string\n deviceKey?: string\n}\n\n/** The answer of `POST /v1/credits/claim-signup-grant`. */\nexport interface SignupGrantClaimResult {\n /** Where the account's free grant stands after this call. */\n state: FreeGrantState\n /** True only when THIS call moved the credits — a repeat is `false` with the same state. */\n granted: boolean\n}\n\n/**\n * One row of `GET /v1/credits/transactions` — a run's reservation and how it\n * settled.\n *\n * Which amount to read: a run first HOLDS credits and is then settled — charged\n * all or part of the hold, the rest returned. `credits_charged` is what the run\n * cost (`null` while the hold is still open, `0` once refunded); sum it for\n * spend. `credits_reserved` is the hold, which never changes. `credits_used`\n * is the same hold under its original name, kept for existing integrations.\n */\nexport interface CreditTransaction {\n id: string\n /** ISO-8601. Also the paging cursor: pass the last row's value as `cursor`. */\n created_at: string\n /** Settled charge; `null` while `status` is `\"reserved\"`, `0` when refunded. */\n credits_charged: number | null\n /** The hold taken when the run was accepted. */\n credits_reserved: number | null\n /** The hold, under its original name. Prefer `credits_charged`. */\n credits_used: number | null\n /** The model or operation the credits were for. */\n action: string | null\n provider: string | null\n /** Reservation lifecycle: `\"reserved\"`, `\"committed\"` or `\"refunded\"`. */\n status: string | null\n /** The caller's own billing details for the run (model, which pool paid, …). */\n metadata: Record<string, unknown>\n /** `\"workspace\"` when a class or team budget paid, not your balance. */\n payer: \"user\" | \"workspace\"\n workspaceId: string | null\n}\n\n/** A page of {@link CreditTransaction}s, newest first. */\nexport interface CreditTransactionsPage {\n data: CreditTransaction[]\n /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n nextCursor: string | null\n}\n\nexport interface CreditTransactionsOptions {\n /** Rows per page, 1–50 (server default 20). */\n limit?: number\n /** The `nextCursor` of the previous page. */\n cursor?: string\n}\n\n/** How `credits.usageSummary()` groups the series over time. */\nexport type UsageSummaryBucket = \"day\" | \"week\" | \"month\"\n\nexport interface UsageSummaryOptions {\n /** An ISO-8601 timestamp, or a date alone (`\"2026-10-01\"`: that whole UTC day), inclusive; default the last 30 days up to now. A period of at most a year. */\n from?: string\n to?: string\n /** Default `\"day\"`. Buckets are UTC. */\n bucket?: UsageSummaryBucket\n}\n\nexport interface UsageSummaryTotals {\n /** Credits spent on runs in the period: each run's charge (a running hold counts; a refunded run does not). */\n used: number\n /** Credits bought: packs, loads, subscription grants. */\n purchased: number\n /** Credits granted free, net: sign-up and admin adjustments, a grant taken back subtracted. */\n granted: number\n /** Credits given back for a refunded run or by Stripe (a hold released when a run settled below it is not a refund). */\n refunded: number\n /** Runs that were charged or are still running. */\n runs: number\n /** `used / runs`, one decimal; 0 with no runs. */\n avgPerRun: number\n}\n\nexport interface UsageByModel {\n model: string\n provider: string | null\n credits: number\n runs: number\n /** Of `totals.used`, 0–1. */\n share: number\n}\n\nexport interface UsageByCategory {\n /** `\"image\"`, `\"video\"`, `\"audio\"` or `\"other\"`. */\n category: string\n credits: number\n runs: number\n}\n\nexport interface UsageOverTime {\n /** The bucket's first day in UTC (`\"2026-10-26\"`; a week by its Monday; a month as `\"2026-10\"`). The first bucket of a period may be a partial week or month. */\n bucket: string\n used: number\n purchased: number\n runs: number\n}\n\n/** The spend of one session or one workflow. */\nexport interface UsageByGroup {\n id: string\n /** The session's title or the workflow's name; `null` when it has none or is gone. */\n name: string | null\n /** The tool the session belongs to; `null` on a workflow. */\n tool: string | null\n credits: number\n runs: number\n /** The models used, by spend. */\n models: string[]\n /** ISO-8601: the latest run. */\n lastAt: string\n}\n\n/** The answer of `credits.usageSummary()`. */\nexport interface UsageSummary {\n period: { from: string; to: string; bucket: UsageSummaryBucket }\n totals: UsageSummaryTotals\n /** The model with the most spend; `null` with no runs. */\n mostUsed: UsageByModel | null\n /** By spend. */\n byModel: UsageByModel[]\n byCategory: UsageByCategory[]\n /** Every bucket of the period, empty ones included, oldest first. */\n overTime: UsageOverTime[]\n bySession: UsageByGroup[]\n byWorkflow: UsageByGroup[]\n /** A read hit the server's row cap: the figures under-report; narrow the period. */\n truncated: boolean\n /** A side read failed on the server (the jobs, or a session's or workflow's name): a grouping is missing or unnamed; the totals are whole. */\n partial: boolean\n}\n\n/** What a movement of the balance was; `app` is credits earned from, or paid for, a published app. */\nexport type CreditHistoryKind = \"usage\" | \"purchase\" | \"grant\" | \"refund\" | \"app\" | \"adjustment\" | \"expiry\"\n\n/** The job behind a usage row of {@link CreditHistoryEntry}. */\nexport interface CreditHistoryJob {\n id: string\n /** The node type that ran (`generate-image`, `image-to-video`, …); `null` when the job is gone. */\n type: string | null\n status: string | null\n startedAt: string | null\n completedAt: string | null\n /** From start to completion; `null` until it completes. */\n durationMs: number | null\n workflowId: string | null\n sessionId: string | null\n}\n\n/** One movement of the balance (`credits.history()`). */\nexport interface CreditHistoryEntry {\n id: string\n /** ISO-8601. Also the paging cursor. */\n at: string\n kind: CreditHistoryKind\n /** The ledger's own word: `usage`, `one_time_purchase`, `subscription_renewal`, `signup_grant`, `refund`, `admin_adjustment`, `expiry`, … */\n source: string\n /** The movement, signed: a run's hold negative, a purchase positive. */\n amount: number\n /** The balance right after this movement. */\n balanceAfter: number\n /** Which pool moved; `\"mixed\"` when both did. */\n pool: \"subscription\" | \"topup\" | \"mixed\"\n description: string | null\n /** The model that ran, on a row with a job; `null` otherwise. */\n model: string | null\n provider: string | null\n /**\n * The job's charge, on its reserve row only (the hold taken when the run\n * was accepted): the settled charge, the hold while the run is open, `0`\n * once refunded. `null` on every other row — a refund, a metered overrun\n * line, a purchase — so summing it over a list counts each job once. Read\n * this for spend, not `amount`.\n */\n charge: number | null\n /** The run's credit status (`\"reserved\"`, `\"committed\"` or `\"refunded\"`), beside `charge`; `null` elsewhere. */\n status: string | null\n /** On a row with a job; `type` and the rest `null` when the job is gone or not the person's. */\n job: CreditHistoryJob | null\n /** Stripe's hosted receipt, on a purchase that has one. */\n receiptUrl: string | null\n}\n\n/** A page of {@link CreditHistoryEntry}, newest first. */\nexport interface CreditHistoryPage {\n data: CreditHistoryEntry[]\n /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n nextCursor: string | null\n}\n\n/** What narrows the history. */\nexport interface CreditHistoryFilters {\n kind?: CreditHistoryKind\n /** A model identifier: only runs of that model. */\n model?: string\n /** ISO-8601 bounds on `at`, inclusive. */\n from?: string\n to?: string\n /** Words looked for in the description, case-insensitively. */\n q?: string\n}\n\nexport interface CreditHistoryOptions extends CreditHistoryFilters {\n /** Rows per page, 1–100 (server default 50). */\n limit?: number\n /** The `nextCursor` of the previous page, as given (opaque; another string is refused with 400). */\n cursor?: string\n}\n\n/** Max identifiers per `model-costs` batch — the route caps the request at 50. */\nconst MODEL_COSTS_LIMIT = 50\n\nexport class CreditsResource {\n constructor(private client: NodaroClientCore) {}\n\n /**\n * `GET /v1/user/credits` → the authenticated user's credit balance and tier\n * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's\n * other typed errors on the usual statuses.\n */\n async balance(): Promise<UserBalance> {\n const res = await this.client.request<{ data: UserBalance }>(\n \"GET\",\n \"/v1/user/credits\",\n )\n return res.data\n }\n\n /**\n * `GET /v1/credits/transactions` → one page of the caller's credit\n * transactions, newest first, with `nextCursor` for the next page (`null`\n * at the end). Read `credits_charged` for what each run cost — it can be\n * below the hold (`credits_reserved`) and is `null` while the hold is open.\n * Cloud-only route: a self-hosted instance answers 404.\n */\n transactions(options: CreditTransactionsOptions = {}): Promise<CreditTransactionsPage> {\n return this.client.request<CreditTransactionsPage>(\"GET\", \"/v1/credits/transactions\", {\n query: { limit: options.limit, cursor: options.cursor },\n })\n }\n\n /**\n * `GET /v1/credits/usage-summary` → the period's credit usage summed the\n * way a billing screen draws it: totals, the spend by model and by\n * category, a series over time (`bucket`: day, week or month, no holes),\n * and the spend by session and by workflow. The last 30 days unless\n * `from` / `to` say otherwise; a period of at most a year (400 beyond).\n * Cloud-only route: a self-hosted instance answers 404.\n */\n async usageSummary(options: UsageSummaryOptions = {}): Promise<UsageSummary> {\n const res = await this.client.request<{ data: UsageSummary }>(\"GET\", \"/v1/credits/usage-summary\", {\n query: { from: options.from, to: options.to, bucket: options.bucket },\n })\n return res.data\n }\n\n /**\n * `GET /v1/credits/history` → one page of every movement of the balance,\n * newest first — runs, purchases, grants, refunds, adjustments, expiries —\n * each with the balance after it; a job's reserve row carries its model,\n * its `charge` (the settled charge, the hold while the run is open, `0`\n * once refunded — read that for spend, not `amount`) and its job. Filter by\n * `kind`, `model`, `from` / `to` and `q`; pass the page's `nextCursor` (an\n * opaque string) as `cursor` for the next page (`null` at the end).\n * Cloud-only route: a self-hosted instance answers 404.\n */\n history(options: CreditHistoryOptions = {}): Promise<CreditHistoryPage> {\n const { limit, cursor, ...filters } = options\n return this.client.request<CreditHistoryPage>(\"GET\", \"/v1/credits/history\", {\n query: { limit, cursor, ...filters },\n })\n }\n\n /**\n * `GET /v1/credits/history?format=csv` → the whole filtered history as a\n * CSV file (the same fields as {@link history}, one line per movement,\n * newest first), at most 5,000 rows — the last line says when it was cut.\n * Hand the text to the person as `credit-history.csv`.\n */\n exportHistory(filters: CreditHistoryFilters = {}): Promise<string> {\n return this.client.requestText(\"GET\", \"/v1/credits/history\", {\n query: { ...filters, format: \"csv\" },\n })\n }\n\n /**\n * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor\n * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers\n * (the route's request limit). Preserves the `{ data, missing, errors }`\n * fault-isolation shape verbatim, plus `estimates` / `errorCodes` when a\n * metered LLM price key was asked (see {@link ModelCostsResult}).\n */\n modelCosts(ids: string[]): Promise<ModelCostsResult> {\n return this.client.request<ModelCostsResult>(\"POST\", \"/v1/credits/model-costs\", {\n body: { models: ids.slice(0, MODEL_COSTS_LIMIT) },\n })\n }\n\n /**\n * `POST /v1/credits/claim-signup-grant` → claims the account's free signup\n * grant, once, with the browser signals of the page making the claim.\n *\n * Call it once per page load as soon as the session is known, and never\n * wait on it for rendering: it is idempotent (a decided account answers\n * with its state and `granted: false`), it costs the user nothing when it\n * fails (the next load asks again), and the signals are what make the\n * claim worth sending — collect them with `collectSignupKeys()` from\n * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.\n * Cloud-only route: a self-hosted instance answers 404.\n */\n claimSignupGrant(keys: SignupKeys = {}): Promise<SignupGrantClaimResult> {\n return this.client.request<SignupGrantClaimResult>(\"POST\", \"/v1/credits/claim-signup-grant\", {\n body: keys,\n })\n }\n\n /**\n * `POST /v1/credits/welcome-offer/claim` → the user's \"yes\" to the welcome\n * offer, as ONE server action: the marketing-email consent is recorded,\n * then the free signup grant is claimed with that consent. The abuse gate\n * still decides — consent is necessary, not sufficient — so read `grant`:\n * `\"granted\"` (the grant has landed: this call topped the subscription credits up to `credits` — not added on top — or it had landed before), `\"withheld\"` (refused), `\"revoked\"` (taken back earlier; nothing moves), `\"unclaimed\"` (nothing moved — treat as a failure and let the user retry).\n * Pass the browser signals from `collectSignupKeys()` and your app's slug.\n *\n * **Browser session only.** Usable from a first-party web app signed in\n * with a Supabase session (the consent is a person's choice in a browser);\n * an API key or OAuth app token is refused with 403. 409\n * `welcome_offer_disabled` while the deployment has the offer off — show\n * it only when `balance().welcomeOffer` is present. Cloud-only route: a\n * self-hosted instance answers 404.\n */\n claimWelcomeOffer(input: WelcomeOfferClaimInput = {}): Promise<WelcomeOfferClaimResult> {\n return this.client.request<WelcomeOfferClaimResult>(\"POST\", \"/v1/credits/welcome-offer/claim\", {\n body: input,\n })\n }\n\n /**\n * `POST /v1/credits/welcome-offer/seen` → records that the one-time welcome\n * popup was shown, so `balance().welcomeOffer.popupSeen` turns true on every\n * app. Idempotent (the first stamp wins); a failed call only means the popup\n * may show once more, so callers usually ignore errors.\n *\n * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API\n * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is\n * off, 404 on a self-hosted instance.\n */\n markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult> {\n return this.client.request<WelcomeOfferSeenResult>(\"POST\", \"/v1/credits/welcome-offer/seen\")\n }\n\n // NOTE: no `estimate(...)` helper. The backend exposes\n // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {\n // totalCredits, nodeCount, estimate?: true } }` — `estimate` when a metered\n // LLM node's estimate is in the total), but no consumer has a settled shape for it\n // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than\n // calling an estimate endpoint). Adding it now would be inventing an API\n // surface ahead of a real caller, so it's deliberately omitted — add it when\n // a consumer needs it, shaped to that need.\n}\n"]}
1
+ {"version":3,"sources":["../src/resources/credits.ts"],"names":[],"mappings":";;;AA2eA,IAAM,iBAAA,GAAoB,EAAA;AAEnB,IAAM,kBAAN,MAAsB;AAAA,EAC3B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOpB,MAAM,OAAA,GAAgC;AACpC,IAAA,MAAM,GAAA,GAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA;AAAA,MAC5B,KAAA;AAAA,MACA;AAAA,KACF;AACA,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,YAAA,CAAa,OAAA,GAAqC,EAAC,EAAoC;AACrF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,KAAA,EAAO,0BAAA,EAA4B;AAAA,MACpF,OAAO,EAAE,KAAA,EAAO,QAAQ,KAAA,EAAO,MAAA,EAAQ,QAAQ,MAAA;AAAO,KACvD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAM,YAAA,CAAa,OAAA,GAA+B,EAAC,EAA0B;AAC3E,IAAA,MAAM,MAAM,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,OAAO,2BAAA,EAA6B;AAAA,MAChG,KAAA,EAAO,EAAE,IAAA,EAAM,OAAA,CAAQ,IAAA,EAAM,IAAI,OAAA,CAAQ,EAAA,EAAI,MAAA,EAAQ,OAAA,CAAQ,MAAA;AAAO,KACrE,CAAA;AACD,IAAA,OAAO,GAAA,CAAI,IAAA;AAAA,EACb;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYA,OAAA,CAAQ,OAAA,GAAgC,EAAC,EAA+B;AACtE,IAAA,MAAM,EAAE,KAAA,EAAO,MAAA,EAAQ,GAAG,SAAQ,GAAI,OAAA;AACtC,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA2B,KAAA,EAAO,qBAAA,EAAuB;AAAA,MAC1E,KAAA,EAAO,EAAE,KAAA,EAAO,MAAA,EAAQ,GAAG,OAAA;AAAQ,KACpC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQA,aAAA,CAAc,OAAA,GAAgC,EAAC,EAAoB;AACjE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,WAAA,CAAY,KAAA,EAAO,qBAAA,EAAuB;AAAA,MAC3D,KAAA,EAAO,EAAE,GAAG,OAAA,EAAS,QAAQ,KAAA;AAAM,KACpC,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,WAAW,GAAA,EAA0C;AACnD,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAA0B,MAAA,EAAQ,yBAAA,EAA2B;AAAA,MAC9E,MAAM,EAAE,MAAA,EAAQ,IAAI,KAAA,CAAM,CAAA,EAAG,iBAAiB,CAAA;AAAE,KACjD,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,gBAAA,CAAiB,IAAA,GAAmB,EAAC,EAAoC;AACvE,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAgC,MAAA,EAAQ,gCAAA,EAAkC;AAAA,MAC3F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAiBA,iBAAA,CAAkB,KAAA,GAAgC,EAAC,EAAqC;AACtF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAiC,MAAA,EAAQ,iCAAA,EAAmC;AAAA,MAC7F,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAwBA,qBAAqB,KAAA,EAAgE;AACnF,IAAA,OAAO,KAAK,MAAA,CAAO,OAAA;AAAA,MACjB,MAAA;AAAA,MACA,gCAAA;AAAA,MACA,KAAA,KAAU,SAAY,EAAC,GAAI,EAAE,IAAA,EAAM,EAAE,OAAM;AAAE,KAC/C;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAUF","file":"chunk-IKZIXM5C.cjs","sourcesContent":["import type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Authenticated user's credit balance — the shape of `GET /v1/user/credits`'s\n * `data` field. Mirrors the canonical `UserBalance` from the backend billing\n * module (`backend/src/ee/billing/credits.ts`), the source of truth: keep this\n * in sync if that interface changes.\n */\nexport interface UserBalance {\n total: number\n subscription: number\n topup: number\n dailySpent: number\n dailyLimit: number | null\n monthlyAllocation: number\n /** Stored billing tier. Display should prefer `effectiveTier`. */\n tier: string\n /** Derived entitlement tier: \"payg\" when stored-free with purchased credits. */\n effectiveTier: string\n features: Record<string, unknown>\n periodEnd: string | null\n /** Credits earned for app usage (free tier only — earned by running flows). */\n appCreditsAllowance: number\n /** Present when a deployment uses an external shared wallet. Raw credits;\n * null means unavailable. Do not substitute the personal `total` balance. */\n externalWallet?: { available: number | null }\n /**\n * Where the account's free signup grant stands. `\"withheld\"` means the\n * account works but the grant did not land — show the activation path.\n * Absent where the deployment has no signup grant.\n */\n freeGrantState?: FreeGrantState\n /**\n * Present only with `freeGrantState: \"withheld\"`, when the claim showed no\n * browser signals at all: the app may say \"free credits need a regular\n * browser — reload\", because a reload in one judges the account again.\n */\n freeGrantNotice?: \"browser_unmeasured\"\n /**\n * The welcome-credits opt-in. PRESENT only while the deployment has the\n * offer switched on — absent means \"no popup, no banner, no block\".\n */\n welcomeOffer?: WelcomeOfferState\n /**\n * A deployment with a single payer only: the caller's own allowance, in\n * credits — the figure to show there, since `total` is the personal balance,\n * which does not fund runs on such a deployment. `null` for the billing\n * account itself, or when the figure could not be read (never treat it as 0).\n * Absent on every other deployment.\n */\n allowance?: BalanceAllowance | null\n /**\n * The same credit figures in the deployment's own unit, converted by the\n * server — present only on a deployment that shows its own unit instead of\n * credits. Render these as they are; never convert credits yourself. Absent\n * for the billing account's own read on a deployment with a single payer:\n * its balance is the deployment's pool, which stays in credits.\n */\n display?: BalanceDisplay\n}\n\n/** `UserBalance.allowance` — a deployment with a single payer: the caller's own allowance, in credits. */\nexport interface BalanceAllowance {\n /** Credits the caller was granted. */\n granted: number\n /** Credits the caller has left of it. */\n remaining: number\n /**\n * Whether the deployment refuses a run beyond the allowance. `false` = the\n * allowance is shown, not enforced: gate a run on `remaining` only when true.\n */\n enforced: boolean\n}\n\n/**\n * The unit a `display` object is in. A deployment can show its own unit\n * instead of credits; its figures are then converted by the server, so a\n * client renders them as they are and never multiplies by a rate.\n */\nexport interface DisplayUnitInfo {\n /** The unit's label — what the deployment calls its credits. */\n unit: string\n /** Decimal places the converted figures carry (0–4). */\n decimals: number\n /**\n * The unit's word per interface language, when the deployment gives one per\n * language (locale id → word, e.g. `{ en: \"points\", he: \"נקודות\" }`). Show\n * `unitLabels[locale] ?? unit`; a language without an entry uses `unit`.\n * The server does not know the viewer's interface language, so it sends the\n * words and the client picks.\n */\n unitLabels?: Record<string, string>\n}\n\n/**\n * `UserBalance.display` — the balance's credit figures in the deployment's own\n * unit, converted by the server. `null` = the figure is unavailable (show an em\n * dash, never 0). The optional keys are present exactly when the raw\n * `allowance`, `externalWallet` and `welcomeOffer` are.\n */\nexport interface BalanceDisplay extends DisplayUnitInfo {\n total: number | null\n subscription: number | null\n topup: number | null\n dailySpent: number | null\n dailyLimit: number | null\n monthlyAllocation: number | null\n appCreditsAllowance: number | null\n allowance?: { granted: number | null; remaining: number | null } | null\n externalWallet?: { available: number | null }\n welcomeOffer?: { credits: number | null }\n}\n\n/** `ModelCostsResult.display` — each priced identifier's credits, in the deployment's own unit. */\nexport interface ModelCostsDisplay extends DisplayUnitInfo {\n /** The same identifiers as `data`, converted. An id in `estimates` is an estimate here too. */\n data: Record<string, number | null>\n}\n\n/** `ModelCostResult.display` — the one identifier's credits, in the deployment's own unit. */\nexport interface ModelCostDisplay extends DisplayUnitInfo {\n creditCost: number | null\n}\n\n/** Where an account's free signup grant stands. */\nexport type FreeGrantState = \"unclaimed\" | \"granted\" | \"withheld\" | \"revoked\"\n\n/** `UserBalance.welcomeOffer` — what an app needs to show the welcome offer. */\nexport interface WelcomeOfferState {\n /**\n * Open the welcome popup by itself now. Decided by the server: the grant is\n * unclaimed, \"Maybe later\" was never answered, and the popup has opened by\n * itself fewer than three times, none of them in the last 24 hours. When an\n * app opens it because this is true, it reports that with\n * `markWelcomeOfferSeen(\"shown\")`; an app should also not open it by itself\n * twice in one visit. Absent from a server released before this field,\n * which sends `popupSeen` alone: open it then while `popupSeen` is false\n * (`welcomeOffer.popupDue ?? welcomeOffer.popupSeen === false`).\n */\n popupDue?: boolean\n /**\n * `!popupDue`, kept for apps written before `popupDue`: they open the popup\n * while it is false. Read `popupDue` instead.\n */\n popupSeen: boolean\n /**\n * The account already has its credits (granted elsewhere) but still owes\n * the email consent: the web apps block creation until it is given — the\n * claim records it.\n */\n consentPending: boolean\n /**\n * The credits a claim grants. Name this figure in the offer; never hard-code\n * it. With `consentPending`, the credits the account WAS granted, which can\n * be more than a claim grants today (an earlier, larger grant is kept).\n */\n credits: number\n}\n\n/** What `claimWelcomeOffer` sends: the browser signals plus the app answering. */\nexport interface WelcomeOfferClaimInput extends SignupKeys {\n /**\n * The answering app's slug (lowercase letters, digits and `-`, up to 40\n * characters), recorded with the consent. A value outside that grammar is\n * stored as absent, never refused.\n */\n sourceApp?: string\n /**\n * The interface language the user answered in — the id of a language Nodaro\n * ships, such as `\"en\"`, `\"ja\"` or `\"pt-BR\"`. Matched exactly and\n * case-sensitively: `\"en-US\"` or `\"pt-br\"` is stored as absent, never refused.\n * Recorded with the consent as the language of the LATEST consent: a later\n * \"yes\" in another language replaces it.\n */\n locale?: string\n}\n\n/** The answer of `POST /v1/credits/welcome-offer/claim`. */\nexport interface WelcomeOfferClaimResult {\n /** The email consent is recorded. */\n consent: \"granted\"\n /** Where the free grant stands after the claim — `\"withheld\"` when the abuse gate refused it. */\n grant: FreeGrantState\n /**\n * The grant's figure. A grant tops the subscription credits UP TO it (it is\n * not added on top), so a claim that lands it leaves the subscription credits\n * at no less than this. For an account granted before the call, what it was\n * given, which can be more than a claim grants today.\n */\n credits: number\n}\n\n/**\n * What `markWelcomeOfferSeen` reports. `\"shown\"`: the popup opened by itself.\n * `\"later\"`: the user answered \"Maybe later\".\n */\nexport type WelcomeOfferSeenEvent = \"shown\" | \"later\"\n\n/** The answer of `POST /v1/credits/welcome-offer/seen`. */\nexport interface WelcomeOfferSeenResult {\n ok: true\n}\n\n/**\n * Result of `POST /v1/credits/model-costs` — a batch cost lookup for editor\n * cost previews. `data` maps each priced identifier → its credit cost.\n *\n * Per-model fault isolation (the route runs the lookups under\n * `Promise.allSettled`): identifiers with no pricing row are reported in\n * `missing` (undisplayable until an operator seeds a price) and lookup\n * failures in `errors`, instead of failing the whole batch. Callers typically\n * render `'—'` for any identifier that lands in `missing`. The hard-fail\n * policy still triggers at reservation time when the user actually runs the\n * node — this preview lookup is intentionally lenient.\n */\nexport interface ModelCostsResult {\n data: Record<string, number>\n missing: string[]\n errors: string[]\n /**\n * Why each identifier in `errors` has no price — today only\n * `llm_model_unpriced`: a metered LLM price key whose model has no rate on\n * the lane it would be served on (it cannot be run). Omitted when `errors`\n * is empty.\n */\n errorCodes?: Record<string, ModelCostError>\n /**\n * The identifiers in `data` whose figure is an ESTIMATE, not a fixed price:\n * metered LLM price keys (`llmPriceKey` from `@nodaro/shared/llm-models`,\n * `<feature>:<model>[:direct | :effort-<level>]`), charged on what the call actually uses.\n * Show these as `≈N`. Omitted when there are none, so a batch of fixed ids\n * answers exactly as it always has. A metered key that lands in `missing`\n * instead means the server is not pricing LLM calls per model — show no\n * price for it.\n */\n estimates?: string[]\n /**\n * The same prices in the deployment's own unit, converted by the server —\n * present only on a deployment that shows its own unit instead of credits.\n */\n display?: ModelCostsDisplay\n}\n\n/** {@link ModelCostsResult.errorCodes} — why an identifier has no price. */\nexport interface ModelCostError {\n /** Today only `llm_model_unpriced`; open to codes a newer server may add. */\n code: \"llm_model_unpriced\" | (string & {})\n /** A sentence to show the user. */\n message: string\n}\n\n/**\n * Result of `GET /v1/credits/model-cost?model=<id>` (`data`): the credits one\n * identifier is charged. `estimate: true` marks a metered LLM price key's\n * figure as an estimate (show it as `≈N`); such an answer is never cached.\n */\nexport interface ModelCostResult {\n model: string\n creditCost: number\n estimate?: true\n /** `creditCost` in the deployment's own unit, converted by the server — present only where one is configured. */\n display?: ModelCostDisplay\n}\n\n/**\n * The two browser signals a claim reports — SHA-256 hex digests computed by\n * `@nodaro/sdk/signup-signals` (`collectSignupKeys`). Either may be absent:\n * a browser that cannot be measured still claims, and the server treats the\n * absence as what it is. Any other value is stored as absent server-side.\n */\nexport interface SignupKeys {\n browserKey?: string\n deviceKey?: string\n}\n\n/** The answer of `POST /v1/credits/claim-signup-grant`. */\nexport interface SignupGrantClaimResult {\n /** Where the account's free grant stands after this call. */\n state: FreeGrantState\n /** True only when THIS call moved the credits — a repeat is `false` with the same state. */\n granted: boolean\n}\n\n/**\n * One row of `GET /v1/credits/transactions` — a run's reservation and how it\n * settled.\n *\n * Which amount to read: a run first HOLDS credits and is then settled — charged\n * all or part of the hold, the rest returned. `credits_charged` is what the run\n * cost (`null` while the hold is still open, `0` once refunded); sum it for\n * spend. `credits_reserved` is the hold, which never changes. `credits_used`\n * is the same hold under its original name, kept for existing integrations.\n */\nexport interface CreditTransaction {\n id: string\n /** ISO-8601. Also the paging cursor: pass the last row's value as `cursor`. */\n created_at: string\n /** Settled charge; `null` while `status` is `\"reserved\"`, `0` when refunded. */\n credits_charged: number | null\n /** The hold taken when the run was accepted. */\n credits_reserved: number | null\n /** The hold, under its original name. Prefer `credits_charged`. */\n credits_used: number | null\n /** The model or operation the credits were for. */\n action: string | null\n provider: string | null\n /** Reservation lifecycle: `\"reserved\"`, `\"committed\"` or `\"refunded\"`. */\n status: string | null\n /** The caller's own billing details for the run (model, which pool paid, …). */\n metadata: Record<string, unknown>\n /** `\"workspace\"` when a class or team budget paid, not your balance. */\n payer: \"user\" | \"workspace\"\n workspaceId: string | null\n}\n\n/** A page of {@link CreditTransaction}s, newest first. */\nexport interface CreditTransactionsPage {\n data: CreditTransaction[]\n /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n nextCursor: string | null\n}\n\nexport interface CreditTransactionsOptions {\n /** Rows per page, 1–50 (server default 20). */\n limit?: number\n /** The `nextCursor` of the previous page. */\n cursor?: string\n}\n\n/** How `credits.usageSummary()` groups the series over time. */\nexport type UsageSummaryBucket = \"day\" | \"week\" | \"month\"\n\nexport interface UsageSummaryOptions {\n /** An ISO-8601 timestamp, or a date alone (`\"2026-10-01\"`: that whole UTC day), inclusive; default the last 30 days up to now. A period of at most a year. */\n from?: string\n to?: string\n /** Default `\"day\"`. Buckets are UTC. */\n bucket?: UsageSummaryBucket\n}\n\nexport interface UsageSummaryTotals {\n /** Credits spent on runs in the period: each run's charge (a running hold counts; a refunded run does not). */\n used: number\n /** Credits bought: packs, loads, subscription grants. */\n purchased: number\n /** Credits granted free, net: sign-up and admin adjustments, a grant taken back subtracted. */\n granted: number\n /** Credits given back for a refunded run or by Stripe (a hold released when a run settled below it is not a refund). */\n refunded: number\n /** Runs that were charged or are still running. */\n runs: number\n /** `used / runs`, one decimal; 0 with no runs. */\n avgPerRun: number\n}\n\nexport interface UsageByModel {\n model: string\n provider: string | null\n credits: number\n runs: number\n /** Of `totals.used`, 0–1. */\n share: number\n}\n\nexport interface UsageByCategory {\n /** `\"image\"`, `\"video\"`, `\"audio\"` or `\"other\"`. */\n category: string\n credits: number\n runs: number\n}\n\nexport interface UsageOverTime {\n /** The bucket's first day in UTC (`\"2026-10-26\"`; a week by its Monday; a month as `\"2026-10\"`). The first bucket of a period may be a partial week or month. */\n bucket: string\n used: number\n purchased: number\n runs: number\n}\n\n/** The spend of one session or one workflow. */\nexport interface UsageByGroup {\n id: string\n /** The session's title or the workflow's name; `null` when it has none or is gone. */\n name: string | null\n /** The tool the session belongs to; `null` on a workflow. */\n tool: string | null\n credits: number\n runs: number\n /** The models used, by spend. */\n models: string[]\n /** ISO-8601: the latest run. */\n lastAt: string\n}\n\n/** The answer of `credits.usageSummary()`. */\nexport interface UsageSummary {\n period: { from: string; to: string; bucket: UsageSummaryBucket }\n totals: UsageSummaryTotals\n /** The model with the most spend; `null` with no runs. */\n mostUsed: UsageByModel | null\n /** By spend. */\n byModel: UsageByModel[]\n byCategory: UsageByCategory[]\n /** Every bucket of the period, empty ones included, oldest first. */\n overTime: UsageOverTime[]\n bySession: UsageByGroup[]\n byWorkflow: UsageByGroup[]\n /** A read hit the server's row cap: the figures under-report; narrow the period. */\n truncated: boolean\n /** A side read failed on the server (the jobs, or a session's or workflow's name): a grouping is missing or unnamed; the totals are whole. */\n partial: boolean\n}\n\n/** What a movement of the balance was; `app` is credits earned from, or paid for, a published app. */\nexport type CreditHistoryKind = \"usage\" | \"purchase\" | \"grant\" | \"refund\" | \"app\" | \"adjustment\" | \"expiry\"\n\n/** The job behind a usage row of {@link CreditHistoryEntry}. */\nexport interface CreditHistoryJob {\n id: string\n /** The node type that ran (`generate-image`, `image-to-video`, …); `null` when the job is gone. */\n type: string | null\n status: string | null\n startedAt: string | null\n completedAt: string | null\n /** From start to completion; `null` until it completes. */\n durationMs: number | null\n workflowId: string | null\n sessionId: string | null\n}\n\n/** One movement of the balance (`credits.history()`). */\nexport interface CreditHistoryEntry {\n id: string\n /** ISO-8601. Also the paging cursor. */\n at: string\n kind: CreditHistoryKind\n /** The ledger's own word: `usage`, `one_time_purchase`, `subscription_renewal`, `signup_grant`, `refund`, `admin_adjustment`, `expiry`, … */\n source: string\n /** The movement, signed: a run's hold negative, a purchase positive. */\n amount: number\n /** The balance right after this movement. */\n balanceAfter: number\n /** Which pool moved; `\"mixed\"` when both did. */\n pool: \"subscription\" | \"topup\" | \"mixed\"\n description: string | null\n /** The model that ran, on a row with a job; `null` otherwise. */\n model: string | null\n provider: string | null\n /**\n * The job's charge, on its reserve row only (the hold taken when the run\n * was accepted): the settled charge, the hold while the run is open, `0`\n * once refunded. `null` on every other row — a refund, a metered overrun\n * line, a purchase — so summing it over a list counts each job once. Read\n * this for spend, not `amount`.\n */\n charge: number | null\n /** The run's credit status (`\"reserved\"`, `\"committed\"` or `\"refunded\"`), beside `charge`; `null` elsewhere. */\n status: string | null\n /** On a row with a job; `type` and the rest `null` when the job is gone or not the person's. */\n job: CreditHistoryJob | null\n /** Stripe's hosted receipt, on a purchase that has one. */\n receiptUrl: string | null\n}\n\n/** A page of {@link CreditHistoryEntry}, newest first. */\nexport interface CreditHistoryPage {\n data: CreditHistoryEntry[]\n /** Pass as `cursor` for the next page; `null` when there are no more rows. */\n nextCursor: string | null\n}\n\n/** What narrows the history. */\nexport interface CreditHistoryFilters {\n kind?: CreditHistoryKind\n /** A model identifier: only runs of that model. */\n model?: string\n /** ISO-8601 bounds on `at`, inclusive. */\n from?: string\n to?: string\n /** Words looked for in the description, case-insensitively. */\n q?: string\n}\n\nexport interface CreditHistoryOptions extends CreditHistoryFilters {\n /** Rows per page, 1–100 (server default 50). */\n limit?: number\n /** The `nextCursor` of the previous page, as given (opaque; another string is refused with 400). */\n cursor?: string\n}\n\n/** Max identifiers per `model-costs` batch — the route caps the request at 50. */\nconst MODEL_COSTS_LIMIT = 50\n\nexport class CreditsResource {\n constructor(private client: NodaroClientCore) {}\n\n /**\n * `GET /v1/user/credits` → the authenticated user's credit balance and tier\n * info. Throws `UnauthorizedError` (401) when signed out, and the SDK's\n * other typed errors on the usual statuses.\n */\n async balance(): Promise<UserBalance> {\n const res = await this.client.request<{ data: UserBalance }>(\n \"GET\",\n \"/v1/user/credits\",\n )\n return res.data\n }\n\n /**\n * `GET /v1/credits/transactions` → one page of the caller's credit\n * transactions, newest first, with `nextCursor` for the next page (`null`\n * at the end). Read `credits_charged` for what each run cost — it can be\n * below the hold (`credits_reserved`) and is `null` while the hold is open.\n * Cloud-only route: a self-hosted instance answers 404.\n */\n transactions(options: CreditTransactionsOptions = {}): Promise<CreditTransactionsPage> {\n return this.client.request<CreditTransactionsPage>(\"GET\", \"/v1/credits/transactions\", {\n query: { limit: options.limit, cursor: options.cursor },\n })\n }\n\n /**\n * `GET /v1/credits/usage-summary` → the period's credit usage summed the\n * way a billing screen draws it: totals, the spend by model and by\n * category, a series over time (`bucket`: day, week or month, no holes),\n * and the spend by session and by workflow. The last 30 days unless\n * `from` / `to` say otherwise; a period of at most a year (400 beyond).\n * Cloud-only route: a self-hosted instance answers 404.\n */\n async usageSummary(options: UsageSummaryOptions = {}): Promise<UsageSummary> {\n const res = await this.client.request<{ data: UsageSummary }>(\"GET\", \"/v1/credits/usage-summary\", {\n query: { from: options.from, to: options.to, bucket: options.bucket },\n })\n return res.data\n }\n\n /**\n * `GET /v1/credits/history` → one page of every movement of the balance,\n * newest first — runs, purchases, grants, refunds, adjustments, expiries —\n * each with the balance after it; a job's reserve row carries its model,\n * its `charge` (the settled charge, the hold while the run is open, `0`\n * once refunded — read that for spend, not `amount`) and its job. Filter by\n * `kind`, `model`, `from` / `to` and `q`; pass the page's `nextCursor` (an\n * opaque string) as `cursor` for the next page (`null` at the end).\n * Cloud-only route: a self-hosted instance answers 404.\n */\n history(options: CreditHistoryOptions = {}): Promise<CreditHistoryPage> {\n const { limit, cursor, ...filters } = options\n return this.client.request<CreditHistoryPage>(\"GET\", \"/v1/credits/history\", {\n query: { limit, cursor, ...filters },\n })\n }\n\n /**\n * `GET /v1/credits/history?format=csv` → the whole filtered history as a\n * CSV file (the same fields as {@link history}, one line per movement,\n * newest first), at most 5,000 rows — the last line says when it was cut.\n * Hand the text to the person as `credit-history.csv`.\n */\n exportHistory(filters: CreditHistoryFilters = {}): Promise<string> {\n return this.client.requestText(\"GET\", \"/v1/credits/history\", {\n query: { ...filters, format: \"csv\" },\n })\n }\n\n /**\n * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor\n * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers\n * (the route's request limit). Preserves the `{ data, missing, errors }`\n * fault-isolation shape verbatim, plus `estimates` / `errorCodes` when a\n * metered LLM price key was asked (see {@link ModelCostsResult}).\n */\n modelCosts(ids: string[]): Promise<ModelCostsResult> {\n return this.client.request<ModelCostsResult>(\"POST\", \"/v1/credits/model-costs\", {\n body: { models: ids.slice(0, MODEL_COSTS_LIMIT) },\n })\n }\n\n /**\n * `POST /v1/credits/claim-signup-grant` → claims the account's free signup\n * grant, once, with the browser signals of the page making the claim.\n *\n * Call it once per page load as soon as the session is known, and never\n * wait on it for rendering: it is idempotent (a decided account answers\n * with its state and `granted: false`), it costs the user nothing when it\n * fails (the next load asks again), and the signals are what make the\n * claim worth sending — collect them with `collectSignupKeys()` from\n * `@nodaro/sdk/signup-signals` and pass whatever came back, `{}` included.\n * Cloud-only route: a self-hosted instance answers 404.\n */\n claimSignupGrant(keys: SignupKeys = {}): Promise<SignupGrantClaimResult> {\n return this.client.request<SignupGrantClaimResult>(\"POST\", \"/v1/credits/claim-signup-grant\", {\n body: keys,\n })\n }\n\n /**\n * `POST /v1/credits/welcome-offer/claim` → the user's \"yes\" to the welcome\n * offer, as ONE server action: the marketing-email consent is recorded,\n * then the free signup grant is claimed with that consent. The abuse gate\n * still decides — consent is necessary, not sufficient — so read `grant`:\n * `\"granted\"` (the grant has landed: this call topped the subscription credits up to `credits` — not added on top — or it had landed before), `\"withheld\"` (refused), `\"revoked\"` (taken back earlier; nothing moves), `\"unclaimed\"` (nothing moved — treat as a failure and let the user retry).\n * Pass the browser signals from `collectSignupKeys()` and your app's slug.\n *\n * **Browser session only.** Usable from a first-party web app signed in\n * with a Supabase session (the consent is a person's choice in a browser);\n * an API key or OAuth app token is refused with 403. 409\n * `welcome_offer_disabled` while the deployment has the offer off — show\n * it only when `balance().welcomeOffer` is present. Cloud-only route: a\n * self-hosted instance answers 404.\n */\n claimWelcomeOffer(input: WelcomeOfferClaimInput = {}): Promise<WelcomeOfferClaimResult> {\n return this.client.request<WelcomeOfferClaimResult>(\"POST\", \"/v1/credits/welcome-offer/claim\", {\n body: input,\n })\n }\n\n /**\n * `POST /v1/credits/welcome-offer/seen` → tells the server what happened to\n * the welcome popup, which decides `balance().welcomeOffer.popupDue` from it\n * on every app:\n *\n * - `\"shown\"`: the popup opened by itself (because `popupDue` was true).\n * Counts one of the account's three showings while the popup is due;\n * nothing is counted otherwise (a second call within 24 hours, after\n * \"Maybe later\", after the third), so a repeated call is harmless.\n * - `\"later\"`: the user answered \"Maybe later\". The popup does not open by\n * itself again.\n *\n * A close without an answer (the ×, Escape, a click outside) is reported by\n * not calling this at all. Called with no event, it sends no body, and the\n * server reads that as `\"later\"` (what apps written before the event sent on\n * any close). Both writes are idempotent; a failed call only means the\n * popup may show once more, so callers usually ignore errors.\n *\n * **Browser session only**, like {@link claimWelcomeOffer}: 403 for an API\n * key or OAuth app token, 409 `welcome_offer_disabled` while the offer is\n * off, 404 on a self-hosted instance.\n */\n markWelcomeOfferSeen(event?: WelcomeOfferSeenEvent): Promise<WelcomeOfferSeenResult> {\n return this.client.request<WelcomeOfferSeenResult>(\n \"POST\",\n \"/v1/credits/welcome-offer/seen\",\n event === undefined ? {} : { body: { event } },\n )\n }\n\n // NOTE: no `estimate(...)` helper. The backend exposes\n // `POST /v1/credits/estimate-workflow` (body `{ nodes }` → `{ data: {\n // totalCredits, nodeCount, estimate?: true } }` — `estimate` when a metered\n // LLM node's estimate is in the total), but no consumer has a settled shape for it\n // yet (studio pre-checks `balance >= Σ modelCosts` client-side rather than\n // calling an estimate endpoint). Adding it now would be inventing an API\n // surface ahead of a real caller, so it's deliberately omitted — add it when\n // a consumer needs it, shaped to that need.\n}\n"]}
@@ -3,34 +3,34 @@
3
3
  var models = require('@nodaro/shared/models');
4
4
 
5
5
  // src/resources/cast-swap.ts
6
- var CastSwapResource = class {
6
+ var VideoRemakeResource = class {
7
7
  constructor(client) {
8
8
  this.client = client;
9
9
  }
10
10
  client;
11
11
  /**
12
- * Start a Nodaro Motion run (`POST /v1/cast-swap`, 202 `{ jobId }`). Returns the
12
+ * Start a Video Remake run (`POST /v1/video-remake`, 202 `{ jobId }`). Returns the
13
13
  * job to follow. With `options.idempotencyKey` (sent as the
14
14
  * `Idempotency-Key` header; 8–200 characters, else 400) a repeat with the
15
15
  * same key within about 10 s answers 200 `{ jobId, deduped: true }`, a later
16
16
  * one 202 with the first run's `jobId`; nothing new starts.
17
17
  */
18
18
  run(params, options) {
19
- return this.client.request("POST", "/v1/cast-swap", {
19
+ return this.client.request("POST", "/v1/video-remake", {
20
20
  body: params,
21
21
  ...options?.idempotencyKey ? { headers: { "Idempotency-Key": options.idempotencyKey } } : {}
22
22
  });
23
23
  }
24
24
  /**
25
25
  * Whether people choose a direct run's style, per engine
26
- * (`GET /v1/cast-swap/style-choice`): `"user"` = show a Style control;
26
+ * (`GET /v1/video-remake/style-choice`): `"user"` = show a Style control;
27
27
  * `"precise"` = Nodaro's own apps run Precise on that engine and hide the
28
28
  * control, while a run's `style` is still taken as sent; `"flex"` = an admin
29
29
  * forced Flex for the engine, so a run's `style` is overridden and the
30
30
  * control is best hidden. Its
31
31
  * `styleOnly` says, per engine, whether a Flex run with an art style and
32
32
  * nothing to swap restyles the whole clip there. Where it is not `true`
33
- * (absent, or an engine missing from it, included) on Nodaro Motion Prism, an
33
+ * (absent, or an engine missing from it, included) on Nodaro Prism, an
34
34
  * art style alone is refused, and one with a pre or post prompt runs as any
35
35
  * other art-style run. Its `preciseArtStyle` says, per engine, whether a
36
36
  * Precise run takes an art style there too, and its `preciseArtStyleAlone`
@@ -38,43 +38,45 @@ var CastSwapResource = class {
38
38
  * Public (no sign-in needed); the answer may be up to a minute old.
39
39
  */
40
40
  styleChoice() {
41
- return this.client.request("GET", "/v1/cast-swap/style-choice");
41
+ return this.client.request("GET", "/v1/video-remake/style-choice");
42
42
  }
43
- /** Quote a run before starting it (`POST /v1/cast-swap/estimate`); spends nothing. */
43
+ /** Quote a run before starting it (`POST /v1/video-remake/estimate`); spends nothing. */
44
44
  async estimate(params) {
45
- const quote = await this.client.request("POST", "/v1/cast-swap/estimate", { body: params });
45
+ const quote = await this.client.request("POST", "/v1/video-remake/estimate", { body: params });
46
46
  const engine = models.nodaroMotionEngineFrom(quote?.engine);
47
47
  return engine && engine !== quote.engine ? { ...quote, engine } : quote;
48
48
  }
49
49
  /**
50
50
  * Quote finishing a run at Full Quality (`POST
51
- * /v1/cast-swap/:jobId/full-quality/estimate`); spends nothing. `jobId` is a
52
- * finished Nodaro Motion Prism DRAFT run (a Nodaro Motion or trend run made
51
+ * /v1/video-remake/:jobId/full-quality/estimate`); spends nothing. `jobId` is a
52
+ * finished Nodaro Prism DRAFT run (a Video Remake or trend run made
53
53
  * with `draft: true`), whose same take Full Quality finishes at 1080p. The
54
54
  * quote does not look for a Full Quality already running: when one is,
55
55
  * {@link fullQuality} answers it (`existing: true`) and charges nothing.
56
- * Refusals: {@link CastSwapFullQualityRefusalCode}.
56
+ * Refusals: {@link VideoRemakeFullQualityRefusalCode}.
57
57
  */
58
58
  fullQualityEstimate(jobId) {
59
- return this.client.request("POST", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality/estimate`, { body: {} });
59
+ return this.client.request("POST", `/v1/video-remake/${encodeURIComponent(jobId)}/full-quality/estimate`, { body: {} });
60
60
  }
61
61
  /**
62
- * Finish a run at Full Quality (`POST /v1/cast-swap/:jobId/full-quality`):
62
+ * Finish a run at Full Quality (`POST /v1/video-remake/:jobId/full-quality`):
63
63
  * at 1080p, with the clip's audio, as a new job linked to the run — a
64
- * Nodaro Motion Prism draft's own take re-rendered. SPENDS CREDITS: quote it first with
64
+ * Nodaro Prism draft's own take re-rendered. SPENDS CREDITS: quote it first with
65
65
  * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200
66
66
  * `{ jobId, existing: true }` when this run's Full Quality is already
67
67
  * running or done (one per run; a failed one may be asked again). Follow
68
68
  * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the
69
69
  * server keys the job by the draft. The new job keeps the draft's origin.
70
- * Refusals: {@link CastSwapFullQualityRefusalCode}.
70
+ * Refusals: {@link VideoRemakeFullQualityRefusalCode}.
71
71
  */
72
72
  fullQuality(jobId, params = {}) {
73
73
  const body = params.sessionId !== void 0 ? { sessionId: params.sessionId } : {};
74
- return this.client.request("POST", `/v1/cast-swap/${encodeURIComponent(jobId)}/full-quality`, { body });
74
+ return this.client.request("POST", `/v1/video-remake/${encodeURIComponent(jobId)}/full-quality`, { body });
75
75
  }
76
76
  };
77
+ var CastSwapResource = VideoRemakeResource;
77
78
 
78
79
  exports.CastSwapResource = CastSwapResource;
79
- //# sourceMappingURL=chunk-GU3YOOCK.cjs.map
80
- //# sourceMappingURL=chunk-GU3YOOCK.cjs.map
80
+ exports.VideoRemakeResource = VideoRemakeResource;
81
+ //# sourceMappingURL=chunk-IO7NEEZZ.cjs.map
82
+ //# sourceMappingURL=chunk-IO7NEEZZ.cjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../src/resources/cast-swap.ts"],"names":["nodaroMotionEngineFrom"],"mappings":";;;;;AA6lBO,IAAM,sBAAN,MAA0B;AAAA,EAC/B,YAAoB,MAAA,EAA0B;AAA1B,IAAA,IAAA,CAAA,MAAA,GAAA,MAAA;AAAA,EAA2B;AAAA,EAA3B,MAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASpB,GAAA,CAAI,QAA2B,OAAA,EAAgF;AAC7G,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,kBAAA,EAAoB;AAAA,MACrD,IAAA,EAAM,MAAA;AAAA,MACN,GAAI,OAAA,EAAS,cAAA,GAAiB,EAAE,OAAA,EAAS,EAAE,iBAAA,EAAmB,OAAA,CAAQ,cAAA,EAAe,EAAE,GAAI;AAAC,KAC7F,CAAA;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAkBA,WAAA,GAA+C;AAC7C,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,KAAA,EAAO,+BAA+B,CAAA;AAAA,EACnE;AAAA;AAAA,EAGA,MAAM,SAAS,MAAA,EAAyD;AACtE,IAAA,MAAM,KAAA,GAAQ,MAAM,IAAA,CAAK,MAAA,CAAO,OAAA,CAA6B,QAAQ,2BAAA,EAA6B,EAAE,IAAA,EAAM,MAAA,EAAQ,CAAA;AAElH,IAAA,MAAM,MAAA,GAASA,6BAAA,CAAuB,KAAA,EAAO,MAAM,CAAA;AACnD,IAAA,OAAO,MAAA,IAAU,WAAW,KAAA,CAAM,MAAA,GAAS,EAAE,GAAG,KAAA,EAAO,QAAO,GAAI,KAAA;AAAA,EACpE;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,oBAAoB,KAAA,EAAwD;AAC1E,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,iBAAA,EAAoB,kBAAA,CAAmB,KAAK,CAAC,CAAA,sBAAA,CAAA,EAA0B,EAAE,IAAA,EAAM,IAAI,CAAA;AAAA,EACxH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAaA,WAAA,CAAY,KAAA,EAAe,MAAA,GAAuC,EAAC,EAA0C;AAC3G,IAAA,MAAM,IAAA,GAAO,OAAO,SAAA,KAAc,MAAA,GAAY,EAAE,SAAA,EAAW,MAAA,CAAO,SAAA,EAAU,GAAI,EAAC;AACjF,IAAA,OAAO,IAAA,CAAK,MAAA,CAAO,OAAA,CAAQ,MAAA,EAAQ,CAAA,iBAAA,EAAoB,kBAAA,CAAmB,KAAK,CAAC,CAAA,aAAA,CAAA,EAAiB,EAAE,IAAA,EAAM,CAAA;AAAA,EAC3G;AACF;AASO,IAAM,gBAAA,GAAmB","file":"chunk-IO7NEEZZ.cjs","sourcesContent":["import { nodaroMotionEngineFrom } from \"@nodaro/shared/models\"\nimport type { NodaroClientCore } from \"../core.js\"\n\n/**\n * Video Remake (the `videoRemake` resource; routes `/v1/video-remake`) — replace\n * the people, pets, products and/or the location in a short video with your\n * own references, keeping its motion, framing, timing and sound (the clip's\n * audio is kept, and the result is the clip's length).\n *\n * Before the video, each person, pet and product role's photos are turned\n * into one clean reference picture by an image model. This costs extra\n * credits (`breakdown.references` in the estimate), charged when it runs, even\n * if the video then fails; it adds about a minute, falls back to your own\n * photos if it fails, and is turned off with `prepareReferences: false`.\n * Locations are not prepared.\n *\n * Engines: a run is made on Nodaro Prism (`engine` left out, or\n * `\"nodaro-prism\"`) or Nodaro Pulse (`\"nodaro-pulse\"`). Prism renders\n * 480p (the default; plain unless `draft: true`), 720p or 1080p. Pulse renders\n * 720p (its default) or 1080p and makes a new take guided by the clip and\n * pictures; it has no draft, so no Full Quality: run it again at 1080p instead.\n *\n * How the clip is prepared for the video model (for one, whether faces are\n * hidden first, and whether a refused clip is retried) is set by Nodaro for\n * each engine; a run cannot change it. `faceMasking` is no longer read\n * (deprecated: accepted and ignored).\n *\n * Cloud edition only: `/v1/video-remake` is served by the cloud plugin and 404s\n * on self-hosted installs. `run()` answers 202 with a job id; follow it with\n * `client.jobs.get(jobId)` / `client.jobs.getStatus(jobId)` like any other job.\n *\n * Repeats: pass `{ idempotencyKey }` to `run()` and it is sent as the\n * `Idempotency-Key` header. A repeat with the same key within the credit\n * guard's dedup window (about 10 s) answers 200 `{ jobId, deduped: true }` with\n * an `X-Dedup-Hit` header; a later one answers 202 with the first run's\n * `jobId`. Nothing new is started or charged.\n *\n * Refusals (thrown as a `NodaroError` subclass; body `{ error: { code, message } }`), before\n * anything is charged: 400 `validation_error` (the body: no role with images,\n * no reference, no `prePrompt` or `postPrompt` and no art style (Flex on\n * Nodaro Prism), more roles of a kind\n * than allowed, more than 30 images in all, `draft: true` above 480p, a\n * `prePrompt` or `postPrompt` over 4,000 characters); on Nodaro Pulse,\n * `draft_unsupported` (`draft: true`), `resolution_unsupported` (480p),\n * `output_format_unsupported` (a MOV edit output) and `too_many_images` (more\n * than 10 images in the run, across every role and fixed reference);\n * `raw_reference_token` (also in a reference's `line`),\n * `invalid_role_mention` (also any `{role:N}` in a reference's `line`),\n * `unsafe_url`, `video_unreadable`, `clip_out_of_range` (4–30 s),\n * `preview_out_of_range`, `unnamed_role_needs_picture` (a role with no name\n * and no image), `no_roles_in_preview` (a preview that would change nothing,\n * judged on what it sends: no role kept in it with images, no fixed\n * reference, no `prePrompt` or `postPrompt` and no art style), `prompt_too_long`\n * (the prompt would build too long: a `{role:N}` reads as the role's name when\n * it sends no images; Nodaro Pulse's cap is 8,000 characters); 401; 402 `insufficient_credits` (`run()` only); 404\n * (a `sessionId` you may not use, `run()` only); 422 `job_blocked` (`run()`\n * only); 503 `host_too_old` (both); 503 `estimate_unavailable` (`estimate()`\n * only).\n */\n\n/**\n * The engine a Video Remake run is made on, by its public id. Left out =\n * `\"nodaro-prism\"`.\n *\n * - `\"nodaro-prism\"` (Nodaro Prism): 480p (the default; plain unless\n * `draft: true`), 720p or 1080p; Full Quality finishes a draft's own take at\n * 1080p.\n * - `\"nodaro-pulse\"` (Nodaro Pulse): 720p (the default) or 1080p, never a\n * draft (`draft: true` answers 400 `draft_unsupported`), so no Full Quality:\n * run it again at 1080p instead. A preview is still 4 s from `previewStart`.\n */\nexport type VideoRemakeEngine = \"nodaro-prism\" | \"nodaro-pulse\"\n\n/**\n * The engine ids an older client sent: the earlier public ids\n * (`\"motion-prism\"` and `\"motion-pro\"` = `\"nodaro-prism\"`, `\"motion-pulse\"`\n * and `\"motion-lite\"` = `\"nodaro-pulse\"`) and the internal ones\n * (`\"seedance-2-5\"`, `\"kling-4\"`). Still accepted in a request; never\n * returned.\n * @deprecated use {@link VideoRemakeEngine}.\n */\nexport type VideoRemakeEngineLegacyId = \"motion-prism\" | \"motion-pulse\" | \"motion-pro\" | \"motion-lite\" | \"seedance-2-5\" | \"kling-4\"\n\n/**\n * How a run follows its clip. Left out = `\"precise\"`.\n *\n * - `\"precise\"`: follows the clip exactly.\n * - `\"motion\"`: follows the clip's movement and takes the looks from your\n * photos, more freely than `\"precise\"`. Its price may differ from\n * `\"precise\"`'s: the estimate shows the exact price.\n */\nexport type VideoRemakeStyle = \"precise\" | \"motion\"\n\n/**\n * Where a Nodaro Pulse run cuts the clip to whole seconds (Pulse renders\n * whole seconds; asked for more than the clip, it would stretch the motion):\n * - `\"cut-end\"` (the default): drop the fraction of a second at its end;\n * - `\"cut-start\"`: drop it at its start.\n */\nexport type VideoRemakeMotionLength = \"cut-end\" | \"cut-start\"\n\n\n/** Whether a swapped subject takes this trait from the references (`\"new\"`) or keeps the video's (`\"original\"`). */\nexport type VideoRemakeTraitSource = \"new\" | \"original\"\n\n/**\n * Preview-only settings, on every role kind; a full run (`preview` not `true`)\n * ignores both.\n */\nexport interface VideoRemakeRolePreviewSettings {\n /** The name used instead of `name` in a preview. Same rules as `name` (1–200 characters). */\n previewName?: string\n /**\n * `false` leaves this role out of the preview: its reference images are not\n * sent, not prepared and not charged, and a `{role:N}` naming it reads as its\n * `previewName`, else its `name`. Default `true`. A preview that would\n * change nothing (no role kept in it with images, no fixed reference, no pre\n * or post prompt and no art style) answers 400 `no_roles_in_preview`.\n */\n inPreview?: boolean\n}\n\n/** A person in the video to recast. */\nexport interface VideoRemakePersonRole extends VideoRemakeRolePreviewSettings {\n kind: \"person\"\n /** How the person is told apart in the video, e.g. `\"the woman that attacks\"`.\n *\n * Direct runs only: omit it (or leave it empty) and the role is named by its\n * first picture — matched to the subject in the video it fits best; such a\n * role needs at least one image (else 400 `unnamed_role_needs_picture`). A\n * trend run's roles are always named (400 `role_name_required`).\n */\n name?: string\n /** 0–3 images of ONE person. Empty or `null` keeps the original person. */\n images: string[] | null\n /** Body from the references or the video. Default `\"new\"`. */\n body?: VideoRemakeTraitSource\n /** Outfit from the references or the video. Default `\"new\"`. */\n outfit?: VideoRemakeTraitSource\n /** Hairstyle and haircut from the references or the video. Default `\"new\"`. */\n hair?: VideoRemakeTraitSource\n}\n\n/** The place the video happens in. */\nexport interface VideoRemakeLocationRole extends VideoRemakeRolePreviewSettings {\n kind: \"location\"\n /** How the place is named. Default `\"the setting\"`. */\n name?: string\n /** 0–3 images of ONE place. Empty or `null` keeps the original place. */\n images: string[] | null\n}\n\n/** An animal in the video to recast. */\nexport interface VideoRemakePetRole extends VideoRemakeRolePreviewSettings {\n kind: \"pet\"\n /** How the animal is told apart in the video, e.g. `\"the dog\"`.\n *\n * Direct runs only: omit it (or leave it empty) and the role is named by its\n * first picture — matched to the subject in the video it fits best; such a\n * role needs at least one image (else 400 `unnamed_role_needs_picture`). A\n * trend run's roles are always named (400 `role_name_required`).\n */\n name?: string\n /** 0–3 images of ONE animal. Empty or `null` keeps the original animal. */\n images: string[] | null\n /** Body (shape, size and build) from the references or the video. Default `\"new\"`. */\n body?: VideoRemakeTraitSource\n /** Coat (fur, colors and markings) from the references or the video. Default `\"new\"`. */\n coat?: VideoRemakeTraitSource\n}\n\n/** An object in the video to recast. */\nexport interface VideoRemakeProductRole extends VideoRemakeRolePreviewSettings {\n kind: \"product\"\n /** How the object is told apart in the video, e.g. `\"the can\"`.\n *\n * Direct runs only: omit it (or leave it empty) and the role is named by its\n * first picture — matched to the subject in the video it fits best; such a\n * role needs at least one image (else 400 `unnamed_role_needs_picture`). A\n * trend run's roles are always named (400 `role_name_required`).\n */\n name?: string\n /** 0–3 images of ONE product. Empty or `null` keeps the original object. */\n images: string[] | null\n /** Shape and proportions from the references or the video. Default `\"new\"`. */\n shape?: VideoRemakeTraitSource\n /** Finish (colors, materials, label and markings) from the references or the video. Default `\"new\"`. */\n finish?: VideoRemakeTraitSource\n}\n\nexport type VideoRemakeRole = VideoRemakePersonRole | VideoRemakeLocationRole | VideoRemakePetRole | VideoRemakeProductRole\n\n/**\n * A fixed reference: 1–3 images of ONE thing that no role replaces, and the\n * line that says what it is (`\"the glass she drinks from\"`). Sent as given,\n * never prepared; its images count toward the 30.\n */\nexport interface VideoRemakeReference {\n /** 1–3 http(s) image URLs of one thing. */\n images: string[]\n /**\n * What it is, 1–500 characters. `{image}` in the line stands for this\n * reference's first image (`\"Use {image} for the sky\"`); a line without it\n * gets it appended. A `{role:N}` or a raw `{image:` / `{video:` / `{audio:`\n * token answers 400.\n */\n line: string\n}\n\n/**\n * @deprecated Nodaro sets this per engine; a run's `faceMasking` is ignored.\n */\nexport interface VideoRemakeFaceMaskingZone {\n leftPct?: number\n rightPct?: number\n topPct?: number\n bottomPct?: number\n}\n\n/**\n * @deprecated Nodaro sets how the clip is prepared for the video model, per\n * engine; a run cannot change it. A `faceMasking` sent is accepted and\n * ignored (no error), so older code keeps working unchanged.\n */\nexport interface VideoRemakeFaceMasking {\n mode: \"off\" | \"always\" | \"auto\"\n fill?: \"blur\" | \"depth\"\n minFaceHeightPct?: number\n maxFaceHeightPct?: number\n zone?: VideoRemakeFaceMaskingZone | null\n blurStrengthPct?: number\n threshold?: number\n}\n\n/** The body of `POST /v1/video-remake` and `POST /v1/video-remake/estimate`. */\nexport interface VideoRemakeParams {\n /** The source clip, 4–30 seconds. */\n videoUrl: string\n /**\n * Who and what to swap: at most 6 person roles, 1 location role, 3 pet roles\n * and 3 product roles, with at most 30 images in all. A role with no images\n * is skipped (that subject or place stays as in the video). At least one role\n * with images, a fixed reference, a `prePrompt` or `postPrompt`, or an art\n * style (`direction`, Flex on Nodaro Prism) is required. With an art\n * style and nothing to swap, a run restyles the whole clip (see `direction`).\n */\n roles: VideoRemakeRole[]\n /**\n * Fixed references (at most 5): things the video should show that no role\n * replaces, each with the line that names it. Their images count toward the\n * 30. A reference alone is enough for a run (no role needs images).\n */\n references?: VideoRemakeReference[]\n /**\n * Your own words placed at the start of the prompt, before the role\n * instructions; at most 4,000 characters. Mention a role as `{role:N}`, as in\n * `postPrompt`; the same 400 refusals apply (an N outside 1..`roles.length`,\n * a raw `{image:` / `{video:` / `{audio:` token).\n */\n prePrompt?: string\n /**\n * Extra instructions in your own words, at most 4,000 characters. Mention a\n * role as `{role:N}`, where N is its 1-based position in `roles`\n * (`{role:1}` is `roles[0]`; empty roles count).\n *\n * The route answers 400, before charging, for an N outside 1..`roles.length`,\n * for a raw `{image:` / `{video:` / `{audio:` token in the pre or post prompt\n * or a role's `name`, for a clip outside 4–30 s, and for a preview past the clip's\n * end (`previewStart + 4` > its length).\n */\n postPrompt?: string\n /** `true` runs on 4 seconds of the clip, starting at `previewStart`: a cheap check of the roles and choices. */\n preview?: boolean\n /** Where the preview starts, in seconds. Default 0. */\n previewStart?: number\n /**\n * The engine (see {@link VideoRemakeEngine}). Default `\"nodaro-prism\"`. The job\n * records it in `input_data.engine`, and a completed job's output in its\n * `engine`. The ids an older client sent ({@link VideoRemakeEngineLegacyId})\n * are still accepted.\n */\n engine?: VideoRemakeEngine | VideoRemakeEngineLegacyId\n /**\n * How the run follows the clip (see {@link VideoRemakeStyle}). Default\n * `\"precise\"`; the job records it in `input_data.style`.\n */\n style?: VideoRemakeStyle\n /**\n * A direct run on Nodaro Prism: an art style that restyles the whole\n * video, as a `direction.style` id of the platform's `style` picker catalog\n * (the same ids an image's `direction.style` takes); the platform words it.\n * A Flex run (`style: \"motion\"`) takes one, and so does a Precise run where\n * {@link VideoRemakeResource.styleChoice} answers `preciseArtStyle` true for the\n * engine. Nodaro may make such a Precise request the way a Flex run is made\n * (its engine does by default, unless Nodaro turns that off): its estimate,\n * price and Full Quality are then a Flex run's, while the job still records\n * the style sent (`input_data.style` absent, or `\"precise\"`; jobs made so\n * before the style was kept record `\"motion\"`). Otherwise it is Precise's edit\n * of the clip, drawn in the art style. Refused with\n * 400 `unknown_art_style` (not in the catalog), `art_style_not_supported` (a\n * saved moodboard, `moodboard:…`) or `art_style_needs_flex` (a trend run, a\n * Flex run whose prompt is made Precise by Nodaro's setting for how Flex\n * runs are prepared, or a Precise request on an engine from before Precise\n * runs took one), and on Nodaro Pulse with `art_style_needs_prism`.\n * The estimate (sent with the same `direction`) shows the price: it changes\n * only where Nodaro's setting for such runs first redraws the role pictures\n * in the art style.\n *\n * Style only: with no role with images and no fixed reference, the art style\n * alone is the run's change (a pre or post prompt is still added). It\n * restyles the whole clip, keeping the people, places, motion and sound, and\n * is charged for what it runs (the estimate shows it; no clip-preparation\n * `privacy` part). By default a black-and-white art style comes out\n * monochrome. Nodaro may run it the way other art-style runs run instead,\n * priced as those are and not made monochrome.\n * A preview takes its full run's path. Runs this way only on a Flex run, and\n * only where {@link VideoRemakeResource.styleChoice} answers `styleOnly` true\n * for the engine; elsewhere on Nodaro Prism an art style alone is\n * refused (on a Precise run that stays Precise too, unless\n * {@link VideoRemakeResource.styleChoice} answers `preciseArtStyleAlone` true for\n * the engine, where it is that run's change), and one with a pre or post prompt\n * runs as any other art-style run. The job records it in\n * `input_data.direction`.\n */\n direction?: { style: string }\n /**\n * Nodaro Pulse only (Prism ignores it): which end of the clip is cut to\n * whole seconds (see {@link VideoRemakeMotionLength}). Default `\"cut-end\"`.\n */\n motionLength?: VideoRemakeMotionLength\n /** @deprecated use {@link motionLength} (still accepted). */\n klingLength?: VideoRemakeMotionLength\n /**\n * The output resolution. Nodaro Prism: `\"480p\"` (default), `\"720p\"` or\n * `\"1080p\"`. Nodaro Pulse: `\"720p\"` (default) or `\"1080p\"`; `\"480p\"`\n * answers 400.\n */\n resolution?: \"480p\" | \"720p\" | \"1080p\"\n /**\n * `true` makes a draft: a 480p run whose same take Full Quality can finish\n * at 1080p (Nodaro Prism only). Default `false`: a plain run, at 480p\n * too, which Full Quality cannot finish. `true` with `\"720p\"` or `\"1080p\"`\n * answers 400 (draft is 480p only). Nodaro Pulse has no draft: `true`\n * answers 400 `draft_unsupported`.\n */\n draft?: boolean\n /**\n * Turn each person, pet and product role's photos into one clean reference\n * picture before the video (extra credits, shown in `breakdown.references`;\n * about a minute longer; falls back to your own photos if it fails).\n * Default `true`.\n */\n prepareReferences?: boolean\n /**\n * Ignored: Nodaro sets how the clip is prepared, per engine. Accepted (no\n * error) so older code keeps working.\n * @deprecated leave it out.\n */\n faceMasking?: VideoRemakeFaceMasking\n /**\n * `\"draft\"` means 480p draft.\n * @deprecated use `resolution` + `draft`.\n */\n quality?: \"draft\"\n /** A generation session to file the result in. */\n sessionId?: string\n /** The client app that sent the run (stored on the job as `input_data.origin`). */\n origin?: string\n}\n\n/** What a run would cost, in credits. */\nexport interface VideoRemakeEstimate {\n /**\n * The engine the run would use, by its public id (absent from an older\n * server = `\"nodaro-prism\"`). An id an older server answers is read as the\n * public id it names.\n */\n engine?: VideoRemakeEngine\n /**\n * What is held when the run starts. The run is charged what it actually\n * costs, which is expected to be `expectedCredits`.\n */\n totalCredits: number\n /**\n * The charge the run is expected to come to. Never above `totalCredits`\n * (on Nodaro Pulse it equals it: Pulse renders exactly the length\n * asked for, so the hold is what it settles at). Absent from an older\n * server: read `totalCredits` then.\n */\n expectedCredits?: number\n /**\n * The parts of the quote, by name, for display only:\n * - `base`: the run itself (its base fee). An older server\n * names it `castSwap` instead: read `base`, else `castSwap`;\n * - `references`: preparing the reference pictures (0 when\n * `prepareReferences` is off or there is nothing to prepare);\n * - `motion`: what the video holds (on Nodaro Pulse, what it costs);\n * - `motionExpected`: what the video is expected to be charged, never above\n * `motion` (Nodaro Prism);\n * - `privacy`: preparing the clip, when the engine's setting does. In both\n * totals when it always runs; outside both when it is the retry\n * (`privacyCredits`).\n * - `prompt`: the prompt written for the run by a language model, when\n * Nodaro's setting for the engine does so (absent otherwise).\n * - `referenceAudio`: preparing the clip's sound for the video model, when\n * Nodaro's setting for the engine runs that step (absent otherwise).\n *\n * `motion` and `motionExpected` are alternatives, so the parts sum to more\n * than either total: read `totalCredits` and `expectedCredits`, never the\n * sum. Other parts may appear.\n */\n breakdown: {\n base?: number\n /** @deprecated read {@link base} (an older server answered this name for the same part). */\n castSwap?: number\n references: number\n motion?: number\n motionExpected?: number\n privacy?: number\n prompt?: number\n referenceAudio?: number\n } & Record<string, number>\n /**\n * The extra credits charged only if the video model refuses the clip and\n * the run is retried (Nodaro's setting for the engine decides whether it\n * does). Not in `totalCredits` or `expectedCredits`; `run()` needs credits\n * for both the hold and this (else 402).\n */\n privacyCredits?: number\n /** @deprecated read {@link privacyCredits} (an older server answered this name). */\n maskingCredits?: number\n /**\n * `true` when the video is made at Auto length (every Nodaro Prism\n * run): the final charge is expected to come out lower than `totalCredits`,\n * at about `expectedCredits`. `false` on Nodaro Pulse.\n */\n settlesLower: boolean\n}\n\n/** Per-call options for {@link VideoRemakeResource.run}. */\nexport interface VideoRemakeRunOptions {\n /**\n * Sent as the `Idempotency-Key` header, unchanged (the SDK checks nothing;\n * an empty string sends no header, like no key).\n * The server takes 8–200 characters and answers 400 for any other length.\n * Reuse the same value when retrying the same run: within about 10 s the\n * repeat answers 200 `{ jobId, deduped: true }`, later 202 with the first\n * run's `jobId`. Nothing new is started or charged.\n */\n idempotencyKey?: string\n}\n\n/**\n * What a Full Quality version would be: `\"same-take\"` finishes a Nodaro\n * Prism draft's own take at 1080p, and the draft stays. `\"new-take\"` was a new\n * Nodaro Pulse take at 1080p from a 720p run's inputs; Pulse no longer\n * has Full Quality, so a quote no longer answers it (kept so code that reads\n * it still compiles).\n */\nexport type VideoRemakeFullQualityKind = \"same-take\" | \"new-take\"\n\n/**\n * What a Full Quality version of a run would cost\n * (`POST /v1/video-remake/:jobId/full-quality/estimate`): a Nodaro Prism\n * draft (a 480p run made with `draft: true`).\n */\nexport interface VideoRemakeFullQualityEstimate {\n /**\n * Which Full Quality this is ({@link VideoRemakeFullQualityKind}), so it can\n * be worded right. Absent from an older server: `\"same-take\"`.\n */\n kind?: VideoRemakeFullQualityKind\n /** The quote in credits: `breakdown.base` plus the 1080p render (same take) or the new take. */\n totalCredits: number\n /**\n * The parts of the quote, by name, for display only: `base` (the Full\n * Quality job's own steps; an older server names it\n * `castSwap` instead: read `base`, else `castSwap`), and `motionHd` (a same\n * take: the 1080p render, 0 when an earlier try of this draft already\n * finished that render, which is then reused) or `motion` (a new take).\n */\n breakdown: {\n base?: number\n /** @deprecated read {@link base} (an older server answered this name for the same part). */\n castSwap?: number\n motionHd?: number\n motion?: number\n } & Record<string, number>\n /** ISO time until which the run can be finished at Full Quality (7 days after it completed). */\n availableUntil: string\n}\n\n/** Options for {@link VideoRemakeResource.fullQuality}. */\nexport interface VideoRemakeFullQualityParams {\n /** A generation session to file the Full Quality result in. */\n sessionId?: string\n}\n\n/** The Full Quality job (`POST /v1/video-remake/:jobId/full-quality`). */\nexport interface VideoRemakeFullQualityResult {\n jobId: string\n /** `true` when this run's Full Quality was already running or done: that job is answered, nothing new is started or charged. */\n existing?: boolean\n}\n\n/**\n * The `code` of a Full Quality refusal (`NodaroError.code`), all before\n * anything is charged:\n * - `unauthorized` (401): no authenticated user;\n * - `not_found` (404): not your job, or not a Video Remake run; also a\n * `sessionId` you may not use;\n * - `not_completed` (409): the run has not finished;\n * - `not_a_draft` (409): the run is not a Nodaro Prism draft: a plain\n * run (480p made without `draft: true` included; make a draft with\n * `draft: true`), or any Nodaro Pulse run (Pulse makes no drafts: run\n * it again at 1080p);\n * - `draft_expired` (410): more than 7 days after the draft completed, or\n * the draft can no longer be finished at Full Quality;\n * - `full_quality_pending` (409, `details.retryable: true`): not final — an\n * earlier try's 1080p render of this draft is being reviewed, or has not\n * started yet; try again later (once the review ends). The only refusal\n * that ends on its own;\n * - `full_quality_unavailable` (409): final — nothing kept to re-render, no\n * readable completion time, or the 1080p finalize refuses this draft; on\n * the start only, also \"failed too many times\" (every try failed) or no\n * try can be started for this run;\n * - `insufficient_credits` (402), or in a workspace `budget_exceeded`,\n * `member_cap_exceeded` or `user_allowance_exceeded`;\n * - `job_blocked` (422): the request was blocked by the job policy;\n * - `job_read_failed` (503, retryable), `estimate_unavailable` (503, try\n * again shortly), `host_too_old` (503).\n *\n * Open-ended: a code not listed here may still arrive.\n */\nexport type VideoRemakeFullQualityRefusalCode =\n | \"unauthorized\"\n | \"not_found\"\n | \"not_completed\"\n | \"not_a_draft\"\n | \"draft_expired\"\n | \"full_quality_pending\"\n | \"full_quality_unavailable\"\n | \"insufficient_credits\"\n | \"budget_exceeded\"\n | \"member_cap_exceeded\"\n | \"user_allowance_exceeded\"\n | \"job_blocked\"\n | \"job_read_failed\"\n | \"estimate_unavailable\"\n | \"host_too_old\"\n | (string & {})\n\n/**\n * Who decides a direct run's style on one engine:\n * - `\"user\"`: the person (the request's `style`, left out = `\"precise\"`);\n * show a Style control;\n * - `\"precise\"`: Nodaro's own apps run Precise on that engine and show no\n * Style control; it changes no request: a direct run and quote take the\n * request's `style`, as on `\"user\"`;\n * - `\"flex\"`: an admin forced it — every direct run and quote of that engine\n * runs Flex (`style: \"motion\"`) whatever the request's `style` says; show\n * no Style control.\n *\n * A trend run keeps its own trend's style.\n */\nexport type VideoRemakeStyleChoiceOption = \"user\" | \"precise\" | \"flex\"\n\n/** What {@link VideoRemakeResource.styleChoice} answers: every engine's choice, by its public id. */\nexport interface VideoRemakeStyleChoice {\n engines: Record<VideoRemakeEngine, VideoRemakeStyleChoiceOption>\n /**\n * Per engine, whether the engine takes style-only runs: a Flex run\n * (`style: \"motion\"`) with an art style (`direction`) and nothing to swap\n * (no role with images, no fixed reference). It follows the engine alone, so\n * read it with {@link engines}: an engine answered `\"flex\"` makes a Precise\n * request Flex too, and one answered `\"precise\"` changes no request, so a\n * Flex request there runs as on `\"user\"`. Nodaro Pulse is always\n * `false` (it takes no art style). Absent from an older server, and\n * an engine missing from it: `false`.\n */\n styleOnly?: Partial<Record<VideoRemakeEngine, boolean>>\n /**\n * Per engine, whether a Precise run (no `style`, or `\"precise\"`) takes an\n * art style (`direction`), as a Flex run does. Nodaro may run such a request as\n * a Flex run (see {@link VideoRemakeParams}'s `direction`), which this does not\n * say; otherwise it is Precise's edit of the clip, drawn in the art style, and,\n * where {@link VideoRemakeStyleChoice.preciseArtStyleAlone} is not true for the\n * engine, not on its own: a Precise run with nothing else to change is then refused.\n * Nodaro Pulse is always `false` (it takes no art style). Absent from\n * an older server, and an engine missing from it: `false` (offer an art style\n * on Flex runs alone).\n */\n preciseArtStyle?: Partial<Record<VideoRemakeEngine, boolean>>\n /**\n * Per engine, whether an art style (`direction`) alone is a Precise run's\n * change there, so the run needs no role, reference or prompt. Nodaro may run\n * such a request as a Flex run (see {@link VideoRemakeParams}'s `direction`), which\n * this does not say. It answers\n * `false` until the engine takes such runs. Nodaro Pulse is always\n * `false` (it takes no art style). Absent from an older server, and an engine\n * missing from it: `false`.\n */\n preciseArtStyleAlone?: Partial<Record<VideoRemakeEngine, boolean>>\n}\n\nexport class VideoRemakeResource {\n constructor(private client: NodaroClientCore) {}\n\n /**\n * Start a Video Remake run (`POST /v1/video-remake`, 202 `{ jobId }`). Returns the\n * job to follow. With `options.idempotencyKey` (sent as the\n * `Idempotency-Key` header; 8–200 characters, else 400) a repeat with the\n * same key within about 10 s answers 200 `{ jobId, deduped: true }`, a later\n * one 202 with the first run's `jobId`; nothing new starts.\n */\n run(params: VideoRemakeParams, options?: VideoRemakeRunOptions): Promise<{ jobId: string; deduped?: boolean }> {\n return this.client.request(\"POST\", \"/v1/video-remake\", {\n body: params,\n ...(options?.idempotencyKey ? { headers: { \"Idempotency-Key\": options.idempotencyKey } } : {}),\n })\n }\n\n /**\n * Whether people choose a direct run's style, per engine\n * (`GET /v1/video-remake/style-choice`): `\"user\"` = show a Style control;\n * `\"precise\"` = Nodaro's own apps run Precise on that engine and hide the\n * control, while a run's `style` is still taken as sent; `\"flex\"` = an admin\n * forced Flex for the engine, so a run's `style` is overridden and the\n * control is best hidden. Its\n * `styleOnly` says, per engine, whether a Flex run with an art style and\n * nothing to swap restyles the whole clip there. Where it is not `true`\n * (absent, or an engine missing from it, included) on Nodaro Prism, an\n * art style alone is refused, and one with a pre or post prompt runs as any\n * other art-style run. Its `preciseArtStyle` says, per engine, whether a\n * Precise run takes an art style there too, and its `preciseArtStyleAlone`\n * whether that art style alone is the run's change.\n * Public (no sign-in needed); the answer may be up to a minute old.\n */\n styleChoice(): Promise<VideoRemakeStyleChoice> {\n return this.client.request(\"GET\", \"/v1/video-remake/style-choice\")\n }\n\n /** Quote a run before starting it (`POST /v1/video-remake/estimate`); spends nothing. */\n async estimate(params: VideoRemakeParams): Promise<VideoRemakeEstimate> {\n const quote = await this.client.request<VideoRemakeEstimate>(\"POST\", \"/v1/video-remake/estimate\", { body: params })\n // An older server names the engine by an earlier id: answered as the public id it names.\n const engine = nodaroMotionEngineFrom(quote?.engine)\n return engine && engine !== quote.engine ? { ...quote, engine } : quote\n }\n\n /**\n * Quote finishing a run at Full Quality (`POST\n * /v1/video-remake/:jobId/full-quality/estimate`); spends nothing. `jobId` is a\n * finished Nodaro Prism DRAFT run (a Video Remake or trend run made\n * with `draft: true`), whose same take Full Quality finishes at 1080p. The\n * quote does not look for a Full Quality already running: when one is,\n * {@link fullQuality} answers it (`existing: true`) and charges nothing.\n * Refusals: {@link VideoRemakeFullQualityRefusalCode}.\n */\n fullQualityEstimate(jobId: string): Promise<VideoRemakeFullQualityEstimate> {\n return this.client.request(\"POST\", `/v1/video-remake/${encodeURIComponent(jobId)}/full-quality/estimate`, { body: {} })\n }\n\n /**\n * Finish a run at Full Quality (`POST /v1/video-remake/:jobId/full-quality`):\n * at 1080p, with the clip's audio, as a new job linked to the run — a\n * Nodaro Prism draft's own take re-rendered. SPENDS CREDITS: quote it first with\n * {@link fullQualityEstimate}. Answers 202 `{ jobId }`, or 200\n * `{ jobId, existing: true }` when this run's Full Quality is already\n * running or done (one per run; a failed one may be asked again). Follow\n * the job with `client.jobs.get(jobId)`. No `Idempotency-Key` is taken: the\n * server keys the job by the draft. The new job keeps the draft's origin.\n * Refusals: {@link VideoRemakeFullQualityRefusalCode}.\n */\n fullQuality(jobId: string, params: VideoRemakeFullQualityParams = {}): Promise<VideoRemakeFullQualityResult> {\n const body = params.sessionId !== undefined ? { sessionId: params.sessionId } : {}\n return this.client.request(\"POST\", `/v1/video-remake/${encodeURIComponent(jobId)}/full-quality`, { body })\n }\n}\n\n// ---------------------------------------------------------------------------\n// The names this resource had before (`client.castSwap`, `CastSwap*`): the\n// same resource and the same types, kept so code written against them still\n// builds.\n// ---------------------------------------------------------------------------\n\n/** @deprecated use {@link VideoRemakeResource} (`client.videoRemake`). */\nexport const CastSwapResource = VideoRemakeResource\n/** @deprecated use {@link VideoRemakeResource} (`client.videoRemake`). */\nexport type CastSwapResource = VideoRemakeResource\n/** @deprecated use {@link VideoRemakeEngine}. */\nexport type CastSwapEngine = VideoRemakeEngine\n/** @deprecated use {@link VideoRemakeEngine}. */\nexport type CastSwapEngineLegacyId = VideoRemakeEngineLegacyId\n/** @deprecated use {@link VideoRemakeStyle}. */\nexport type CastSwapStyle = VideoRemakeStyle\n/** @deprecated use {@link VideoRemakeMotionLength}. */\nexport type CastSwapMotionLength = VideoRemakeMotionLength\n/** @deprecated use {@link VideoRemakeMotionLength}. */\nexport type CastSwapKlingLength = VideoRemakeMotionLength\n/** @deprecated use {@link VideoRemakeTraitSource}. */\nexport type CastSwapTraitSource = VideoRemakeTraitSource\n/** @deprecated use {@link VideoRemakeRolePreviewSettings}. */\nexport type CastSwapRolePreviewSettings = VideoRemakeRolePreviewSettings\n/** @deprecated use {@link VideoRemakePersonRole}. */\nexport type CastSwapPersonRole = VideoRemakePersonRole\n/** @deprecated use {@link VideoRemakeLocationRole}. */\nexport type CastSwapLocationRole = VideoRemakeLocationRole\n/** @deprecated use {@link VideoRemakePetRole}. */\nexport type CastSwapPetRole = VideoRemakePetRole\n/** @deprecated use {@link VideoRemakeProductRole}. */\nexport type CastSwapProductRole = VideoRemakeProductRole\n/** @deprecated use {@link VideoRemakeRole}. */\nexport type CastSwapRole = VideoRemakeRole\n/** @deprecated use {@link VideoRemakeReference}. */\nexport type CastSwapReference = VideoRemakeReference\n/** @deprecated use {@link VideoRemakeFaceMaskingZone}. */\nexport type CastSwapFaceMaskingZone = VideoRemakeFaceMaskingZone\n/** @deprecated use {@link VideoRemakeFaceMasking}. */\nexport type CastSwapFaceMasking = VideoRemakeFaceMasking\n/** @deprecated use {@link VideoRemakeParams}. */\nexport type CastSwapParams = VideoRemakeParams\n/** @deprecated use {@link VideoRemakeEstimate}. */\nexport type CastSwapEstimate = VideoRemakeEstimate\n/** @deprecated use {@link VideoRemakeRunOptions}. */\nexport type CastSwapRunOptions = VideoRemakeRunOptions\n/** @deprecated use {@link VideoRemakeFullQualityKind}. */\nexport type CastSwapFullQualityKind = VideoRemakeFullQualityKind\n/** @deprecated use {@link VideoRemakeFullQualityEstimate}. */\nexport type CastSwapFullQualityEstimate = VideoRemakeFullQualityEstimate\n/** @deprecated use {@link VideoRemakeFullQualityParams}. */\nexport type CastSwapFullQualityParams = VideoRemakeFullQualityParams\n/** @deprecated use {@link VideoRemakeFullQualityResult}. */\nexport type CastSwapFullQualityResult = VideoRemakeFullQualityResult\n/** @deprecated use {@link VideoRemakeFullQualityRefusalCode}. */\nexport type CastSwapFullQualityRefusalCode = VideoRemakeFullQualityRefusalCode\n/** @deprecated use {@link VideoRemakeStyleChoiceOption}. */\nexport type CastSwapStyleChoiceOption = VideoRemakeStyleChoiceOption\n/** @deprecated use {@link VideoRemakeStyleChoice}. */\nexport type CastSwapStyleChoice = VideoRemakeStyleChoice\n"]}
@@ -0,0 +1,187 @@
1
+ import { NodaroError, LargeUploadUnavailableError } from './chunk-4Q3XZE5O.js';
2
+
3
+ // src/resources/uploads.ts
4
+ var UPLOAD_MAX_BYTES = 500 * 1024 * 1024;
5
+ var PART_ATTEMPTS = 3;
6
+ var COMPLETE_TIMEOUT_MS = 5 * 60 * 1e3;
7
+ var UploadsResource = class {
8
+ constructor(client) {
9
+ this.client = client;
10
+ }
11
+ client;
12
+ /**
13
+ * Upload one file (`POST /v1/upload`, multipart — the file rides the `file`
14
+ * field). The SDK's `request` detects the `FormData` body and lets the
15
+ * runtime set the multipart boundary. Returns the persisted asset's public
16
+ * URL + storage metadata (unwraps the `{ data }` envelope). Throws
17
+ * `StorageExceededError` (413) over the storage cap and the SDK's other typed
18
+ * errors on the usual statuses.
19
+ */
20
+ async upload(file) {
21
+ return this.uploadMultipart(file);
22
+ }
23
+ async uploadMultipart(file, filename, signal) {
24
+ const form = new FormData();
25
+ if (filename !== void 0) form.append("file", file, filename);
26
+ else form.append("file", file);
27
+ const res = await this.client.request(
28
+ "POST",
29
+ "/v1/upload",
30
+ { body: form, ...signal ? { signal } : {} }
31
+ );
32
+ return res.data;
33
+ }
34
+ /**
35
+ * Upload a file of any size, choosing the lane by size:
36
+ *
37
+ * - **{@link UPLOAD_MAX_BYTES} (500 MB) or less:** exactly {@link upload}
38
+ * (`POST /v1/upload`) — the path every file of that size takes today, with
39
+ * everything it does on the server (faststart, HEIC conversion, upload
40
+ * policies, thumbnails). The large-upload lane is never touched.
41
+ * - **Bigger (video or audio only):** the bytes go straight from here to the
42
+ * platform's object storage in parts (`POST /v1/uploads/large/start` → one
43
+ * `PUT` per part → `POST /v1/uploads/large/complete`), never through the
44
+ * API server. What limits such a file is length: one longer than 30
45
+ * minutes is refused once it has arrived, with `MediaTooLongError` (the
46
+ * stored copy is removed and nothing counts against storage).
47
+ *
48
+ * Returns the same result as {@link upload}. Parts are sent `concurrency` at
49
+ * a time (default 3); a part that fails is tried twice more before the
50
+ * upload fails. `onProgress(sentBytes, totalBytes)` is called as parts
51
+ * finish (once at the end on the small path). Aborting `signal`, or any
52
+ * failure, aborts the upload on the server (best-effort).
53
+ *
54
+ * A file over 500 MB on a deployment without the lane — one that checks every
55
+ * upload's bytes (409 `large_upload_unavailable`), or an older server (404) —
56
+ * throws `LargeUploadUnavailableError`: `POST /v1/upload` would refuse it
57
+ * anyway. Throws `StorageExceededError` (413) when the file does not fit in
58
+ * the account's storage, and the SDK's other typed errors on the usual
59
+ * statuses.
60
+ *
61
+ * In a browser, storage must allow cross-origin `PUT` from the page's origin
62
+ * for the large lane (the platform's own deployments do).
63
+ */
64
+ async uploadLarge(file, options = {}) {
65
+ const filename = options.filename ?? (file.name && file.name.length > 0 ? file.name : "upload");
66
+ const signal = options.signal;
67
+ if (file.size <= UPLOAD_MAX_BYTES) {
68
+ const result = await this.uploadMultipart(file, filename, signal);
69
+ options.onProgress?.(file.size, file.size);
70
+ return result;
71
+ }
72
+ let started;
73
+ try {
74
+ started = await this.client.request("POST", "/v1/uploads/large/start", {
75
+ body: { filename, mimeType: file.type || "application/octet-stream", sizeBytes: file.size },
76
+ ...signal ? { signal } : {}
77
+ });
78
+ } catch (err) {
79
+ if (err instanceof NodaroError && err.status === 404) throw new LargeUploadUnavailableError(void 0, 404);
80
+ throw err;
81
+ }
82
+ const { token, partSize, partUrls } = started;
83
+ try {
84
+ await this.sendParts(file, partSize, partUrls, options);
85
+ const res = await this.client.request("POST", "/v1/uploads/large/complete", {
86
+ body: { token },
87
+ timeoutMs: COMPLETE_TIMEOUT_MS,
88
+ ...signal ? { signal } : {}
89
+ });
90
+ return res.data;
91
+ } catch (err) {
92
+ await this.client.request("POST", "/v1/uploads/large/abort", { body: { token } }).catch(() => void 0);
93
+ throw err;
94
+ }
95
+ }
96
+ /**
97
+ * PUT every part, `concurrency` at a time, each tried up to
98
+ * {@link PART_ATTEMPTS} times. Each part is EXACTLY `partSize` bytes (the
99
+ * last one the remainder): its URL has that length signed in, so storage
100
+ * refuses any other. The runtime sets Content-Length from the slice itself.
101
+ */
102
+ async sendParts(file, partSize, partUrls, options) {
103
+ const total = file.size;
104
+ const concurrency = Math.max(1, Math.floor(options.concurrency ?? 3));
105
+ let next = 0;
106
+ let sent = 0;
107
+ let failed;
108
+ const worker = async () => {
109
+ while (failed === void 0 && next < partUrls.length) {
110
+ const index = next++;
111
+ const start = index * partSize;
112
+ const part = file.slice(start, Math.min(start + partSize, total));
113
+ try {
114
+ await this.putPart(partUrls[index], part, index + 1, options.signal);
115
+ } catch (err) {
116
+ failed ??= err;
117
+ return;
118
+ }
119
+ sent += part.size;
120
+ options.onProgress?.(sent, total);
121
+ }
122
+ };
123
+ await Promise.all(Array.from({ length: Math.min(concurrency, partUrls.length) }, () => worker()));
124
+ if (failed !== void 0) throw failed;
125
+ }
126
+ async putPart(url, part, partNumber, signal) {
127
+ let lastStatus = 0;
128
+ for (let attempt = 1; attempt <= PART_ATTEMPTS; attempt++) {
129
+ signal?.throwIfAborted();
130
+ try {
131
+ const res = await this.client.fetch(url, { method: "PUT", body: part, ...signal ? { signal } : {} });
132
+ if (res.ok) return;
133
+ lastStatus = res.status;
134
+ if (res.status >= 400 && res.status < 500 && res.status !== 408 && res.status !== 429) break;
135
+ } catch (err) {
136
+ if (signal?.aborted) throw err;
137
+ lastStatus = 0;
138
+ }
139
+ }
140
+ throw new NodaroError(`Uploading part ${partNumber} failed${lastStatus ? ` (HTTP ${lastStatus})` : ""}`, "upload_part_failed", lastStatus);
141
+ }
142
+ /**
143
+ * Copy a picture from a web address into your storage
144
+ * (`POST /v1/media/import-url`, body `{ url }`). The platform fetches it
145
+ * (http(s) only, never a private address, up to 20 MB), keeps it only if it
146
+ * decodes as an image (JPEG, PNG, WebP, GIF; HEIC/HEIF and AVIF are
147
+ * converted to JPEG or PNG), and stores it as an upload of yours, so its address serves
148
+ * the pixels to the browser (a canvas can read it). Returns the stored
149
+ * picture (unwraps the `{ data }` envelope).
150
+ *
151
+ * Throws `StorageExceededError` on a 413, its `reason` telling the two
152
+ * apart: `storage_limit_exceeded` is a full storage (the quota is in
153
+ * `details` — `usedBytes`, `quotaBytes`, `remainingBytes`, `tier`), and
154
+ * `file_too_large` a picture over 20 MB. Throws a `NodaroError` with `code`
155
+ * `validation_error` (400: not an http(s) address, or not an image) or
156
+ * `fetch_failed` (422: the address could not be reached or answered with an
157
+ * error).
158
+ *
159
+ * An import of a link runs the platform's content rights check: pass the
160
+ * `confirmationId` from `contentRights.confirm({ url })` when the deployment
161
+ * requires one (`403 rights_confirmation_required` otherwise). A site an
162
+ * administrator disabled answers `403 import_source_disabled`, and a
163
+ * deployment that turned link imports off answers `403 link_imports_disabled`
164
+ * for a link to another site (a file of the deployment's own storage is still
165
+ * imported as before).
166
+ */
167
+ async importUrl(url, options = {}) {
168
+ const res = await this.client.request("POST", "/v1/media/import-url", {
169
+ body: { url, ...options.confirmationId ? { confirmationId: options.confirmationId } : {} }
170
+ });
171
+ return res.data;
172
+ }
173
+ /**
174
+ * Store a JSON document (`POST /v1/upload-json`, up to 25 MB) and get its
175
+ * public URL — e.g. an image editor's design state, passed to
176
+ * `client.jobs.fromUpload` as `editStateUrl` so the edit can be reopened.
177
+ * The URL is unguessable but public: never store a secret in it. Creates no
178
+ * library item.
179
+ */
180
+ uploadJson(json) {
181
+ return this.client.request("POST", "/v1/upload-json", { body: json });
182
+ }
183
+ };
184
+
185
+ export { UPLOAD_MAX_BYTES, UploadsResource };
186
+ //# sourceMappingURL=chunk-K53JD2ZC.js.map
187
+ //# sourceMappingURL=chunk-K53JD2ZC.js.map