@paygentic/sdk 0.8.1 → 0.8.3

package/dist/esm/models/operations/ingestevent.js

@@ -3,16 +3,40 @@
  */
 import * as z from "zod/v3";
 /** @internal */
-export const IngestEventRequest$outboundSchema = z.object({
+export const IngestEventRequestBody2$outboundSchema = z.object({
+    type: z.string(),
+    source: z.string(),
+    subject: z.string().optional(),
+    externalSubject: z.string(),
+    namespace: z.string().optional(),
+    timestamp: z.date().transform(v => v.toISOString()).optional(),
+    idempotencyKey: z.string().optional(),
+    externalId: z.string().optional(),
+    data: z.record(z.any()),
+});
+export function ingestEventRequestBody2ToJSON(ingestEventRequestBody2) {
+    return JSON.stringify(IngestEventRequestBody2$outboundSchema.parse(ingestEventRequestBody2));
+}
+/** @internal */
+export const IngestEventRequestBody1$outboundSchema = z.object({
     type: z.string(),
     source: z.string(),
     subject: z.string(),
+    externalSubject: z.string().optional(),
     namespace: z.string().optional(),
     timestamp: z.date().transform(v => v.toISOString()).optional(),
     idempotencyKey: z.string().optional(),
     externalId: z.string().optional(),
     data: z.record(z.any()),
 });
+export function ingestEventRequestBody1ToJSON(ingestEventRequestBody1) {
+    return JSON.stringify(IngestEventRequestBody1$outboundSchema.parse(ingestEventRequestBody1));
+}
+/** @internal */
+export const IngestEventRequest$outboundSchema = z.union([
+    z.lazy(() => IngestEventRequestBody1$outboundSchema),
+    z.lazy(() => IngestEventRequestBody2$outboundSchema),
+]);
 export function ingestEventRequestToJSON(ingestEventRequest) {
     return JSON.stringify(IngestEventRequest$outboundSchema.parse(ingestEventRequest));
 }

package/dist/esm/models/operations/ingestevent.js.map

@@ -1 +1 @@
-{"version":3,"file":"ingestevent.js","sourceRoot":"","sources":["../../../../src/models/operations/ingestevent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAiD5B,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAI1C,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,kBAAsC;IAEtC,OAAO,IAAI,CAAC,SAAS,CACnB,iCAAiC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAC5D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ingestevent.js","sourceRoot":"","sources":["../../../../src/models/operations/ingestevent.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAiG5B,gBAAgB;AAChB,MAAM,CAAC,MAAM,sCAAsC,GAI/C,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE;IAC3B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,6BAA6B,CAC3C,uBAAgD;IAEhD,OAAO,IAAI,CAAC,SAAS,CACnB,sCAAsC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACtE,CAAC;AACJ,CAAC;AAeD,gBAAgB;AAChB,MAAM,CAAC,MAAM,sCAAsC,GAI/C,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,SAAS,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC9D,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,EAAE,CAAC;CACxB,CAAC,CAAC;AAEH,MAAM,UAAU,6BAA6B,CAC3C,uBAAgD;IAEhD,OAAO,IAAI,CAAC,SAAS,CACnB,sCAAsC,CAAC,KAAK,CAAC,uBAAuB,CAAC,CACtE,CAAC;AACJ,CAAC;AAOD,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAI1C,CAAC,CAAC,KAAK,CAAC;IACV,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC;IACpD,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,sCAAsC,CAAC;CACrD,CAAC,CAAC;AAEH,MAAM,UAAU,wBAAwB,CACtC,kBAAsC;IAEtC,OAAO,IAAI,CAAC,SAAS,CACnB,iCAAiC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAC5D,CAAC;AACJ,CAAC"}

package/dist/esm/models/operations/listbillablemetricevents.d.ts

@@ -25,6 +25,10 @@ export type ListBillableMetricEventsRequest = {
      * Filter by external identifier. Alphanumeric characters, hyphens, and underscores only.
      */
     externalId?: string | undefined;
+    /**
+     * Filter by the merchant's own customer identifier the event was reported with.
+     */
+    externalSubject?: string | undefined;
 };
 /** @internal */
 export type ListBillableMetricEventsRequest$Outbound = {
@@ -35,6 +39,7 @@ export type ListBillableMetricEventsRequest$Outbound = {
     limit: number;
     offset: number;
     externalId?: string | undefined;
+    externalSubject?: string | undefined;
 };
 /** @internal */
 export declare const ListBillableMetricEventsRequest$outboundSchema: z.ZodType<ListBillableMetricEventsRequest$Outbound, z.ZodTypeDef, ListBillableMetricEventsRequest>;

package/dist/esm/models/operations/listbillablemetricevents.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"listbillablemetricevents.d.ts","sourceRoot":"","sources":["../../../../src/models/operations/listbillablemetricevents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX;;OAEG;IACH,EAAE,EAAE,IAAI,CAAC;IACT;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,wCAAwC,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,8CAA8C,EAAE,CAAC,CAAC,OAAO,CACpE,wCAAwC,EACxC,CAAC,CAAC,UAAU,EACZ,+BAA+B,CAS/B,CAAC;AAEH,wBAAgB,qCAAqC,CACnD,+BAA+B,EAAE,+BAA+B,GAC/D,MAAM,CAMR"}
+{"version":3,"file":"listbillablemetricevents.d.ts","sourceRoot":"","sources":["../../../../src/models/operations/listbillablemetricevents.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,MAAM,+BAA+B,GAAG;IAC5C,EAAE,EAAE,MAAM,CAAC;IACX;;OAEG;IACH,IAAI,EAAE,IAAI,CAAC;IACX;;OAEG;IACH,EAAE,EAAE,IAAI,CAAC;IACT;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC;;OAEG;IACH,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,gBAAgB;AAChB,MAAM,MAAM,wCAAwC,GAAG;IACrD,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACtC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,8CAA8C,EAAE,CAAC,CAAC,OAAO,CACpE,wCAAwC,EACxC,CAAC,CAAC,UAAU,EACZ,+BAA+B,CAU/B,CAAC;AAEH,wBAAgB,qCAAqC,CACnD,+BAA+B,EAAE,+BAA+B,GAC/D,MAAM,CAMR"}

package/dist/esm/models/operations/listbillablemetricevents.js

@@ -11,6 +11,7 @@ export const ListBillableMetricEventsRequest$outboundSchema = z.object({
     limit: z.number().int().default(20),
     offset: z.number().int().default(0),
     externalId: z.string().optional(),
+    externalSubject: z.string().optional(),
 });
 export function listBillableMetricEventsRequestToJSON(listBillableMetricEventsRequest) {
     return JSON.stringify(ListBillableMetricEventsRequest$outboundSchema.parse(listBillableMetricEventsRequest));

package/dist/esm/models/operations/listbillablemetricevents.js.map

@@ -1 +1 @@
-{"version":3,"file":"listbillablemetricevents.js","sourceRoot":"","sources":["../../../../src/models/operations/listbillablemetricevents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAyC5B,gBAAgB;AAChB,MAAM,CAAC,MAAM,8CAA8C,GAIvD,CAAC,CAAC,MAAM,CAAC;IACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC,CAAC;AAEH,MAAM,UAAU,qCAAqC,CACnD,+BAAgE;IAEhE,OAAO,IAAI,CAAC,SAAS,CACnB,8CAA8C,CAAC,KAAK,CAClD,+BAA+B,CAChC,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"listbillablemetricevents.js","sourceRoot":"","sources":["../../../../src/models/operations/listbillablemetricevents.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AA8C5B,gBAAgB;AAChB,MAAM,CAAC,MAAM,8CAA8C,GAIvD,CAAC,CAAC,MAAM,CAAC;IACX,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9C,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;IAC5C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;IACnC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACnC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACvC,CAAC,CAAC;AAEH,MAAM,UAAU,qCAAqC,CACnD,+BAAgE;IAEhE,OAAO,IAAI,CAAC,SAAS,CACnB,8CAA8C,CAAC,KAAK,CAClD,+BAA+B,CAChC,CACF,CAAC;AACJ,CAAC"}

package/dist/esm/models/usageresponse.d.ts

@@ -16,6 +16,10 @@ export type GroupedValue = {
         [k: string]: string;
     };
     value: number;
+    /**
+     * Number of raw events in this group
+     */
+    eventCount?: number | undefined;
 };
 export type UsageResponse = {
     object: UsageResponseObject;
@@ -28,13 +32,17 @@ export type UsageResponse = {
      */
     totalValue: number;
     /**
-     * Time-bucketed values. Only present when windowSize is specified.
+     * Time-bucketed values. Only present when windowSize is specified. When both windowSize and groupBy are set, windowedValues[i] is index-aligned with groupedValues[i] (same window and group).
      */
     windowedValues?: Array<WindowedValue> | undefined;
     /**
-     * Dimension-grouped values. Only present when groupBy is specified.
+     * Dimension-grouped values. Only present when groupBy is specified. When both windowSize and groupBy are set, groupedValues[i] is index-aligned with windowedValues[i] (same window and group).
      */
     groupedValues?: Array<GroupedValue> | undefined;
+    /**
+     * Total distinct groups before groupLimit/groupOffset truncation. Only present when groupLimit is specified; use it to drive pagination totals.
+     */
+    groupCount?: number | undefined;
 };
 /** @internal */
 export declare const UsageResponseObject$inboundSchema: z.ZodNativeEnum<typeof UsageResponseObject>;

package/dist/esm/models/usageresponse.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"usageresponse.d.ts","sourceRoot":"","sources":["../../../src/models/usageresponse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;CAEtB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IAClD;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;CACjD,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,aAAa,CAC7D,OAAO,mBAAmB,CACS,CAAC;AAEtC,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CACjD,aAAa,EACb,CAAC,CAAC,UAAU,EACZ,OAAO,CAOP,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAMpD;AAED,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAChD,YAAY,EACZ,CAAC,CAAC,UAAU,EACZ,OAAO,CAIP,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAMnD;AAED,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CACjD,aAAa,EACb,CAAC,CAAC,UAAU,EACZ,OAAO,CAOP,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAMpD"}
+{"version":3,"file":"usageresponse.d.ts","sourceRoot":"","sources":["../../../src/models/usageresponse.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,MAAM,IAAI,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,gCAAgC,CAAC;AAEpE,eAAO,MAAM,mBAAmB;;CAEtB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEzE,MAAM,MAAM,aAAa,GAAG;IAC1B,WAAW,EAAE,IAAI,CAAC;IAClB,SAAS,EAAE,IAAI,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE;QAAE,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;KAAE,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,mBAAmB,CAAC;IAC5B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,cAAc,CAAC,EAAE,KAAK,CAAC,aAAa,CAAC,GAAG,SAAS,CAAC;IAClD;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;IAChD;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC,CAAC;AAEF,gBAAgB;AAChB,eAAO,MAAM,iCAAiC,EAAE,CAAC,CAAC,aAAa,CAC7D,OAAO,mBAAmB,CACS,CAAC;AAEtC,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CACjD,aAAa,EACb,CAAC,CAAC,UAAU,EACZ,OAAO,CAOP,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAMpD;AAED,gBAAgB;AAChB,eAAO,MAAM,0BAA0B,EAAE,CAAC,CAAC,OAAO,CAChD,YAAY,EACZ,CAAC,CAAC,UAAU,EACZ,OAAO,CAKP,CAAC;AAEH,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,YAAY,EAAE,kBAAkB,CAAC,CAMnD;AAED,gBAAgB;AAChB,eAAO,MAAM,2BAA2B,EAAE,CAAC,CAAC,OAAO,CACjD,aAAa,EACb,CAAC,CAAC,UAAU,EACZ,OAAO,CAQP,CAAC;AAEH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,MAAM,GACjB,eAAe,CAAC,aAAa,EAAE,kBAAkB,CAAC,CAMpD"}

package/dist/esm/models/usageresponse.js

@@ -21,6 +21,7 @@ export function windowedValueFromJSON(jsonString) {
 export const GroupedValue$inboundSchema = z.object({
     groupBy: z.record(z.string()),
     value: z.number(),
+    eventCount: z.number().int().optional(),
 });
 export function groupedValueFromJSON(jsonString) {
     return safeParse(jsonString, (x) => GroupedValue$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'GroupedValue' from JSON`);
@@ -32,6 +33,7 @@ export const UsageResponse$inboundSchema = z.object({
     totalValue: z.number(),
     windowedValues: z.array(z.lazy(() => WindowedValue$inboundSchema)).optional(),
     groupedValues: z.array(z.lazy(() => GroupedValue$inboundSchema)).optional(),
+    groupCount: z.number().int().optional(),
 });
 export function usageResponseFromJSON(jsonString) {
     return safeParse(jsonString, (x) => UsageResponse$inboundSchema.parse(JSON.parse(x)), `Failed to parse 'UsageResponse' from JSON`);

package/dist/esm/models/usageresponse.js.map

@@ -1 +1 @@
-{"version":3,"file":"usageresponse.js","sourceRoot":"","sources":["../../../src/models/usageresponse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,OAAO;CACN,CAAC;AAkCX,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAE1C,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAEtC,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAIpC,CAAC,CAAC,MAAM,CAAC;IACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAC/D,IAAI,IAAI,CAAC,CAAC,CAAC,CACZ;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACvD,2CAA2C,CAC5C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,0BAA0B,GAInC,CAAC,CAAC,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACtD,0CAA0C,CAC3C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAIpC,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,iCAAiC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC,QAAQ,EAAE;CAC5E,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACvD,2CAA2C,CAC5C,CAAC;AACJ,CAAC"}
+{"version":3,"file":"usageresponse.js","sourceRoot":"","sources":["../../../src/models/usageresponse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAK9C,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,KAAK,EAAE,OAAO;CACN,CAAC;AA0CX,gBAAgB;AAChB,MAAM,CAAC,MAAM,iCAAiC,GAE1C,CAAC,CAAC,UAAU,CAAC,mBAAmB,CAAC,CAAC;AAEtC,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAIpC,CAAC,CAAC,MAAM,CAAC;IACX,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAC/D,IAAI,IAAI,CAAC,CAAC,CAAC,CACZ;IACD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5E,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;CAClB,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACvD,2CAA2C,CAC5C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,0BAA0B,GAInC,CAAC,CAAC,MAAM,CAAC;IACX,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAClC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,0BAA0B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACtD,0CAA0C,CAC3C,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,MAAM,2BAA2B,GAIpC,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,iCAAiC,CAAC,OAAO,CAAC,OAAO,CAAC;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE;IAC5B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE;IACtB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7E,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC3E,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE;CACxC,CAAC,CAAC;AAEH,MAAM,UAAU,qBAAqB,CACnC,UAAkB;IAElB,OAAO,SAAS,CACd,UAAU,EACV,CAAC,CAAC,EAAE,EAAE,CAAC,2BAA2B,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EACvD,2CAA2C,CAC5C,CAAC;AACJ,CAAC"}

package/dist/esm/sdk/invoicesv2.d.ts

@@ -34,7 +34,7 @@ export declare class InvoicesV2 extends ClientSDK {
      * Get Line Items
      *
      * @remarks
-     * Get paginated line items for an invoice from the analytics service
+     * Get paginated line items for an invoice
      */
     getLineItems(request: operations.GetInvoiceLineItemsRequest, options?: RequestOptions): Promise<models.InvoiceLineItemsResponse>;
     /**

package/dist/esm/sdk/invoicesv2.js

@@ -52,7 +52,7 @@ export class InvoicesV2 extends ClientSDK {
      * Get Line Items
      *
      * @remarks
-     * Get paginated line items for an invoice from the analytics service
+     * Get paginated line items for an invoice
      */
     async getLineItems(request, options) {
         return unwrapAsync(invoicesV2GetLineItems(this, request, options));

package/jsr.json

@@ -2,7 +2,7 @@
 
 {
   "name": "@paygentic/sdk",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "exports": {
     ".": "./src/index.ts",    
     "./models/errors": "./src/models/errors/index.ts",    

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@paygentic/sdk",
-  "version": "0.8.1",
+  "version": "0.8.3",
   "author": "Speakeasy",
   "repository": {
     "type": "git",

package/src/funcs/billableMetricsListEvents.ts

@@ -102,6 +102,7 @@ async function $do(
 
   const query = encodeFormQuery({
     "externalId": payload.externalId,
+    "externalSubject": payload.externalSubject,
     "from": payload.from,
     "limit": payload.limit,
     "offset": payload.offset,

package/src/funcs/billableMetricsMeter.ts

@@ -104,6 +104,8 @@ async function $do(
     "filterGroupBy": payload.filterGroupBy,
     "from": payload.from,
     "groupBy": payload.groupBy,
+    "groupLimit": payload.groupLimit,
+    "groupOffset": payload.groupOffset,
     "subject": payload.subject,
     "to": payload.to,
     "windowSize": payload.windowSize,

package/src/funcs/invoicesV2GetLineItems.ts

@@ -30,7 +30,7 @@ import { Result } from "../types/fp.js";
  * Get Line Items
  *
  * @remarks
- * Get paginated line items for an invoice from the analytics service
+ * Get paginated line items for an invoice
  */
 export function invoicesV2GetLineItems(
   client: PaygenticCore,

package/src/lib/config.ts

@@ -65,7 +65,7 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.8.1",
+  sdkVersion: "0.8.3",
   genVersion: "2.879.13",
-  userAgent: "speakeasy-sdk/typescript 0.8.1 2.879.13 0.1.0 @paygentic/sdk",
+  userAgent: "speakeasy-sdk/typescript 0.8.3 2.879.13 0.1.0 @paygentic/sdk",
 } as const;

package/src/models/eventresponse.ts

@@ -21,7 +21,14 @@ export type EventResponse = {
   object: EventResponseObject;
   type?: string | undefined;
   source?: string | undefined;
+  /**
+   * Resolved customer ID. Absent when the event was reported with an externalSubject that does not match a customer yet.
+   */
   subject?: string | undefined;
+  /**
+   * The merchant's own customer identifier the event was reported with.
+   */
+  externalSubject?: string | undefined;
   namespace?: string | undefined;
   timestamp?: Date | undefined;
   idempotencyKey?: string | undefined;
@@ -47,6 +54,7 @@ export const EventResponse$inboundSchema: z.ZodType<
   type: z.string().optional(),
   source: z.string().optional(),
   subject: z.string().optional(),
+  externalSubject: z.string().optional(),
   namespace: z.string().optional(),
   timestamp: z.string().datetime({ offset: true }).transform(v => new Date(v))
     .optional(),

package/src/models/meterevent.ts

@@ -47,6 +47,10 @@ export type MeterEvent = {
    * Optional external identifier for cross-referencing with external systems. Alphanumeric characters, hyphens, and underscores only.
    */
   externalId?: string | undefined;
+  /**
+   * The merchant's own customer identifier the event was reported with. Empty subject with an externalSubject means the event is not linked to a customer yet.
+   */
+  externalSubject?: string | undefined;
 };
 
 /** @internal */
@@ -69,6 +73,7 @@ export const MeterEvent$inboundSchema: z.ZodType<
   idempotencyKey: z.string(),
   data: z.record(z.any()),
   externalId: z.string().optional(),
+  externalSubject: z.string().optional(),
 });
 
 export function meterEventFromJSON(

package/src/models/operations/advancetestclock.ts

@@ -5,70 +5,84 @@
 import * as z from "zod/v3";
 import { remap as remap$ } from "../../lib/primitives.js";
 
-export type RequestBody2 = {
+export type AdvanceTestClockRequestBody2 = {
   /**
    * ISO 8601 duration format indicating clock advancement distance. Sample values: 'P1M' moves forward one month, 'P7D' moves forward seven days, 'PT2H' moves forward two hours, 'P1Y2M3DT4H5M6S' moves forward one year, two months, three days, four hours, five minutes, and six seconds
    */
   advanceBy: string;
 };
 
-export type RequestBody1 = {
+export type AdvanceTestClockRequestBody1 = {
   /**
    * New absolute time for the test clock (must be forward in time)
    */
   currentTime: Date;
 };
 
-export type AdvanceTestClockRequestBody = RequestBody1 | RequestBody2;
+export type AdvanceTestClockRequestBody =
+  | AdvanceTestClockRequestBody1
+  | AdvanceTestClockRequestBody2;
 
 export type AdvanceTestClockRequest = {
   /**
    * Test clock ID
    */
   id: string;
-  requestBody: RequestBody1 | RequestBody2;
+  requestBody: AdvanceTestClockRequestBody1 | AdvanceTestClockRequestBody2;
 };
 
 /** @internal */
-export type RequestBody2$Outbound = {
+export type AdvanceTestClockRequestBody2$Outbound = {
   advanceBy: string;
 };
 
 /** @internal */
-export const RequestBody2$outboundSchema: z.ZodType<
-  RequestBody2$Outbound,
+export const AdvanceTestClockRequestBody2$outboundSchema: z.ZodType<
+  AdvanceTestClockRequestBody2$Outbound,
   z.ZodTypeDef,
-  RequestBody2
+  AdvanceTestClockRequestBody2
 > = z.object({
   advanceBy: z.string(),
 });
 
-export function requestBody2ToJSON(requestBody2: RequestBody2): string {
-  return JSON.stringify(RequestBody2$outboundSchema.parse(requestBody2));
+export function advanceTestClockRequestBody2ToJSON(
+  advanceTestClockRequestBody2: AdvanceTestClockRequestBody2,
+): string {
+  return JSON.stringify(
+    AdvanceTestClockRequestBody2$outboundSchema.parse(
+      advanceTestClockRequestBody2,
+    ),
+  );
 }
 
 /** @internal */
-export type RequestBody1$Outbound = {
+export type AdvanceTestClockRequestBody1$Outbound = {
   currentTime: string;
 };
 
 /** @internal */
-export const RequestBody1$outboundSchema: z.ZodType<
-  RequestBody1$Outbound,
+export const AdvanceTestClockRequestBody1$outboundSchema: z.ZodType<
+  AdvanceTestClockRequestBody1$Outbound,
   z.ZodTypeDef,
-  RequestBody1
+  AdvanceTestClockRequestBody1
 > = z.object({
   currentTime: z.date().transform(v => v.toISOString()),
 });
 
-export function requestBody1ToJSON(requestBody1: RequestBody1): string {
-  return JSON.stringify(RequestBody1$outboundSchema.parse(requestBody1));
+export function advanceTestClockRequestBody1ToJSON(
+  advanceTestClockRequestBody1: AdvanceTestClockRequestBody1,
+): string {
+  return JSON.stringify(
+    AdvanceTestClockRequestBody1$outboundSchema.parse(
+      advanceTestClockRequestBody1,
+    ),
+  );
 }
 
 /** @internal */
 export type AdvanceTestClockRequestBody$Outbound =
-  | RequestBody1$Outbound
-  | RequestBody2$Outbound;
+  | AdvanceTestClockRequestBody1$Outbound
+  | AdvanceTestClockRequestBody2$Outbound;
 
 /** @internal */
 export const AdvanceTestClockRequestBody$outboundSchema: z.ZodType<
@@ -76,8 +90,8 @@ export const AdvanceTestClockRequestBody$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   AdvanceTestClockRequestBody
 > = z.union([
-  z.lazy(() => RequestBody1$outboundSchema),
-  z.lazy(() => RequestBody2$outboundSchema),
+  z.lazy(() => AdvanceTestClockRequestBody1$outboundSchema),
+  z.lazy(() => AdvanceTestClockRequestBody2$outboundSchema),
 ]);
 
 export function advanceTestClockRequestBodyToJSON(
@@ -93,7 +107,9 @@ export function advanceTestClockRequestBodyToJSON(
 /** @internal */
 export type AdvanceTestClockRequest$Outbound = {
   id: string;
-  RequestBody: RequestBody1$Outbound | RequestBody2$Outbound;
+  RequestBody:
+    | AdvanceTestClockRequestBody1$Outbound
+    | AdvanceTestClockRequestBody2$Outbound;
 };
 
 /** @internal */
@@ -104,8 +120,8 @@ export const AdvanceTestClockRequest$outboundSchema: z.ZodType<
 > = z.object({
   id: z.string(),
   requestBody: z.union([
-    z.lazy(() => RequestBody1$outboundSchema),
-    z.lazy(() => RequestBody2$outboundSchema),
+    z.lazy(() => AdvanceTestClockRequestBody1$outboundSchema),
+    z.lazy(() => AdvanceTestClockRequestBody2$outboundSchema),
   ]),
 }).transform((v) => {
   return remap$(v, {

package/src/models/operations/getbillablemetricmeter.ts

@@ -44,9 +44,17 @@ export type GetBillableMetricMeterRequest = {
    */
   filterGroupBy?: string | undefined;
   /**
-   * Comma-separated dimension keys
+   * Comma-separated dimension keys. Configure keys for the grouping on the metric. Only the "subject" grouping is supported by default.
    */
   groupBy?: string | undefined;
+  /**
+   * Cap groupedValues to the top-N by value (descending). With windowSize, restricts the windowed series to those top-N groups. Bounds the payload for high-cardinality groupings; groupCount reports the untruncated distinct-group count.
+   */
+  groupLimit?: number | undefined;
+  /**
+   * Offset into the value-descending group ordering; requires groupLimit to page through grouped results. With windowSize set, pages the windowed series through the ranked groups (offset 0 yields the top-N).
+   */
+  groupOffset?: number | undefined;
 };
 
 /** @internal */
@@ -63,6 +71,8 @@ export type GetBillableMetricMeterRequest$Outbound = {
   windowSize?: string | undefined;
   filterGroupBy?: string | undefined;
   groupBy?: string | undefined;
+  groupLimit?: number | undefined;
+  groupOffset?: number | undefined;
 };
 
 /** @internal */
@@ -78,6 +88,8 @@ export const GetBillableMetricMeterRequest$outboundSchema: z.ZodType<
   windowSize: GetBillableMetricMeterWindowSize$outboundSchema.optional(),
   filterGroupBy: z.string().optional(),
   groupBy: z.string().optional(),
+  groupLimit: z.number().int().optional(),
+  groupOffset: z.number().int().optional(),
 });
 
 export function getBillableMetricMeterRequestToJSON(

package/src/models/operations/ingestevent.ts

@@ -4,7 +4,7 @@
 
 import * as z from "zod/v3";
 
-export type IngestEventRequest = {
+export type IngestEventRequestBody2 = {
   /**
    * CloudEvents type. Must match an eventType configured on a BillableMetric.
    */
@@ -14,9 +14,52 @@ export type IngestEventRequest = {
    */
   source: string;
   /**
-   * Customer or entity ID this event relates to.
+   * Customer or entity ID this event relates to. Required unless externalSubject is provided.
+   */
+  subject?: string | undefined;
+  /**
+   * Your own customer identifier, matched against the customer's externalId. Fallback for when the Paygentic customer ID is not known — prefer subject when it is. Events reported before the customer exists are linked retroactively once a customer with this externalId is created. Resolution is eventually consistent: after an externalId is removed or reassigned, events may resolve to the previous customer for up to one hour. If subject is also provided, subject takes precedence and externalSubject is recorded but not used for resolution.
+   */
+  externalSubject: string;
+  /**
+   * Organization/merchant ID. Defaults to the authenticated user's organization. Platform users can specify a different organization.
+   */
+  namespace?: string | undefined;
+  /**
+   * Event timestamp. Defaults to server time if not provided.
+   */
+  timestamp?: Date | undefined;
+  /**
+   * User-provided deduplication key. If not provided, a unique key is generated.
+   */
+  idempotencyKey?: string | undefined;
+  /**
+   * Optional external identifier for cross-referencing with external systems. Alphanumeric characters, hyphens, and underscores only.
+   */
+  externalId?: string | undefined;
+  /**
+   * Event payload containing the metering data.
+   */
+  data: { [k: string]: any };
+};
+
+export type IngestEventRequestBody1 = {
+  /**
+   * CloudEvents type. Must match an eventType configured on a BillableMetric.
+   */
+  type: string;
+  /**
+   * Event source URI identifying the application.
+   */
+  source: string;
+  /**
+   * Customer or entity ID this event relates to. Required unless externalSubject is provided.
    */
   subject: string;
+  /**
+   * Your own customer identifier, matched against the customer's externalId. Fallback for when the Paygentic customer ID is not known — prefer subject when it is. Events reported before the customer exists are linked retroactively once a customer with this externalId is created. Resolution is eventually consistent: after an externalId is removed or reassigned, events may resolve to the previous customer for up to one hour. If subject is also provided, subject takes precedence and externalSubject is recorded but not used for resolution.
+   */
+  externalSubject?: string | undefined;
   /**
    * Organization/merchant ID. Defaults to the authenticated user's organization. Platform users can specify a different organization.
    */
@@ -39,11 +82,54 @@ export type IngestEventRequest = {
   data: { [k: string]: any };
 };
 
+export type IngestEventRequest =
+  | IngestEventRequestBody1
+  | IngestEventRequestBody2;
+
+/** @internal */
+export type IngestEventRequestBody2$Outbound = {
+  type: string;
+  source: string;
+  subject?: string | undefined;
+  externalSubject: string;
+  namespace?: string | undefined;
+  timestamp?: string | undefined;
+  idempotencyKey?: string | undefined;
+  externalId?: string | undefined;
+  data: { [k: string]: any };
+};
+
+/** @internal */
+export const IngestEventRequestBody2$outboundSchema: z.ZodType<
+  IngestEventRequestBody2$Outbound,
+  z.ZodTypeDef,
+  IngestEventRequestBody2
+> = z.object({
+  type: z.string(),
+  source: z.string(),
+  subject: z.string().optional(),
+  externalSubject: z.string(),
+  namespace: z.string().optional(),
+  timestamp: z.date().transform(v => v.toISOString()).optional(),
+  idempotencyKey: z.string().optional(),
+  externalId: z.string().optional(),
+  data: z.record(z.any()),
+});
+
+export function ingestEventRequestBody2ToJSON(
+  ingestEventRequestBody2: IngestEventRequestBody2,
+): string {
+  return JSON.stringify(
+    IngestEventRequestBody2$outboundSchema.parse(ingestEventRequestBody2),
+  );
+}
+
 /** @internal */
-export type IngestEventRequest$Outbound = {
+export type IngestEventRequestBody1$Outbound = {
   type: string;
   source: string;
   subject: string;
+  externalSubject?: string | undefined;
   namespace?: string | undefined;
   timestamp?: string | undefined;
   idempotencyKey?: string | undefined;
@@ -52,14 +138,15 @@ export type IngestEventRequest$Outbound = {
 };
 
 /** @internal */
-export const IngestEventRequest$outboundSchema: z.ZodType<
-  IngestEventRequest$Outbound,
+export const IngestEventRequestBody1$outboundSchema: z.ZodType<
+  IngestEventRequestBody1$Outbound,
   z.ZodTypeDef,
-  IngestEventRequest
+  IngestEventRequestBody1
 > = z.object({
   type: z.string(),
   source: z.string(),
   subject: z.string(),
+  externalSubject: z.string().optional(),
   namespace: z.string().optional(),
   timestamp: z.date().transform(v => v.toISOString()).optional(),
   idempotencyKey: z.string().optional(),
@@ -67,6 +154,29 @@ export const IngestEventRequest$outboundSchema: z.ZodType<
   data: z.record(z.any()),
 });
 
+export function ingestEventRequestBody1ToJSON(
+  ingestEventRequestBody1: IngestEventRequestBody1,
+): string {
+  return JSON.stringify(
+    IngestEventRequestBody1$outboundSchema.parse(ingestEventRequestBody1),
+  );
+}
+
+/** @internal */
+export type IngestEventRequest$Outbound =
+  | IngestEventRequestBody1$Outbound
+  | IngestEventRequestBody2$Outbound;
+
+/** @internal */
+export const IngestEventRequest$outboundSchema: z.ZodType<
+  IngestEventRequest$Outbound,
+  z.ZodTypeDef,
+  IngestEventRequest
+> = z.union([
+  z.lazy(() => IngestEventRequestBody1$outboundSchema),
+  z.lazy(() => IngestEventRequestBody2$outboundSchema),
+]);
+
 export function ingestEventRequestToJSON(
   ingestEventRequest: IngestEventRequest,
 ): string {

package/src/models/operations/listbillablemetricevents.ts

@@ -30,6 +30,10 @@ export type ListBillableMetricEventsRequest = {
    * Filter by external identifier. Alphanumeric characters, hyphens, and underscores only.
    */
   externalId?: string | undefined;
+  /**
+   * Filter by the merchant's own customer identifier the event was reported with.
+   */
+  externalSubject?: string | undefined;
 };
 
 /** @internal */
@@ -41,6 +45,7 @@ export type ListBillableMetricEventsRequest$Outbound = {
   limit: number;
   offset: number;
   externalId?: string | undefined;
+  externalSubject?: string | undefined;
 };
 
 /** @internal */
@@ -56,6 +61,7 @@ export const ListBillableMetricEventsRequest$outboundSchema: z.ZodType<
   limit: z.number().int().default(20),
   offset: z.number().int().default(0),
   externalId: z.string().optional(),
+  externalSubject: z.string().optional(),
 });
 
 export function listBillableMetricEventsRequestToJSON(