owostack 0.1.2 → 0.2.0

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { CheckResult, PlanFeatureEntry, ResetInterval, CreditSystemDefinition, TrackResult, MeteredFeatureConfig, CatalogEntry, SyncPayload, Currency, PlanInterval, PlanDefinition, OwostackConfig, BillingUsageParams, BillingUsageResult, InvoiceParams, InvoiceResult, InvoicesParams, InvoicesResult, PayInvoiceParams, PayInvoiceResult, WalletResult, WalletSetupResult, WalletRemoveResult, SyncResult, AttachParams, AttachResult, CheckParams, TrackParams, AddonParams, AddonResult, CustomerParams, CustomerResult, AddEntityParams, AddEntityResult, RemoveEntityParams, RemoveEntityResult, ListEntitiesParams, ListEntitiesResult, PlansParams, PlansResult, PublicPlan } from '@owostack/types';
+import { CheckResult, PlanFeatureEntry, ResetInterval, CreditSystemDefinition, AddEntityResult, RemoveEntityResult, ListEntitiesResult, MeteredFeatureConfig, TrackResult, 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, BillingUsageParams, BillingUsageResult, BooleanFeatureConfig, CardInfo, CatalogEntry, CheckCode, CheckParams, CheckResult, CustomerData, CustomerParams, CustomerResult, Invoice, InvoiceLineItem, InvoiceParams, InvoiceResult, InvoicesParams, InvoicesResult, ListEntitiesParams, ListEntitiesResult, MeteredFeatureConfig, OverageDetails, OwostackConfig, PayInvoiceParams, PayInvoiceResult, PaymentMethodInfo, PlanCredits, PlanDefinition, PlanFeatureEntry, PlansParams, PlansResult, PublicPlan, PublicPlanFeature, RemoveEntityParams, RemoveEntityResult, ResponseDetails, SyncChanges, SyncPayload, SyncResult, TrackCode, TrackParams, TrackResult, WalletRemoveResult, WalletResult, WalletSetupResult } from '@owostack/types';
 
 /**
@@ -55,6 +55,41 @@ declare function metered(slug: string, opts?: {
 declare function boolean(slug: string, opts?: {
     name?: string;
 }): BooleanHandle;
+/**
+ * EntityHandle — returned by entity().
+ * Non-consumable features managed via addEntity()/removeEntity().
+ */
+declare class EntityHandle {
+    readonly slug: string;
+    readonly featureType: "metered";
+    readonly meterType: "non_consumable";
+    readonly featureName: string | undefined;
+    _client: any;
+    constructor(slug: string, name?: string);
+    check(customer: string, opts?: {
+        value?: number;
+        entity?: string;
+        sendEvent?: boolean;
+    }): Promise<CheckResult>;
+    add(customer: string, opts: {
+        entity: string;
+        name?: string;
+        email?: string;
+        metadata?: Record<string, unknown>;
+    }): Promise<AddEntityResult>;
+    remove(customer: string, entity: string): Promise<RemoveEntityResult>;
+    list(customer: string): Promise<ListEntitiesResult>;
+    limit(value: number, config?: Omit<MeteredFeatureConfig, "limit">): PlanFeatureEntry;
+    unlimited(config?: Omit<MeteredFeatureConfig, "limit">): PlanFeatureEntry;
+    config(configOpts: MeteredFeatureConfig): PlanFeatureEntry;
+}
+/**
+ * Create a non-consumable entity feature handle (seats, projects, workspaces).
+ * Managed via addEntity()/removeEntity() instead of track().
+ */
+declare function entity(slug: string, opts?: {
+    name?: string;
+}): EntityHandle;
 /**
  * CreditSystemHandle — returned by creditSystem().
  */
@@ -98,7 +133,23 @@ declare function plan(slug: string, config: {
     trialDays?: number;
     provider?: string;
     metadata?: Record<string, unknown>;
+    autoEnable?: boolean;
+    isAddon?: boolean;
 }): PlanDefinition;
+/**
+ * Create a credit pack definition.
+ * Credit packs are one-time purchases that add credits to a customer's balance.
+ */
+declare function creditPack(slug: string, config: {
+    name: string;
+    description?: string;
+    credits: number;
+    price: number;
+    currency: Currency;
+    creditSystem: string;
+    provider?: string;
+    metadata?: Record<string, unknown>;
+}): CreditPackDefinition;
 /**
  * Extract SyncPayload from catalog.
  */
@@ -411,4 +462,4 @@ declare class OwostackError extends Error {
     constructor(code: string, message: string);
 }
 
-export { BooleanHandle, CreditSystemHandle, type MeteredHandle, Owostack, OwostackError, boolean, buildSyncPayload, creditSystem, metered, plan };
+export { BooleanHandle, CreditSystemHandle, EntityHandle, type MeteredHandle, Owostack, OwostackError, boolean, buildSyncPayload, creditPack, creditSystem, entity, metered, plan };

package/dist/index.js

@@ -113,6 +113,91 @@ function boolean(slug, opts) {
   _featureRegistry.set(slug, handle);
   return handle;
 }
+var EntityHandle = class {
+  slug;
+  featureType = "metered";
+  meterType = "non_consumable";
+  featureName;
+  _client = null;
+  constructor(slug, name) {
+    this.slug = slug;
+    this.featureName = name;
+  }
+  async check(customer, opts) {
+    return FeatureMethods.check(this, customer, opts);
+  }
+  async add(customer, opts) {
+    if (!this._client) {
+      throw new Error(
+        `Feature '${this.slug}' is not bound to an Owostack client.`
+      );
+    }
+    return this._client.addEntity({
+      customer,
+      feature: this.slug,
+      ...opts
+    });
+  }
+  async remove(customer, entity2) {
+    if (!this._client) {
+      throw new Error(
+        `Feature '${this.slug}' is not bound to an Owostack client.`
+      );
+    }
+    return this._client.removeEntity({
+      customer,
+      feature: this.slug,
+      entity: entity2
+    });
+  }
+  async list(customer) {
+    if (!this._client) {
+      throw new Error(
+        `Feature '${this.slug}' is not bound to an Owostack client.`
+      );
+    }
+    return this._client.listEntities({
+      customer,
+      feature: this.slug
+    });
+  }
+  limit(value, config) {
+    return {
+      _type: "plan_feature",
+      slug: this.slug,
+      featureType: "metered",
+      name: this.featureName,
+      enabled: true,
+      config: { limit: value, reset: "never", overage: "block", ...config }
+    };
+  }
+  unlimited(config) {
+    return {
+      _type: "plan_feature",
+      slug: this.slug,
+      featureType: "metered",
+      name: this.featureName,
+      enabled: true,
+      config: { limit: null, reset: "never", overage: "block", ...config }
+    };
+  }
+  config(configOpts) {
+    const isEnabled = configOpts.enabled !== false;
+    return {
+      _type: "plan_feature",
+      slug: this.slug,
+      featureType: "metered",
+      name: this.featureName,
+      enabled: isEnabled,
+      config: { reset: "never", overage: "block", ...configOpts }
+    };
+  }
+};
+function entity(slug, opts) {
+  const handle = new EntityHandle(slug, opts?.name);
+  _featureRegistry.set(slug, handle);
+  return handle;
+}
 var CreditSystemHandle = class {
   slug;
   name;
@@ -173,6 +258,13 @@ function plan(slug, config) {
     ...config
   };
 }
+function creditPack(slug, config) {
+  return {
+    _type: "credit_pack",
+    slug,
+    ...config
+  };
+}
 function slugToName(slug) {
   return slug.split(/[-_]/).map((w) => w.charAt(0).toUpperCase() + w.slice(1)).join(" ");
 }
@@ -183,10 +275,14 @@ function buildSyncPayload(catalog, defaultProvider) {
     for (const f of entry.features) {
       if (_creditSystemRegistry.has(f.slug)) continue;
       if (!featureMap.has(f.slug)) {
+        const handle = _featureRegistry.get(f.slug);
         featureMap.set(f.slug, {
           slug: f.slug,
           type: f.featureType,
-          name: f.name || slugToName(f.slug)
+          name: f.name || slugToName(f.slug),
+          ...handle instanceof EntityHandle && {
+            meterType: "non_consumable"
+          }
         });
       }
     }
@@ -223,6 +319,8 @@ function buildSyncPayload(catalog, defaultProvider) {
     trialDays: p.trialDays ?? void 0,
     provider: p.provider ?? void 0,
     metadata: p.metadata ?? void 0,
+    autoEnable: p.autoEnable ?? void 0,
+    isAddon: p.isAddon ?? void 0,
     features: p.features.map((f) => ({
       slug: f.slug,
       enabled: f.enabled,
@@ -247,10 +345,22 @@ function buildSyncPayload(catalog, defaultProvider) {
       }
     }))
   }));
+  const creditPacks = catalog.filter((e) => e._type === "credit_pack").map((cp) => ({
+    slug: cp.slug,
+    name: cp.name,
+    description: cp.description ?? void 0,
+    credits: cp.credits,
+    price: cp.price,
+    currency: cp.currency,
+    creditSystem: cp.creditSystem,
+    provider: cp.provider ?? void 0,
+    metadata: cp.metadata ?? void 0
+  }));
   return {
     defaultProvider,
     features: Array.from(featureMap.values()),
     creditSystems,
+    creditPacks,
     plans
   };
 }
@@ -341,6 +451,7 @@ var Owostack = class {
         success: true,
         features: { created: [], updated: [], unchanged: [] },
         creditSystems: { created: [], updated: [], unchanged: [] },
+        creditPacks: { created: [], updated: [], unchanged: [] },
         plans: { created: [], updated: [], unchanged: [] },
         warnings: ["No catalog entries to sync."]
       };
@@ -717,11 +828,14 @@ var OwostackError = class extends Error {
 export {
   BooleanHandle,
   CreditSystemHandle,
+  EntityHandle,
   Owostack,
   OwostackError,
   boolean,
   buildSyncPayload,
+  creditPack,
   creditSystem,
+  entity,
   metered,
   plan
 };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "owostack",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Core SDK for Owostack billing infrastructure",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",
-    "url": "https://github.com/Abdulmumin1/owostack.git",
+    "url": "https://github.com/Abdulmumin1/owostack",
     "directory": "packages/core"
   },
   "type": "module",
@@ -30,7 +30,7 @@
     "payments"
   ],
   "dependencies": {
-    "@owostack/types": "0.1.2"
+    "@owostack/types": "0.2.0"
   },
   "devDependencies": {
     "tsup": "^8.3.6",