@nodaro/sdk 2.49.0 → 2.52.0

package/dist/entries/client.d.ts

@@ -25,6 +25,7 @@ import { MediaResource } from './media.js';
 import { AudioResource } from './audio.js';
 import { CreditsResource } from './credits.js';
 import { BillingResource } from './billing.js';
+import { UserSettingsResource } from './user-settings.js';
 import { UploadsResource } from './uploads.js';
 import { LibraryResource } from './library.js';
 import { GalleryResource } from './gallery.js';
@@ -105,6 +106,8 @@ declare class NodaroClient extends NodaroClientCore {
     readonly media: MediaResource;
     readonly audio: AudioResource;
     readonly credits: CreditsResource;
+    /** The signed-in person's own settings (the interface language, the monthly statement opt-in, …). */
+    readonly userSettings: UserSettingsResource;
     /** Plans and prices, the subscription, and how this deployment bills. */
     readonly billing: BillingResource;
     readonly uploads: UploadsResource;

package/dist/entries/client.js

@@ -1,5 +1,6 @@
-export { NodaroClient, createClient } from '../chunk-2JAKOBD3.js';
+export { NodaroClient, createClient } from '../chunk-WUVTKMAQ.js';
 import '../chunk-WY4QRJZW.js';
+import '../chunk-LR5TGCJP.js';
 import '../chunk-ERLXU47J.js';
 import '../chunk-T7N7DFQJ.js';
 import '../chunk-YN6CBIIB.js';
@@ -41,14 +42,14 @@ import '../chunk-SFB4YLCS.js';
 import '../chunk-BU5A6K4C.js';
 import '../chunk-D2ILCSOQ.js';
 import '../chunk-7CUWAVWB.js';
-export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-5MZYOJCJ.js';
+export { CallbackAuth, StaticTokenAuth, supabaseAuth } from '../chunk-NFVYOMNV.js';
 import '../chunk-L6T44A3G.js';
 import '../chunk-CK3AMMSC.js';
-import '../chunk-5MOJSYHI.js';
+import '../chunk-7QK2NXJA.js';
 import '../chunk-65E3JBFZ.js';
 import '../chunk-7LODCIQK.js';
 import '../chunk-3QFTP5P5.js';
-import '../chunk-J4WFSKY6.js';
+import '../chunk-ZVKEPVDQ.js';
 import '../chunk-OCRUDBPG.js';
 import '../chunk-KG4R454Z.js';
 import '../chunk-EJSGJDZY.js';

package/dist/entries/core.cjs

@@ -1,26 +1,26 @@
 'use strict';
 
 require('../chunk-X7XP5WBP.cjs');
-var chunkNOBQQTAG_cjs = require('../chunk-NOBQQTAG.cjs');
+var chunkFDTE4C5W_cjs = require('../chunk-FDTE4C5W.cjs');
 require('../chunk-FM2KM5TY.cjs');
 
 
 
 Object.defineProperty(exports, "CallbackAuth", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.CallbackAuth; }
+  get: function () { return chunkFDTE4C5W_cjs.CallbackAuth; }
 });
 Object.defineProperty(exports, "NodaroClientCore", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.NodaroClientCore; }
+  get: function () { return chunkFDTE4C5W_cjs.NodaroClientCore; }
 });
 Object.defineProperty(exports, "StaticTokenAuth", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.StaticTokenAuth; }
+  get: function () { return chunkFDTE4C5W_cjs.StaticTokenAuth; }
 });
 Object.defineProperty(exports, "supabaseAuth", {
   enumerable: true,
-  get: function () { return chunkNOBQQTAG_cjs.supabaseAuth; }
+  get: function () { return chunkFDTE4C5W_cjs.supabaseAuth; }
 });
 //# sourceMappingURL=core.cjs.map
 //# sourceMappingURL=core.cjs.map

package/dist/entries/core.js

@@ -1,5 +1,5 @@
 import '../chunk-AUDHV3OE.js';
-export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-5MZYOJCJ.js';
+export { CallbackAuth, NodaroClientCore, StaticTokenAuth, supabaseAuth } from '../chunk-NFVYOMNV.js';
 import '../chunk-L6T44A3G.js';
 //# sourceMappingURL=core.js.map
 //# sourceMappingURL=core.js.map

package/dist/entries/credits.cjs

@@ -1,13 +1,13 @@
 'use strict';
 
 require('../chunk-ALUUBPDG.cjs');
-var chunkFIMBPKIH_cjs = require('../chunk-FIMBPKIH.cjs');
+var chunk4BAHF762_cjs = require('../chunk-4BAHF762.cjs');
 
 
 
 Object.defineProperty(exports, "CreditsResource", {
   enumerable: true,
-  get: function () { return chunkFIMBPKIH_cjs.CreditsResource; }
+  get: function () { return chunk4BAHF762_cjs.CreditsResource; }
 });
 //# sourceMappingURL=credits.cjs.map
 //# sourceMappingURL=credits.cjs.map

package/dist/entries/credits.d.cts

@@ -202,6 +202,157 @@ interface CreditTransactionsOptions {
     /** The `nextCursor` of the previous page. */
     cursor?: string;
 }
+/** How `credits.usageSummary()` groups the series over time. */
+type UsageSummaryBucket = "day" | "week" | "month";
+interface UsageSummaryOptions {
+    /** 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. */
+    from?: string;
+    to?: string;
+    /** Default `"day"`. Buckets are UTC. */
+    bucket?: UsageSummaryBucket;
+}
+interface UsageSummaryTotals {
+    /** Credits spent on runs in the period: each run's charge (a running hold counts; a refunded run does not). */
+    used: number;
+    /** Credits bought: packs, loads, subscription grants. */
+    purchased: number;
+    /** Credits granted free, net: sign-up and admin adjustments, a grant taken back subtracted. */
+    granted: number;
+    /** Credits given back for a refunded run or by Stripe (a hold released when a run settled below it is not a refund). */
+    refunded: number;
+    /** Runs that were charged or are still running. */
+    runs: number;
+    /** `used / runs`, one decimal; 0 with no runs. */
+    avgPerRun: number;
+}
+interface UsageByModel {
+    model: string;
+    provider: string | null;
+    credits: number;
+    runs: number;
+    /** Of `totals.used`, 0–1. */
+    share: number;
+}
+interface UsageByCategory {
+    /** `"image"`, `"video"`, `"audio"` or `"other"`. */
+    category: string;
+    credits: number;
+    runs: number;
+}
+interface UsageOverTime {
+    /** 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. */
+    bucket: string;
+    used: number;
+    purchased: number;
+    runs: number;
+}
+/** The spend of one session or one workflow. */
+interface UsageByGroup {
+    id: string;
+    /** The session's title or the workflow's name; `null` when it has none or is gone. */
+    name: string | null;
+    /** The tool the session belongs to; `null` on a workflow. */
+    tool: string | null;
+    credits: number;
+    runs: number;
+    /** The models used, by spend. */
+    models: string[];
+    /** ISO-8601: the latest run. */
+    lastAt: string;
+}
+/** The answer of `credits.usageSummary()`. */
+interface UsageSummary {
+    period: {
+        from: string;
+        to: string;
+        bucket: UsageSummaryBucket;
+    };
+    totals: UsageSummaryTotals;
+    /** The model with the most spend; `null` with no runs. */
+    mostUsed: UsageByModel | null;
+    /** By spend. */
+    byModel: UsageByModel[];
+    byCategory: UsageByCategory[];
+    /** Every bucket of the period, empty ones included, oldest first. */
+    overTime: UsageOverTime[];
+    bySession: UsageByGroup[];
+    byWorkflow: UsageByGroup[];
+    /** A read hit the server's row cap: the figures under-report; narrow the period. */
+    truncated: boolean;
+    /** 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. */
+    partial: boolean;
+}
+/** What a movement of the balance was; `app` is credits earned from, or paid for, a published app. */
+type CreditHistoryKind = "usage" | "purchase" | "grant" | "refund" | "app" | "adjustment" | "expiry";
+/** The job behind a usage row of {@link CreditHistoryEntry}. */
+interface CreditHistoryJob {
+    id: string;
+    /** The node type that ran (`generate-image`, `image-to-video`, …); `null` when the job is gone. */
+    type: string | null;
+    status: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    /** From start to completion; `null` until it completes. */
+    durationMs: number | null;
+    workflowId: string | null;
+    sessionId: string | null;
+}
+/** One movement of the balance (`credits.history()`). */
+interface CreditHistoryEntry {
+    id: string;
+    /** ISO-8601. Also the paging cursor. */
+    at: string;
+    kind: CreditHistoryKind;
+    /** The ledger's own word: `usage`, `one_time_purchase`, `subscription_renewal`, `signup_grant`, `refund`, `admin_adjustment`, `expiry`, … */
+    source: string;
+    /** The movement, signed: a run's hold negative, a purchase positive. */
+    amount: number;
+    /** The balance right after this movement. */
+    balanceAfter: number;
+    /** Which pool moved; `"mixed"` when both did. */
+    pool: "subscription" | "topup" | "mixed";
+    description: string | null;
+    /** The model that ran, on a row with a job; `null` otherwise. */
+    model: string | null;
+    provider: string | null;
+    /**
+     * The job's charge, on its reserve row only (the hold taken when the run
+     * was accepted): the settled charge, the hold while the run is open, `0`
+     * once refunded. `null` on every other row — a refund, a metered overrun
+     * line, a purchase — so summing it over a list counts each job once. Read
+     * this for spend, not `amount`.
+     */
+    charge: number | null;
+    /** The run's credit status (`"reserved"`, `"committed"` or `"refunded"`), beside `charge`; `null` elsewhere. */
+    status: string | null;
+    /** On a row with a job; `type` and the rest `null` when the job is gone or not the person's. */
+    job: CreditHistoryJob | null;
+    /** Stripe's hosted receipt, on a purchase that has one. */
+    receiptUrl: string | null;
+}
+/** A page of {@link CreditHistoryEntry}, newest first. */
+interface CreditHistoryPage {
+    data: CreditHistoryEntry[];
+    /** Pass as `cursor` for the next page; `null` when there are no more rows. */
+    nextCursor: string | null;
+}
+/** What narrows the history. */
+interface CreditHistoryFilters {
+    kind?: CreditHistoryKind;
+    /** A model identifier: only runs of that model. */
+    model?: string;
+    /** ISO-8601 bounds on `at`, inclusive. */
+    from?: string;
+    to?: string;
+    /** Words looked for in the description, case-insensitively. */
+    q?: string;
+}
+interface CreditHistoryOptions extends CreditHistoryFilters {
+    /** Rows per page, 1–100 (server default 50). */
+    limit?: number;
+    /** The `nextCursor` of the previous page, as given (opaque; another string is refused with 400). */
+    cursor?: string;
+}
 declare class CreditsResource {
     private client;
     constructor(client: NodaroClientCore);
@@ -219,6 +370,33 @@ declare class CreditsResource {
      * Cloud-only route: a self-hosted instance answers 404.
      */
     transactions(options?: CreditTransactionsOptions): Promise<CreditTransactionsPage>;
+    /**
+     * `GET /v1/credits/usage-summary` → the period's credit usage summed the
+     * way a billing screen draws it: totals, the spend by model and by
+     * category, a series over time (`bucket`: day, week or month, no holes),
+     * and the spend by session and by workflow. The last 30 days unless
+     * `from` / `to` say otherwise; a period of at most a year (400 beyond).
+     * Cloud-only route: a self-hosted instance answers 404.
+     */
+    usageSummary(options?: UsageSummaryOptions): Promise<UsageSummary>;
+    /**
+     * `GET /v1/credits/history` → one page of every movement of the balance,
+     * newest first — runs, purchases, grants, refunds, adjustments, expiries —
+     * each with the balance after it; a job's reserve row carries its model,
+     * its `charge` (the settled charge, the hold while the run is open, `0`
+     * once refunded — read that for spend, not `amount`) and its job. Filter by
+     * `kind`, `model`, `from` / `to` and `q`; pass the page's `nextCursor` (an
+     * opaque string) as `cursor` for the next page (`null` at the end).
+     * Cloud-only route: a self-hosted instance answers 404.
+     */
+    history(options?: CreditHistoryOptions): Promise<CreditHistoryPage>;
+    /**
+     * `GET /v1/credits/history?format=csv` → the whole filtered history as a
+     * CSV file (the same fields as {@link history}, one line per movement,
+     * newest first), at most 5,000 rows — the last line says when it was cut.
+     * Hand the text to the person as `credit-history.csv`.
+     */
+    exportHistory(filters?: CreditHistoryFilters): Promise<string>;
     /**
      * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
      * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
@@ -269,4 +447,4 @@ declare class CreditsResource {
     markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult>;
 }
 
-export { type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostError, type ModelCostResult, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };
+export { type CreditHistoryEntry, type CreditHistoryFilters, type CreditHistoryJob, type CreditHistoryKind, type CreditHistoryOptions, type CreditHistoryPage, type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostError, type ModelCostResult, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UsageByCategory, type UsageByGroup, type UsageByModel, type UsageOverTime, type UsageSummary, type UsageSummaryBucket, type UsageSummaryOptions, type UsageSummaryTotals, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };

package/dist/entries/credits.d.ts

@@ -202,6 +202,157 @@ interface CreditTransactionsOptions {
     /** The `nextCursor` of the previous page. */
     cursor?: string;
 }
+/** How `credits.usageSummary()` groups the series over time. */
+type UsageSummaryBucket = "day" | "week" | "month";
+interface UsageSummaryOptions {
+    /** 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. */
+    from?: string;
+    to?: string;
+    /** Default `"day"`. Buckets are UTC. */
+    bucket?: UsageSummaryBucket;
+}
+interface UsageSummaryTotals {
+    /** Credits spent on runs in the period: each run's charge (a running hold counts; a refunded run does not). */
+    used: number;
+    /** Credits bought: packs, loads, subscription grants. */
+    purchased: number;
+    /** Credits granted free, net: sign-up and admin adjustments, a grant taken back subtracted. */
+    granted: number;
+    /** Credits given back for a refunded run or by Stripe (a hold released when a run settled below it is not a refund). */
+    refunded: number;
+    /** Runs that were charged or are still running. */
+    runs: number;
+    /** `used / runs`, one decimal; 0 with no runs. */
+    avgPerRun: number;
+}
+interface UsageByModel {
+    model: string;
+    provider: string | null;
+    credits: number;
+    runs: number;
+    /** Of `totals.used`, 0–1. */
+    share: number;
+}
+interface UsageByCategory {
+    /** `"image"`, `"video"`, `"audio"` or `"other"`. */
+    category: string;
+    credits: number;
+    runs: number;
+}
+interface UsageOverTime {
+    /** 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. */
+    bucket: string;
+    used: number;
+    purchased: number;
+    runs: number;
+}
+/** The spend of one session or one workflow. */
+interface UsageByGroup {
+    id: string;
+    /** The session's title or the workflow's name; `null` when it has none or is gone. */
+    name: string | null;
+    /** The tool the session belongs to; `null` on a workflow. */
+    tool: string | null;
+    credits: number;
+    runs: number;
+    /** The models used, by spend. */
+    models: string[];
+    /** ISO-8601: the latest run. */
+    lastAt: string;
+}
+/** The answer of `credits.usageSummary()`. */
+interface UsageSummary {
+    period: {
+        from: string;
+        to: string;
+        bucket: UsageSummaryBucket;
+    };
+    totals: UsageSummaryTotals;
+    /** The model with the most spend; `null` with no runs. */
+    mostUsed: UsageByModel | null;
+    /** By spend. */
+    byModel: UsageByModel[];
+    byCategory: UsageByCategory[];
+    /** Every bucket of the period, empty ones included, oldest first. */
+    overTime: UsageOverTime[];
+    bySession: UsageByGroup[];
+    byWorkflow: UsageByGroup[];
+    /** A read hit the server's row cap: the figures under-report; narrow the period. */
+    truncated: boolean;
+    /** 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. */
+    partial: boolean;
+}
+/** What a movement of the balance was; `app` is credits earned from, or paid for, a published app. */
+type CreditHistoryKind = "usage" | "purchase" | "grant" | "refund" | "app" | "adjustment" | "expiry";
+/** The job behind a usage row of {@link CreditHistoryEntry}. */
+interface CreditHistoryJob {
+    id: string;
+    /** The node type that ran (`generate-image`, `image-to-video`, …); `null` when the job is gone. */
+    type: string | null;
+    status: string | null;
+    startedAt: string | null;
+    completedAt: string | null;
+    /** From start to completion; `null` until it completes. */
+    durationMs: number | null;
+    workflowId: string | null;
+    sessionId: string | null;
+}
+/** One movement of the balance (`credits.history()`). */
+interface CreditHistoryEntry {
+    id: string;
+    /** ISO-8601. Also the paging cursor. */
+    at: string;
+    kind: CreditHistoryKind;
+    /** The ledger's own word: `usage`, `one_time_purchase`, `subscription_renewal`, `signup_grant`, `refund`, `admin_adjustment`, `expiry`, … */
+    source: string;
+    /** The movement, signed: a run's hold negative, a purchase positive. */
+    amount: number;
+    /** The balance right after this movement. */
+    balanceAfter: number;
+    /** Which pool moved; `"mixed"` when both did. */
+    pool: "subscription" | "topup" | "mixed";
+    description: string | null;
+    /** The model that ran, on a row with a job; `null` otherwise. */
+    model: string | null;
+    provider: string | null;
+    /**
+     * The job's charge, on its reserve row only (the hold taken when the run
+     * was accepted): the settled charge, the hold while the run is open, `0`
+     * once refunded. `null` on every other row — a refund, a metered overrun
+     * line, a purchase — so summing it over a list counts each job once. Read
+     * this for spend, not `amount`.
+     */
+    charge: number | null;
+    /** The run's credit status (`"reserved"`, `"committed"` or `"refunded"`), beside `charge`; `null` elsewhere. */
+    status: string | null;
+    /** On a row with a job; `type` and the rest `null` when the job is gone or not the person's. */
+    job: CreditHistoryJob | null;
+    /** Stripe's hosted receipt, on a purchase that has one. */
+    receiptUrl: string | null;
+}
+/** A page of {@link CreditHistoryEntry}, newest first. */
+interface CreditHistoryPage {
+    data: CreditHistoryEntry[];
+    /** Pass as `cursor` for the next page; `null` when there are no more rows. */
+    nextCursor: string | null;
+}
+/** What narrows the history. */
+interface CreditHistoryFilters {
+    kind?: CreditHistoryKind;
+    /** A model identifier: only runs of that model. */
+    model?: string;
+    /** ISO-8601 bounds on `at`, inclusive. */
+    from?: string;
+    to?: string;
+    /** Words looked for in the description, case-insensitively. */
+    q?: string;
+}
+interface CreditHistoryOptions extends CreditHistoryFilters {
+    /** Rows per page, 1–100 (server default 50). */
+    limit?: number;
+    /** The `nextCursor` of the previous page, as given (opaque; another string is refused with 400). */
+    cursor?: string;
+}
 declare class CreditsResource {
     private client;
     constructor(client: NodaroClientCore);
@@ -219,6 +370,33 @@ declare class CreditsResource {
      * Cloud-only route: a self-hosted instance answers 404.
      */
     transactions(options?: CreditTransactionsOptions): Promise<CreditTransactionsPage>;
+    /**
+     * `GET /v1/credits/usage-summary` → the period's credit usage summed the
+     * way a billing screen draws it: totals, the spend by model and by
+     * category, a series over time (`bucket`: day, week or month, no holes),
+     * and the spend by session and by workflow. The last 30 days unless
+     * `from` / `to` say otherwise; a period of at most a year (400 beyond).
+     * Cloud-only route: a self-hosted instance answers 404.
+     */
+    usageSummary(options?: UsageSummaryOptions): Promise<UsageSummary>;
+    /**
+     * `GET /v1/credits/history` → one page of every movement of the balance,
+     * newest first — runs, purchases, grants, refunds, adjustments, expiries —
+     * each with the balance after it; a job's reserve row carries its model,
+     * its `charge` (the settled charge, the hold while the run is open, `0`
+     * once refunded — read that for spend, not `amount`) and its job. Filter by
+     * `kind`, `model`, `from` / `to` and `q`; pass the page's `nextCursor` (an
+     * opaque string) as `cursor` for the next page (`null` at the end).
+     * Cloud-only route: a self-hosted instance answers 404.
+     */
+    history(options?: CreditHistoryOptions): Promise<CreditHistoryPage>;
+    /**
+     * `GET /v1/credits/history?format=csv` → the whole filtered history as a
+     * CSV file (the same fields as {@link history}, one line per movement,
+     * newest first), at most 5,000 rows — the last line says when it was cut.
+     * Hand the text to the person as `credit-history.csv`.
+     */
+    exportHistory(filters?: CreditHistoryFilters): Promise<string>;
     /**
      * `POST /v1/credits/model-costs` → per-identifier credit cost, for editor
      * cost previews. Capped at the first {@link MODEL_COSTS_LIMIT} identifiers
@@ -269,4 +447,4 @@ declare class CreditsResource {
     markWelcomeOfferSeen(): Promise<WelcomeOfferSeenResult>;
 }
 
-export { type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostError, type ModelCostResult, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };
+export { type CreditHistoryEntry, type CreditHistoryFilters, type CreditHistoryJob, type CreditHistoryKind, type CreditHistoryOptions, type CreditHistoryPage, type CreditTransaction, type CreditTransactionsOptions, type CreditTransactionsPage, CreditsResource, type FreeGrantState, type ModelCostError, type ModelCostResult, type ModelCostsResult, type SignupGrantClaimResult, type SignupKeys, type UsageByCategory, type UsageByGroup, type UsageByModel, type UsageOverTime, type UsageSummary, type UsageSummaryBucket, type UsageSummaryOptions, type UsageSummaryTotals, type UserBalance, type WelcomeOfferClaimInput, type WelcomeOfferClaimResult, type WelcomeOfferSeenResult, type WelcomeOfferState };

package/dist/entries/credits.js

@@ -1,4 +1,4 @@
 import '../chunk-V4GPQ6Y2.js';
-export { CreditsResource } from '../chunk-5MOJSYHI.js';
+export { CreditsResource } from '../chunk-7QK2NXJA.js';
 //# sourceMappingURL=credits.js.map
 //# sourceMappingURL=credits.js.map

package/dist/entries/user-settings.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+require('../chunk-ISKOLJJJ.cjs');
+var chunkUIDVH3GP_cjs = require('../chunk-UIDVH3GP.cjs');
+
+
+
+Object.defineProperty(exports, "UserSettingsResource", {
+  enumerable: true,
+  get: function () { return chunkUIDVH3GP_cjs.UserSettingsResource; }
+});
+//# sourceMappingURL=user-settings.cjs.map
+//# sourceMappingURL=user-settings.cjs.map

package/dist/entries/user-settings.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"user-settings.cjs"}

package/dist/entries/user-settings.d.cts

@@ -0,0 +1,115 @@
+import { N as NodaroClientCore } from '../developer-apps-zSQXWmEG.cjs';
+import '@nodaro/shared/apps';
+import '@nodaro/shared/organizations';
+
+/**
+ * The signed-in person's own settings — the shape of `GET` / `PATCH
+ * /v1/user/settings` (`backend/src/routes/user-settings.ts`, the source of
+ * truth: keep these in sync if they change). A first-party app renders the
+ * ones it cares about (the monthly statement opt-in on a billing screen, the
+ * interface language) and sends back only the fields it changes.
+ */
+/** How `{nodeRef}` placeholders render in prompt fields. */
+type VariableDisplayMode = "raw" | "annotated" | "resolved";
+/** What double-clicking a canvas node does. */
+type NodeDoubleClickAction = "zoom" | "settings";
+/** The interface languages Nodaro ships; the server refuses any other value. */
+type UserSettingsLocale = "en" | "es" | "fr" | "de" | "pt-BR" | "ru" | "hi" | "ja" | "ko" | "zh-CN" | "he" | "ar";
+/** One of the person's own Generate Text templates. */
+interface UserTextTemplate {
+    id: string;
+    /** Up to 80 characters. */
+    label: string;
+    /** Up to 10,000 characters. */
+    systemPrompt: string;
+    defaultInput?: string;
+    /** 1–16,384. */
+    defaultMaxTokens?: number;
+    llmModel?: string;
+    reasoningEffort?: string;
+    fansOut?: boolean;
+    requiresImageRef?: boolean;
+}
+/** Per-user MCP defaults, sparse: a key left out keeps its stored value. */
+interface UserMcpPreferences {
+    image?: {
+        model?: string;
+        aspectRatio?: string;
+        resolution?: string;
+        quality?: string;
+    };
+    video?: {
+        model?: string;
+        aspectRatio?: string;
+        duration?: number;
+        resolution?: string;
+    };
+    audio?: {
+        ttsModel?: string;
+        musicModel?: string;
+    };
+    flows?: {
+        enabled?: boolean;
+    };
+}
+interface UserSettings {
+    /** The stored billing tier (`"free"`, `"basic"`, …). */
+    tier: string | null;
+    /** Whether generations are visible in the public gallery. */
+    publicOutputs: boolean;
+    /** Per-template overrides of the system prompts, by template key. */
+    promptTemplates: Record<string, string>;
+    /** The person's own Generate Text templates. */
+    textTemplates: UserTextTemplate[];
+    /** The interface language; `null` = the browser's. */
+    preferredLocale: UserSettingsLocale | null;
+    mcpPreferences: UserMcpPreferences;
+    showRecentNodes: boolean;
+    showMostUsedNodes: boolean;
+    variableDisplayMode: VariableDisplayMode;
+    nodeDoubleClickAction: NodeDoubleClickAction;
+    /** A statement of last month's credit usage by email on the 1st. Default `false`. */
+    monthlyStatementEmail: boolean;
+}
+/**
+ * What `update()` sends: only the fields to change. `promptTemplates` and
+ * `textTemplates` REPLACE the stored value whole (send the full map or list;
+ * a template key the server does not know, or a value equal to the default,
+ * is dropped); `mcpPreferences` merges one axis at a time.
+ */
+interface UserSettingsPatch {
+    /** `false` needs the Standard plan or above on Nodaro Cloud (`ForbiddenError` otherwise). */
+    publicOutputs?: boolean;
+    promptTemplates?: Record<string, string>;
+    /** Up to 100. */
+    textTemplates?: UserTextTemplate[];
+    preferredLocale?: UserSettingsLocale | null;
+    mcpPreferences?: UserMcpPreferences;
+    showRecentNodes?: boolean;
+    showMostUsedNodes?: boolean;
+    variableDisplayMode?: VariableDisplayMode;
+    nodeDoubleClickAction?: NodeDoubleClickAction;
+    monthlyStatementEmail?: boolean;
+}
+/** What `update()` answers: the settings as saved (without `tier`). */
+type UserSettingsSaved = Omit<UserSettings, "tier">;
+declare class UserSettingsResource {
+    private client;
+    constructor(client: NodaroClientCore);
+    /**
+     * `GET /v1/user/settings` → the person's own settings. Throws
+     * `UnauthorizedError` (401) when signed out, `NotFoundError` with no
+     * profile row.
+     */
+    get(): Promise<UserSettings>;
+    /**
+     * `PATCH /v1/user/settings` → changes the fields sent and answers the
+     * settings as saved. A `NodaroError` with status 400 names an invalid
+     * value (`validation_error`), or says so for a patch with nothing to
+     * change; `ForbiddenError` for `publicOutputs: false` below the Standard
+     * plan; `NotFoundError` with no profile row.
+     */
+    update(patch: UserSettingsPatch): Promise<UserSettingsSaved>;
+}
+
+export { type NodeDoubleClickAction, type UserMcpPreferences, type UserSettings, type UserSettingsLocale, type UserSettingsPatch, UserSettingsResource, type UserSettingsSaved, type UserTextTemplate, type VariableDisplayMode };