@clocknext/sdk 0.16.0 → 0.18.0

package/dist/index.d.cts

@@ -342,8 +342,6 @@ interface TrackResult {
      */
     rawId?: string;
 }
-/** A preset time window, or `"custom"` for an explicit `from`/`to` range. */
-type UsageLogPeriod = "all" | "today" | "7d" | "30d" | "90d" | "custom";
 interface UsageLogListParams {
     customerId: string;
     /** Default 50, max 200. */
@@ -351,11 +349,11 @@ interface UsageLogListParams {
     /** Pass back a previous page's `nextCursor` to fetch the next page. Omit for
      *  the first page. */
     cursor?: string;
-    /** Default `"all"`. Pair `"custom"` with `from`/`to`. */
-    period?: UsageLogPeriod;
-    /** `YYYY-MM-DD`, only used when `period` is `"custom"`. */
+    /** First day to include, `YYYY-MM-DD` (UTC). The whole day is included.
+     *  Keep sending the same value while paging with `cursor`. */
     from?: string;
-    /** `YYYY-MM-DD`, only used when `period` is `"custom"`. */
+    /** Last day to include, `YYYY-MM-DD` (UTC). The whole day is included.
+     *  Must not be before `from`. */
     to?: string;
 }
 interface UsageLogAppliedRule {
@@ -381,13 +379,14 @@ interface UsageLogOutcomeAttribution {
  * One row of a customer's usage history, merged from every meter kind
  * (`UsageLog`, `UnitUsageLog`, completed composite occurrences) into one
  * feed and sorted by time — the same rows the customer portal's own "Usage
- * logs" table shows. `model`, `credit`, `outcome`, `unit` and `composite` are
- * each `null` unless `kind` matches that group.
+ * logs" table shows. `credit`, `outcome`, `unit` and `composite` are each
+ * `null` unless `type` matches that group.
  */
 interface UsageLogEntry {
     id: string;
     createdAt: string;
-    kind: "credit" | "outcome" | "unit" | "wallet" | "composite";
+    /** Which meter this row is. */
+    type: "credit" | "outcome" | "unit" | "wallet" | "composite";
     status: SignalStatus;
     typeName: string | null;
     member: string | null;
@@ -408,23 +407,26 @@ interface UsageLogEntry {
         providedCost: string;
         customerCost: string;
     };
-    /** Populated only when `kind === "credit"`. `amount` is a formatted credit
+    /** Populated only when `type === "credit"`. `amount` is a formatted credit
      *  value, honouring the org's credit-decimals display setting. */
     credit: {
         amount: string;
         appliedRules: UsageLogAppliedRule[];
     } | null;
-    /** Populated only when `kind === "outcome"`. */
+    /** Populated only when `type === "outcome"`. */
     outcome: UsageLogOutcomeAttribution | null;
-    /** Populated only when `kind === "unit"`. `quantity` is formatted. */
+    /** Populated only when `type === "unit"`. `quantity` is formatted. */
     unit: {
         quantity: string;
     } | null;
-    /** Populated only when `kind === "composite"`. `amount` is a formatted USD
+    /** Populated only when `type === "composite"`. `amount` is a formatted USD
      *  price — the composite's flat price, read live, not stored per row. */
     composite: {
         amount: string;
     } | null;
+    /** The `custom` object sent on the signal, as sent. `null` when none was
+     *  sent, and always `null` for unit and composite rows. */
+    custom: Record<string, unknown> | null;
 }
 interface UsageLogPage {
     usageLogs: UsageLogEntry[];
@@ -713,8 +715,10 @@ interface CreatePlanInput {
 type UpdatePlanInput = Partial<CreatePlanInput>;
 /** One model line of a credit's / outcome step's pricing bundle, as returned. */
 interface ModelBundleLine {
-    /** The workspace's model row id (`id` from the Models API). */
-    orgModelId: string;
+    /** The model's id — the same one a usage signal sends as `usage.model`.
+     *  `null` only when the model was removed from the workspace after this
+     *  bundle was saved (the line keeps its name and stored price). */
+    modelId: string | null;
     /** The model's display name, filled in by the server. */
     modelName: string;
     /** Average tokens one LLM call uses on this model. */
@@ -730,7 +734,10 @@ interface ModelBundleLine {
  *  the price is the sum of their costs, worked out on the server from the
  *  models' live prices. */
 interface ModelBundleLineInput {
-    orgModelId: string;
+    /** The model's id, e.g. `"gpt-4o"` — the same one a usage signal sends as
+     *  `usage.model`. Matched ignoring case; it must be enabled in your
+     *  workspace. */
+    modelId: string;
     /** Above 0. */
     averageTokensPerLLMCall: number;
     input: number;
@@ -873,6 +880,42 @@ interface CreateUnitInput {
 }
 /** `units.update()` body — PARTIAL. `tiers`, when sent, is the complete list. */
 type UpdateUnitInput = Partial<CreateUnitInput>;
+/** How a tax applies: `"inclusive"` — already inside the price;
+ *  `"exclusive"` — added on top. Lower case only. */
+type TaxBehavior = "inclusive" | "exclusive";
+/** A tax rate, charged to customers whose billing country matches. */
+interface Tax {
+    id: string;
+    /** Shown on invoices. Unique among active taxes in the same country,
+     *  ignoring case. */
+    name: string;
+    /** A note for your team; not shown to customers. */
+    description: string | null;
+    /** 0–100. */
+    percentage: number;
+    /** ISO 3166-1 alpha-2, upper case (e.g. `"IN"`). */
+    countryCode: string;
+    behavior: TaxBehavior;
+    /** `false` once archived in the dashboard (Settings → Taxes): it no longer
+     *  applies to new invoices. */
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** `taxes.create()` body. */
+interface CreateTaxInput {
+    /** 1–100 characters. */
+    name: string;
+    /** 0–100. */
+    percentage: number;
+    /** ISO 3166-1 alpha-2 (lower case is accepted). A country name is refused. */
+    countryCode: string;
+    behavior: TaxBehavior;
+    /** Up to 500 characters. */
+    description?: string | null;
+}
+/** `taxes.update()` body — PARTIAL: only the fields you send change. */
+type UpdateTaxInput = Partial<CreateTaxInput>;
 /** A catalogue item a composite wraps. */
 interface CompositeItem {
     id: string;
@@ -2206,6 +2249,34 @@ declare class Units {
     unarchive(id: string): Promise<Unit>;
 }
 
+/**
+ * The `taxes` resource — the tax rates charged to customers by billing
+ * country (the same rates as Settings → Taxes). `/api/v1/taxes`.
+ *
+ * Every active tax for a customer's country is applied to their invoices and
+ * portal purchases automatically. There is no `delete()`, `archive()` or
+ * `unarchive()` — archiving and restoring a tax is done in the dashboard.
+ */
+declare class Taxes {
+    private readonly transport;
+    constructor(transport: Transport);
+    /** List them, oldest first. `{ active: true }` returns only active ones,
+     *  `{ active: false }` only archived ones; omit it for both. */
+    list(params?: {
+        active?: boolean;
+    }): Promise<Tax[]>;
+    /** One tax. */
+    get(id: string): Promise<Tax>;
+    /** Create one. It starts active. Two active taxes can't share a name
+     *  (ignoring case) in the same country — that's a `ConflictError`. Not
+     *  retried on failure — a retry could create a second row. */
+    create(input: CreateTaxInput): Promise<Tax>;
+    /** PARTIAL update: only the fields you send change. Archived taxes can be
+     *  edited and stay archived. Only invoices issued afterwards use the new
+     *  values. */
+    update(id: string, input: UpdateTaxInput): Promise<Tax>;
+}
+
 /**
  * The ClockNext client.
  *
@@ -2238,6 +2309,8 @@ declare class ClockNext {
     readonly units: Units;
     /** Composites: list, get, create, update, archive, unarchive (no delete). */
     readonly composites: Composites;
+    /** Tax rates by country: list, get, create, update (archive in the dashboard). */
+    readonly taxes: Taxes;
     /** Subscribe customers to plans (purchases). */
     readonly purchases: Purchases;
     /** Read invoices and mint hosted pay links. */
@@ -2333,4 +2406,4 @@ declare class NetworkError extends ClockNextError {
     });
 }
 
-export { type AddMemberInput, type AdjustResult, AllowanceError, type ApiCustomer, AuthError, type BillingCycle, type BillingMode, ClockNext, type ClockNextConfig, ClockNextError, type ClockNextErrorCode, type ComponentType, type Composite, type CompositeAdjustInput, type CompositeBalance, type CompositeCompletionInput, type CompositeCompletionResult, type CompositeItem, type CompositeTag, ConflictError, type CreateCompositeInput, type CreateCreditInput, type CreateCustomerInput, type CreateOutcomeInput, type CreatePlanInput, type CreatePurchaseInput, type CreateUnitInput, type Credit, type CreditAdjustInput, type CreditBalance, type CreditInput, type CreditSignal, type CustomerBalances, type CustomerList, type CustomerPlan, type CustomerPlanDetails, type CustomerProfileInput, type CustomerRef, type DropReason, type FetchLike, ForbiddenError, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListRow, type InvoiceParty, type InvoicePlanSnapshot, type InvoiceStatus, type Logger, type Member, type MemberProfile, type ModelBundleLine, type ModelBundleLineInput, NetworkError, NotFoundError, type Outcome, type OutcomeAdjustInput, type OutcomeBalance, type OutcomeCompletionInput, type OutcomeCompletionResult, type OutcomeInput, type OutcomeSignal, type OutcomeStep, type OutcomeStepInput, type OutcomeWithSteps, type PayLink, type PaymentDetail, type PaymentRow, type Plan, type PlanComponent, type PlanEntitlement, type PlanEntitlementInput, PlanError, type PlanKind, type PlanRef, type PlanType, type PortalToken, type PortalTokenInput, type Purchase, type PurchaseDetail, type PurchaseStatus, RateLimitError, type RecurringGrantInput, type RecurringGrantResult, type RemovedMember, type SerializedOutcomeAttribution, type SerializedRuleApplication, type SerializedUnitUsage, type SerializedUsageLog, ServerError, type Signal, type SignalDelivery, type SignalStatus, type SignalType, type Tokens, type TrackResult, type Unit, type UnitAdjustInput, type UnitBalance, type UnitInput, type UnitPricingType, type UnitTier, type UnitTrackResult, type UpdateCompositeInput, type UpdateCreditInput, type UpdateMemberInput, type UpdateOutcomeInput, type UpdatePlanInput, type UpdateUnitInput, type UsageBalance, type UsageLogAppliedRule, type UsageLogEntry, type UsageLogListParams, type UsageLogOutcomeAttribution, type UsageLogPage, type UsageLogPeriod, ValidationError, type WalletAdjustInput, type WalletInput, type WalletPool, type WalletSignal, signalToWire };
+export { type AddMemberInput, type AdjustResult, AllowanceError, type ApiCustomer, AuthError, type BillingCycle, type BillingMode, ClockNext, type ClockNextConfig, ClockNextError, type ClockNextErrorCode, type ComponentType, type Composite, type CompositeAdjustInput, type CompositeBalance, type CompositeCompletionInput, type CompositeCompletionResult, type CompositeItem, type CompositeTag, ConflictError, type CreateCompositeInput, type CreateCreditInput, type CreateCustomerInput, type CreateOutcomeInput, type CreatePlanInput, type CreatePurchaseInput, type CreateTaxInput, type CreateUnitInput, type Credit, type CreditAdjustInput, type CreditBalance, type CreditInput, type CreditSignal, type CustomerBalances, type CustomerList, type CustomerPlan, type CustomerPlanDetails, type CustomerProfileInput, type CustomerRef, type DropReason, type FetchLike, ForbiddenError, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListRow, type InvoiceParty, type InvoicePlanSnapshot, type InvoiceStatus, type Logger, type Member, type MemberProfile, type ModelBundleLine, type ModelBundleLineInput, NetworkError, NotFoundError, type Outcome, type OutcomeAdjustInput, type OutcomeBalance, type OutcomeCompletionInput, type OutcomeCompletionResult, type OutcomeInput, type OutcomeSignal, type OutcomeStep, type OutcomeStepInput, type OutcomeWithSteps, type PayLink, type PaymentDetail, type PaymentRow, type Plan, type PlanComponent, type PlanEntitlement, type PlanEntitlementInput, PlanError, type PlanKind, type PlanRef, type PlanType, type PortalToken, type PortalTokenInput, type Purchase, type PurchaseDetail, type PurchaseStatus, RateLimitError, type RecurringGrantInput, type RecurringGrantResult, type RemovedMember, type SerializedOutcomeAttribution, type SerializedRuleApplication, type SerializedUnitUsage, type SerializedUsageLog, ServerError, type Signal, type SignalDelivery, type SignalStatus, type SignalType, type Tax, type TaxBehavior, type Tokens, type TrackResult, type Unit, type UnitAdjustInput, type UnitBalance, type UnitInput, type UnitPricingType, type UnitTier, type UnitTrackResult, type UpdateCompositeInput, type UpdateCreditInput, type UpdateMemberInput, type UpdateOutcomeInput, type UpdatePlanInput, type UpdateTaxInput, type UpdateUnitInput, type UsageBalance, type UsageLogAppliedRule, type UsageLogEntry, type UsageLogListParams, type UsageLogOutcomeAttribution, type UsageLogPage, ValidationError, type WalletAdjustInput, type WalletInput, type WalletPool, type WalletSignal, signalToWire };

package/dist/index.d.ts

@@ -342,8 +342,6 @@ interface TrackResult {
      */
     rawId?: string;
 }
-/** A preset time window, or `"custom"` for an explicit `from`/`to` range. */
-type UsageLogPeriod = "all" | "today" | "7d" | "30d" | "90d" | "custom";
 interface UsageLogListParams {
     customerId: string;
     /** Default 50, max 200. */
@@ -351,11 +349,11 @@ interface UsageLogListParams {
     /** Pass back a previous page's `nextCursor` to fetch the next page. Omit for
      *  the first page. */
     cursor?: string;
-    /** Default `"all"`. Pair `"custom"` with `from`/`to`. */
-    period?: UsageLogPeriod;
-    /** `YYYY-MM-DD`, only used when `period` is `"custom"`. */
+    /** First day to include, `YYYY-MM-DD` (UTC). The whole day is included.
+     *  Keep sending the same value while paging with `cursor`. */
     from?: string;
-    /** `YYYY-MM-DD`, only used when `period` is `"custom"`. */
+    /** Last day to include, `YYYY-MM-DD` (UTC). The whole day is included.
+     *  Must not be before `from`. */
     to?: string;
 }
 interface UsageLogAppliedRule {
@@ -381,13 +379,14 @@ interface UsageLogOutcomeAttribution {
  * One row of a customer's usage history, merged from every meter kind
  * (`UsageLog`, `UnitUsageLog`, completed composite occurrences) into one
  * feed and sorted by time — the same rows the customer portal's own "Usage
- * logs" table shows. `model`, `credit`, `outcome`, `unit` and `composite` are
- * each `null` unless `kind` matches that group.
+ * logs" table shows. `credit`, `outcome`, `unit` and `composite` are each
+ * `null` unless `type` matches that group.
  */
 interface UsageLogEntry {
     id: string;
     createdAt: string;
-    kind: "credit" | "outcome" | "unit" | "wallet" | "composite";
+    /** Which meter this row is. */
+    type: "credit" | "outcome" | "unit" | "wallet" | "composite";
     status: SignalStatus;
     typeName: string | null;
     member: string | null;
@@ -408,23 +407,26 @@ interface UsageLogEntry {
         providedCost: string;
         customerCost: string;
     };
-    /** Populated only when `kind === "credit"`. `amount` is a formatted credit
+    /** Populated only when `type === "credit"`. `amount` is a formatted credit
      *  value, honouring the org's credit-decimals display setting. */
     credit: {
         amount: string;
         appliedRules: UsageLogAppliedRule[];
     } | null;
-    /** Populated only when `kind === "outcome"`. */
+    /** Populated only when `type === "outcome"`. */
     outcome: UsageLogOutcomeAttribution | null;
-    /** Populated only when `kind === "unit"`. `quantity` is formatted. */
+    /** Populated only when `type === "unit"`. `quantity` is formatted. */
     unit: {
         quantity: string;
     } | null;
-    /** Populated only when `kind === "composite"`. `amount` is a formatted USD
+    /** Populated only when `type === "composite"`. `amount` is a formatted USD
      *  price — the composite's flat price, read live, not stored per row. */
     composite: {
         amount: string;
     } | null;
+    /** The `custom` object sent on the signal, as sent. `null` when none was
+     *  sent, and always `null` for unit and composite rows. */
+    custom: Record<string, unknown> | null;
 }
 interface UsageLogPage {
     usageLogs: UsageLogEntry[];
@@ -713,8 +715,10 @@ interface CreatePlanInput {
 type UpdatePlanInput = Partial<CreatePlanInput>;
 /** One model line of a credit's / outcome step's pricing bundle, as returned. */
 interface ModelBundleLine {
-    /** The workspace's model row id (`id` from the Models API). */
-    orgModelId: string;
+    /** The model's id — the same one a usage signal sends as `usage.model`.
+     *  `null` only when the model was removed from the workspace after this
+     *  bundle was saved (the line keeps its name and stored price). */
+    modelId: string | null;
     /** The model's display name, filled in by the server. */
     modelName: string;
     /** Average tokens one LLM call uses on this model. */
@@ -730,7 +734,10 @@ interface ModelBundleLine {
  *  the price is the sum of their costs, worked out on the server from the
  *  models' live prices. */
 interface ModelBundleLineInput {
-    orgModelId: string;
+    /** The model's id, e.g. `"gpt-4o"` — the same one a usage signal sends as
+     *  `usage.model`. Matched ignoring case; it must be enabled in your
+     *  workspace. */
+    modelId: string;
     /** Above 0. */
     averageTokensPerLLMCall: number;
     input: number;
@@ -873,6 +880,42 @@ interface CreateUnitInput {
 }
 /** `units.update()` body — PARTIAL. `tiers`, when sent, is the complete list. */
 type UpdateUnitInput = Partial<CreateUnitInput>;
+/** How a tax applies: `"inclusive"` — already inside the price;
+ *  `"exclusive"` — added on top. Lower case only. */
+type TaxBehavior = "inclusive" | "exclusive";
+/** A tax rate, charged to customers whose billing country matches. */
+interface Tax {
+    id: string;
+    /** Shown on invoices. Unique among active taxes in the same country,
+     *  ignoring case. */
+    name: string;
+    /** A note for your team; not shown to customers. */
+    description: string | null;
+    /** 0–100. */
+    percentage: number;
+    /** ISO 3166-1 alpha-2, upper case (e.g. `"IN"`). */
+    countryCode: string;
+    behavior: TaxBehavior;
+    /** `false` once archived in the dashboard (Settings → Taxes): it no longer
+     *  applies to new invoices. */
+    isActive: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+/** `taxes.create()` body. */
+interface CreateTaxInput {
+    /** 1–100 characters. */
+    name: string;
+    /** 0–100. */
+    percentage: number;
+    /** ISO 3166-1 alpha-2 (lower case is accepted). A country name is refused. */
+    countryCode: string;
+    behavior: TaxBehavior;
+    /** Up to 500 characters. */
+    description?: string | null;
+}
+/** `taxes.update()` body — PARTIAL: only the fields you send change. */
+type UpdateTaxInput = Partial<CreateTaxInput>;
 /** A catalogue item a composite wraps. */
 interface CompositeItem {
     id: string;
@@ -2206,6 +2249,34 @@ declare class Units {
     unarchive(id: string): Promise<Unit>;
 }
 
+/**
+ * The `taxes` resource — the tax rates charged to customers by billing
+ * country (the same rates as Settings → Taxes). `/api/v1/taxes`.
+ *
+ * Every active tax for a customer's country is applied to their invoices and
+ * portal purchases automatically. There is no `delete()`, `archive()` or
+ * `unarchive()` — archiving and restoring a tax is done in the dashboard.
+ */
+declare class Taxes {
+    private readonly transport;
+    constructor(transport: Transport);
+    /** List them, oldest first. `{ active: true }` returns only active ones,
+     *  `{ active: false }` only archived ones; omit it for both. */
+    list(params?: {
+        active?: boolean;
+    }): Promise<Tax[]>;
+    /** One tax. */
+    get(id: string): Promise<Tax>;
+    /** Create one. It starts active. Two active taxes can't share a name
+     *  (ignoring case) in the same country — that's a `ConflictError`. Not
+     *  retried on failure — a retry could create a second row. */
+    create(input: CreateTaxInput): Promise<Tax>;
+    /** PARTIAL update: only the fields you send change. Archived taxes can be
+     *  edited and stay archived. Only invoices issued afterwards use the new
+     *  values. */
+    update(id: string, input: UpdateTaxInput): Promise<Tax>;
+}
+
 /**
  * The ClockNext client.
  *
@@ -2238,6 +2309,8 @@ declare class ClockNext {
     readonly units: Units;
     /** Composites: list, get, create, update, archive, unarchive (no delete). */
     readonly composites: Composites;
+    /** Tax rates by country: list, get, create, update (archive in the dashboard). */
+    readonly taxes: Taxes;
     /** Subscribe customers to plans (purchases). */
     readonly purchases: Purchases;
     /** Read invoices and mint hosted pay links. */
@@ -2333,4 +2406,4 @@ declare class NetworkError extends ClockNextError {
     });
 }
 
-export { type AddMemberInput, type AdjustResult, AllowanceError, type ApiCustomer, AuthError, type BillingCycle, type BillingMode, ClockNext, type ClockNextConfig, ClockNextError, type ClockNextErrorCode, type ComponentType, type Composite, type CompositeAdjustInput, type CompositeBalance, type CompositeCompletionInput, type CompositeCompletionResult, type CompositeItem, type CompositeTag, ConflictError, type CreateCompositeInput, type CreateCreditInput, type CreateCustomerInput, type CreateOutcomeInput, type CreatePlanInput, type CreatePurchaseInput, type CreateUnitInput, type Credit, type CreditAdjustInput, type CreditBalance, type CreditInput, type CreditSignal, type CustomerBalances, type CustomerList, type CustomerPlan, type CustomerPlanDetails, type CustomerProfileInput, type CustomerRef, type DropReason, type FetchLike, ForbiddenError, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListRow, type InvoiceParty, type InvoicePlanSnapshot, type InvoiceStatus, type Logger, type Member, type MemberProfile, type ModelBundleLine, type ModelBundleLineInput, NetworkError, NotFoundError, type Outcome, type OutcomeAdjustInput, type OutcomeBalance, type OutcomeCompletionInput, type OutcomeCompletionResult, type OutcomeInput, type OutcomeSignal, type OutcomeStep, type OutcomeStepInput, type OutcomeWithSteps, type PayLink, type PaymentDetail, type PaymentRow, type Plan, type PlanComponent, type PlanEntitlement, type PlanEntitlementInput, PlanError, type PlanKind, type PlanRef, type PlanType, type PortalToken, type PortalTokenInput, type Purchase, type PurchaseDetail, type PurchaseStatus, RateLimitError, type RecurringGrantInput, type RecurringGrantResult, type RemovedMember, type SerializedOutcomeAttribution, type SerializedRuleApplication, type SerializedUnitUsage, type SerializedUsageLog, ServerError, type Signal, type SignalDelivery, type SignalStatus, type SignalType, type Tokens, type TrackResult, type Unit, type UnitAdjustInput, type UnitBalance, type UnitInput, type UnitPricingType, type UnitTier, type UnitTrackResult, type UpdateCompositeInput, type UpdateCreditInput, type UpdateMemberInput, type UpdateOutcomeInput, type UpdatePlanInput, type UpdateUnitInput, type UsageBalance, type UsageLogAppliedRule, type UsageLogEntry, type UsageLogListParams, type UsageLogOutcomeAttribution, type UsageLogPage, type UsageLogPeriod, ValidationError, type WalletAdjustInput, type WalletInput, type WalletPool, type WalletSignal, signalToWire };
+export { type AddMemberInput, type AdjustResult, AllowanceError, type ApiCustomer, AuthError, type BillingCycle, type BillingMode, ClockNext, type ClockNextConfig, ClockNextError, type ClockNextErrorCode, type ComponentType, type Composite, type CompositeAdjustInput, type CompositeBalance, type CompositeCompletionInput, type CompositeCompletionResult, type CompositeItem, type CompositeTag, ConflictError, type CreateCompositeInput, type CreateCreditInput, type CreateCustomerInput, type CreateOutcomeInput, type CreatePlanInput, type CreatePurchaseInput, type CreateTaxInput, type CreateUnitInput, type Credit, type CreditAdjustInput, type CreditBalance, type CreditInput, type CreditSignal, type CustomerBalances, type CustomerList, type CustomerPlan, type CustomerPlanDetails, type CustomerProfileInput, type CustomerRef, type DropReason, type FetchLike, ForbiddenError, type Invoice, type InvoiceDetail, type InvoiceLineItem, type InvoiceListRow, type InvoiceParty, type InvoicePlanSnapshot, type InvoiceStatus, type Logger, type Member, type MemberProfile, type ModelBundleLine, type ModelBundleLineInput, NetworkError, NotFoundError, type Outcome, type OutcomeAdjustInput, type OutcomeBalance, type OutcomeCompletionInput, type OutcomeCompletionResult, type OutcomeInput, type OutcomeSignal, type OutcomeStep, type OutcomeStepInput, type OutcomeWithSteps, type PayLink, type PaymentDetail, type PaymentRow, type Plan, type PlanComponent, type PlanEntitlement, type PlanEntitlementInput, PlanError, type PlanKind, type PlanRef, type PlanType, type PortalToken, type PortalTokenInput, type Purchase, type PurchaseDetail, type PurchaseStatus, RateLimitError, type RecurringGrantInput, type RecurringGrantResult, type RemovedMember, type SerializedOutcomeAttribution, type SerializedRuleApplication, type SerializedUnitUsage, type SerializedUsageLog, ServerError, type Signal, type SignalDelivery, type SignalStatus, type SignalType, type Tax, type TaxBehavior, type Tokens, type TrackResult, type Unit, type UnitAdjustInput, type UnitBalance, type UnitInput, type UnitPricingType, type UnitTier, type UnitTrackResult, type UpdateCompositeInput, type UpdateCreditInput, type UpdateMemberInput, type UpdateOutcomeInput, type UpdatePlanInput, type UpdateTaxInput, type UpdateUnitInput, type UsageBalance, type UsageLogAppliedRule, type UsageLogEntry, type UsageLogListParams, type UsageLogOutcomeAttribution, type UsageLogPage, ValidationError, type WalletAdjustInput, type WalletInput, type WalletPool, type WalletSignal, signalToWire };

package/dist/index.js

@@ -331,7 +331,7 @@ function sleep(ms) {
 }
 
 // src/http.ts
-var SDK_VERSION = "0.16.0" ;
+var SDK_VERSION = "0.18.0" ;
 var Transport = class {
   constructor(cfg) {
     this.cfg = cfg;
@@ -1439,7 +1439,6 @@ var Signals = class {
         customerId: params.customerId,
         limit: params.limit,
         cursor: params.cursor,
-        period: params.period,
         from: params.from,
         to: params.to
       }
@@ -1511,6 +1510,54 @@ var Units = class {
   }
 };
 
+// src/resources/taxes.ts
+var Taxes = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /** List them, oldest first. `{ active: true }` returns only active ones,
+   *  `{ active: false }` only archived ones; omit it for both. */
+  async list(params = {}) {
+    const res = await this.transport.request({
+      method: "GET",
+      path: "/api/v1/taxes",
+      query: { active: activeQuery(params.active) }
+    });
+    return filterByActive(res.taxes, params.active);
+  }
+  /** One tax. */
+  async get(id) {
+    const res = await this.transport.request({
+      method: "GET",
+      path: `/api/v1/taxes/${encodeURIComponent(id)}`
+    });
+    return res.tax;
+  }
+  /** Create one. It starts active. Two active taxes can't share a name
+   *  (ignoring case) in the same country — that's a `ConflictError`. Not
+   *  retried on failure — a retry could create a second row. */
+  async create(input) {
+    const res = await this.transport.request({
+      method: "POST",
+      path: "/api/v1/taxes",
+      body: input
+    });
+    return res.tax;
+  }
+  /** PARTIAL update: only the fields you send change. Archived taxes can be
+   *  edited and stay archived. Only invoices issued afterwards use the new
+   *  values. */
+  async update(id, input) {
+    const res = await this.transport.request({
+      method: "PATCH",
+      path: `/api/v1/taxes/${encodeURIComponent(id)}`,
+      body: input
+    });
+    return res.tax;
+  }
+};
+
 // src/client.ts
 var ClockNext = class {
   /** Record usage signals (credit / wallet / outcome / unit) and read the usage log. */
@@ -1527,6 +1574,8 @@ var ClockNext = class {
   units;
   /** Composites: list, get, create, update, archive, unarchive (no delete). */
   composites;
+  /** Tax rates by country: list, get, create, update (archive in the dashboard). */
+  taxes;
   /** Subscribe customers to plans (purchases). */
   purchases;
   /** Read invoices and mint hosted pay links. */
@@ -1553,6 +1602,7 @@ var ClockNext = class {
     this.outcomes = new Outcomes(transport);
     this.units = new Units(transport);
     this.composites = new Composites(transport);
+    this.taxes = new Taxes(transport);
     this.purchases = new Purchases(transport);
     this.invoices = new Invoices(transport);
     this.payments = new Payments(transport);