owostack 0.4.0 → 0.4.3

package/README.md

@@ -70,6 +70,30 @@ await owo.track({
 });
 ```
 
+### 4. Manage customer billing controls
+
+Inspect and update customer-specific overage behavior through the same `customer` namespace:
+
+```ts
+const customer = await owo.customer({
+  email: "billing@acme.com",
+  name: "Acme Corporation",
+});
+
+await owo.customer.setFeatureConfig({
+  customer: customer.id,
+  feature: "api-calls",
+  overage: "block",
+  maxOverageUnits: 1000,
+});
+
+await owo.customer.setOverageLimit({
+  customer: customer.id,
+  maxOverageAmount: 500_000,
+  onLimitReached: "block",
+});
+```
+
 ## Features
 
 - **Feature Gating**: Instant access control for boolean and metered features.

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { CheckResult, PlanFeatureEntry, ResetInterval, CreditSystemDefinition, AddEntityResult, RemoveEntityResult, ListEntitiesResult, MeteredFeatureConfig, TrackResult, PricingTier, CatalogEntry, SyncPayload, Currency, CreditPackDefinition, PlanInterval, PlanDefinition, OwostackConfig, BillingUsageParams, BillingUsageResult, InvoiceParams, InvoiceResult, InvoicesParams, InvoicesResult, PayInvoiceParams, PayInvoiceResult, WalletResult, WalletSetupResult, WalletRemoveResult, SyncResult, AttachParams, AttachResult, CheckParams, TrackParams, AddonParams, AddonResult, CustomerParams, CustomerResult, AddEntityParams, RemoveEntityParams, ListEntitiesParams, PlansParams, PlansResult, PublicPlan } from '@owostack/types';
-export { AddEntityParams, AddEntityResult, AddonParams, AddonResult, AttachParams, AttachResult, BillingFeatureUsage, BillingTierBreakdown, BillingUsageParams, BillingUsageResult, BooleanFeatureConfig, CardInfo, CatalogEntry, CheckCode, CheckParams, CheckResult, CreditPlanBalance, CreditSystemBalanceDetails, CreditsBalanceDetails, CurrentPricingTier, CustomerData, CustomerParams, CustomerResult, Invoice, InvoiceLineItem, InvoiceParams, InvoiceResult, InvoicesParams, InvoicesResult, ListEntitiesParams, ListEntitiesResult, MeteredFeatureConfig, OverageDetails, OwostackConfig, PayInvoiceParams, PayInvoiceResult, PaymentMethodInfo, PlanDefinition, PlanFeatureEntry, PlansParams, PlansResult, PrepaidBalanceDetails, PricingDetails, PricingTier, PublicPlan, PublicPlanFeature, RatingModel, RemoveEntityParams, RemoveEntityResult, ResponseDetails, SyncChanges, SyncPayload, SyncResult, TrackCode, TrackParams, TrackResult, WalletRemoveResult, WalletResult, WalletSetupResult } from '@owostack/types';
+import { CheckResult, PlanFeatureEntry, ResetInterval, CreditSystemDefinition, AddEntityResult, RemoveEntityResult, ListEntitiesResult, MeteredFeatureConfig, TrackResult, PricingTier, CatalogEntry, SyncPayload, Currency, CreditPackDefinition, PlanInterval, PlanDefinition, OwostackConfig, BillingUsageParams, BillingUsageResult, InvoiceParams, InvoiceResult, InvoicesParams, InvoicesResult, PayInvoiceParams, PayInvoiceResult, WalletResult, WalletSetupResult, WalletRemoveResult, CustomerParams, CustomerResult, SetCustomerFeatureConfigParams, SetCustomerOverageLimitParams, UsageHistoryParams, UsageHistoryResult, SyncResult, AttachParams, AttachResult, CheckParams, TrackParams, AddonParams, AddonResult, AddEntityParams, RemoveEntityParams, ListEntitiesParams, PlansParams, PlansResult, PublicPlan } from '@owostack/types';
+export { AddEntityParams, AddEntityResult, AddonParams, AddonResult, AttachParams, AttachResult, BillingFeatureUsage, BillingTierBreakdown, BillingUsageParams, BillingUsageResult, BooleanFeatureConfig, CardInfo, CatalogEntry, CheckCode, CheckParams, CheckResult, CreditPlanBalance, CreditSystemBalanceDetails, CreditsBalanceDetails, CurrentPricingTier, CustomerBillingConfig, CustomerData, CustomerFeatureConfigResult, CustomerOverageLimitResult, CustomerParams, CustomerResult, Invoice, InvoiceLineItem, InvoiceParams, InvoiceResult, InvoicesParams, InvoicesResult, ListEntitiesParams, ListEntitiesResult, MeteredFeatureConfig, OverageDetails, OwostackConfig, PayInvoiceParams, PayInvoiceResult, PaymentMethodInfo, PlanDefinition, PlanFeatureEntry, PlansParams, PlansResult, PrepaidBalanceDetails, PricingDetails, PricingTier, PublicPlan, PublicPlanFeature, RatingModel, RemoveEntityParams, RemoveEntityResult, ResponseDetails, SetCustomerFeatureConfigParams, SetCustomerOverageLimitParams, SyncChanges, SyncPayload, SyncResult, TrackCode, TrackParams, TrackResult, UsageHistoryParams, UsageHistoryResult, WalletRemoveResult, WalletResult, WalletSetupResult } from '@owostack/types';
 
 /**
  * BooleanHandle — returned by boolean().
@@ -183,6 +183,8 @@ declare class Owostack {
     readonly billing: BillingNamespace;
     /** Wallet: payment methods — callable + namespace */
     readonly wallet: WalletFn;
+    /** Customer: create/resolve + billing config management */
+    readonly customer: CustomerFn;
     constructor(config: OwostackConfig);
     private resolveApiUrl;
     /**
@@ -290,26 +292,6 @@ declare class Owostack {
      * ```
      */
     addon(params: AddonParams): Promise<AddonResult>;
-    /**
-     * customer() - Create or resolve a customer
-     *
-     * Creates a new customer or resolves an existing one by email or ID.
-     * If customerData is provided and customer doesn't exist, creates a new customer.
-     *
-     * @example
-     * ```ts
-     * // Create new customer
-     * const customer = await owo.customer({
-     *   email: 'org@acme.com',
-     *   name: 'Acme Corp',
-     *   metadata: { plan: 'enterprise' }
-     * });
-     *
-     * // Get existing customer
-     * const existing = await owo.customer({ email: 'org@acme.com' });
-     * ```
-     */
-    customer(params: CustomerParams): Promise<CustomerResult>;
     /**
      * addEntity() - Add a feature entity (e.g., seat)
      *
@@ -395,6 +377,12 @@ type PlansFn = {
     (params?: PlansParams): Promise<PlansResult>;
     get(slug: string): Promise<PublicPlan>;
 };
+type CustomerFn = {
+    (params: CustomerParams): Promise<CustomerResult>;
+    setFeatureConfig(params: SetCustomerFeatureConfigParams): Promise<CustomerResult>;
+    setOverageLimit(params: SetCustomerOverageLimitParams): Promise<CustomerResult>;
+    usageHistory(params: UsageHistoryParams): Promise<UsageHistoryResult>;
+};
 type WalletFn = {
     (customer: string): Promise<WalletResult>;
     setup(customer: string, opts?: {

package/dist/index.js

@@ -574,11 +574,14 @@ var Owostack = class {
   billing;
   /** Wallet: payment methods — callable + namespace */
   wallet;
+  /** Customer: create/resolve + billing config management */
+  customer;
   constructor(config) {
     this._config = config;
     this.apiUrl = this.resolveApiUrl(config);
     this.billing = new BillingNamespace(this);
     this.wallet = buildWalletFn(this);
+    this.customer = buildCustomerFn(this);
     this.plans = buildPlansFn(this);
     if (config.catalog && config.catalog.length > 0) {
       bindFeatureHandles(this, config.catalog);
@@ -735,29 +738,6 @@ var Owostack = class {
     const response = await this.post("/addon", params);
     return response;
   }
-  /**
-   * customer() - Create or resolve a customer
-   *
-   * Creates a new customer or resolves an existing one by email or ID.
-   * If customerData is provided and customer doesn't exist, creates a new customer.
-   *
-   * @example
-   * ```ts
-   * // Create new customer
-   * const customer = await owo.customer({
-   *   email: 'org@acme.com',
-   *   name: 'Acme Corp',
-   *   metadata: { plan: 'enterprise' }
-   * });
-   *
-   * // Get existing customer
-   * const existing = await owo.customer({ email: 'org@acme.com' });
-   * ```
-   */
-  async customer(params) {
-    const response = await this.post("/customers", params);
-    return response;
-  }
   /**
    * addEntity() - Add a feature entity (e.g., seat)
    *
@@ -950,6 +930,26 @@ function buildPlansFn(client) {
   };
   return fn;
 }
+function buildCustomerFn(client) {
+  const fn = ((params) => client.post("/customers", params));
+  fn.setFeatureConfig = (params) => client.post("/customers/feature-config", params);
+  fn.setOverageLimit = (params) => client.post("/customers/overage-limit", params);
+  fn.usageHistory = (params) => {
+    const query = {};
+    if (params.range) query.range = params.range;
+    if (params.granularity) query.granularity = params.granularity;
+    if (params.feature) query.feature = params.feature;
+    if (params.groupBy) query.groupBy = params.groupBy;
+    if (params.timezone) query.timezone = params.timezone;
+    if (params.from) query.from = params.from;
+    if (params.to) query.to = params.to;
+    return client.get(
+      `/customers/${encodeURIComponent(params.customer)}/usage/history`,
+      query
+    );
+  };
+  return fn;
+}
 function buildWalletFn(client) {
   const fn = ((customer) => client.get("/wallet", { customer }));
   fn.setup = (customer, opts) => client.post("/wallet/setup", {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "owostack",
-  "version": "0.4.0",
+  "version": "0.4.3",
   "description": "Core SDK for Owostack billing infrastructure",
   "license": "Apache-2.0",
   "repository": {
@@ -30,7 +30,7 @@
     "payments"
   ],
   "dependencies": {
-    "@owostack/types": "0.4.0"
+    "@owostack/types": "0.4.3"
   },
   "devDependencies": {
     "tsup": "^8.3.6",