owostack 0.1.2 → 0.1.4

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, 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().
  */
@@ -411,4 +446,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, 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;
@@ -183,10 +268,12 @@ 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" }
         });
       }
     }
@@ -717,11 +804,13 @@ var OwostackError = class extends Error {
 export {
   BooleanHandle,
   CreditSystemHandle,
+  EntityHandle,
   Owostack,
   OwostackError,
   boolean,
   buildSyncPayload,
   creditSystem,
+  entity,
   metered,
   plan
 };

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "owostack",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "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.1.4"
   },
   "devDependencies": {
     "tsup": "^8.3.6",