meterflow 0.5.0 → 0.5.1

package/dist/index.cjs

@@ -35,7 +35,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.5.0";
+var version = "0.5.1";
 
 // src/errors.ts
 var MeterFlowError = class extends Error {
@@ -276,6 +276,15 @@ var UsageResource = class {
       ...opts?.idempotencyKey !== void 0 && { idempotencyKey: opts.idempotencyKey }
     });
   }
+  /**
+   * Read one recorded event back, including `billing_outcome` — what the worker decided to bill
+   * for it, or why it billed nothing (`no_subscription`, `no_meter_limit`, `not_metered`,
+   * `within_allowance`, `not_deducted`). It is `null` while `processed` is false: the worker runs
+   * after `record` answers, so poll this when you need to know what happened to a charge.
+   */
+  event(eventId) {
+    return this.client.request("GET", `usage/events/${encodeURIComponent(eventId)}`);
+  }
   summary(customerId, query) {
     return this.client.request("GET", `usage/${encodeURIComponent(customerId)}`, {
       ...query !== void 0 && { query }

package/dist/index.js

@@ -35,7 +35,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // package.json
-var version = "0.5.0";
+var version = "0.5.1";
 
 // src/errors.ts
 var MeterFlowError = class extends Error {
@@ -276,6 +276,15 @@ var UsageResource = class {
       ...opts?.idempotencyKey !== void 0 && { idempotencyKey: opts.idempotencyKey }
     });
   }
+  /**
+   * Read one recorded event back, including `billing_outcome` — what the worker decided to bill
+   * for it, or why it billed nothing (`no_subscription`, `no_meter_limit`, `not_metered`,
+   * `within_allowance`, `not_deducted`). It is `null` while `processed` is false: the worker runs
+   * after `record` answers, so poll this when you need to know what happened to a charge.
+   */
+  event(eventId) {
+    return this.client.request("GET", `usage/events/${encodeURIComponent(eventId)}`);
+  }
   summary(customerId, query) {
     return this.client.request("GET", `usage/${encodeURIComponent(customerId)}`, {
       ...query !== void 0 && { query }

package/dist/index.mjs

@@ -1,5 +1,5 @@
 // package.json
-var version = "0.5.0";
+var version = "0.5.1";
 
 // src/errors.ts
 var MeterFlowError = class extends Error {
@@ -240,6 +240,15 @@ var UsageResource = class {
       ...opts?.idempotencyKey !== void 0 && { idempotencyKey: opts.idempotencyKey }
     });
   }
+  /**
+   * Read one recorded event back, including `billing_outcome` — what the worker decided to bill
+   * for it, or why it billed nothing (`no_subscription`, `no_meter_limit`, `not_metered`,
+   * `within_allowance`, `not_deducted`). It is `null` while `processed` is false: the worker runs
+   * after `record` answers, so poll this when you need to know what happened to a charge.
+   */
+  event(eventId) {
+    return this.client.request("GET", `usage/events/${encodeURIComponent(eventId)}`);
+  }
   summary(customerId, query) {
     return this.client.request("GET", `usage/${encodeURIComponent(customerId)}`, {
       ...query !== void 0 && { query }

package/dist/resources/usage.d.ts

@@ -25,6 +25,13 @@ export declare class UsageResource {
     record(body: UsageEventRequest, opts?: RecordOptions): Promise<UsageEventResponse>;
     /** Record up to `MAX_BATCH_EVENTS` events in one request. Larger arrays are rejected locally, never sent. */
     recordBatch(events: UsageEventRequest[], opts?: RecordOptions): Promise<UsageEventResponse[]>;
+    /**
+     * Read one recorded event back, including `billing_outcome` — what the worker decided to bill
+     * for it, or why it billed nothing (`no_subscription`, `no_meter_limit`, `not_metered`,
+     * `within_allowance`, `not_deducted`). It is `null` while `processed` is false: the worker runs
+     * after `record` answers, so poll this when you need to know what happened to a charge.
+     */
+    event(eventId: string): Promise<UsageEventResponse>;
     summary(customerId: string, query?: SummaryQuery): Promise<UsageSummaryResponse>;
 }
 export {};

package/dist/resources/usage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/resources/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AACpE,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AACtE,KAAK,oBAAoB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAE9C,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOlF,6GAA6G;IAC7G,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAY7F,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAKjF"}
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../../../src/resources/usage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAEnD,KAAK,iBAAiB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,mBAAmB,CAAC,CAAC;AACpE,KAAK,kBAAkB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,oBAAoB,CAAC,CAAC;AACtE,KAAK,oBAAoB,GAAG,UAAU,CAAC,SAAS,CAAC,CAAC,sBAAsB,CAAC,CAAC;AAE1E,MAAM,WAAW,aAAa;IAC5B,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;;;;GAMG;AACH,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,SAAS;IAE9C,MAAM,CAAC,IAAI,EAAE,iBAAiB,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAOlF,6GAA6G;IAC7G,WAAW,CAAC,MAAM,EAAE,iBAAiB,EAAE,EAAE,IAAI,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAY7F;;;;;OAKG;IACH,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC;IAInD,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,oBAAoB,CAAC;CAKjF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "meterflow",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "Official Node.js SDK for MeterFlow — usage-based billing, credit management, and metering.",
   "license": "MIT",
   "author": "MeterFlow",