@contractspec/lib.metering 3.7.17 → 3.7.18

package/dist/metering.capability.js

@@ -1,32 +1,2 @@
 // @bun
-// src/metering.capability.ts
-import {
-  defineCapability,
-  StabilityEnum
-} from "@contractspec/lib.contracts-spec";
-var MeteringCapability = defineCapability({
-  meta: {
-    key: "metering",
-    version: "1.0.0",
-    kind: "api",
-    stability: StabilityEnum.Experimental,
-    description: "Usage metering and tracking",
-    owners: ["@platform.finance"],
-    tags: ["metering", "usage", "billing"]
-  }
-});
-var ThresholdsCapability = defineCapability({
-  meta: {
-    key: "thresholds",
-    version: "1.0.0",
-    kind: "api",
-    stability: StabilityEnum.Experimental,
-    description: "Usage threshold alerts and limits",
-    owners: ["@platform.finance"],
-    tags: ["thresholds", "limits", "metering"]
-  }
-});
-export {
-  ThresholdsCapability,
-  MeteringCapability
-};
+import{defineCapability as g,StabilityEnum as h}from"@contractspec/lib.contracts-spec";var k=g({meta:{key:"metering",version:"1.0.0",kind:"api",stability:h.Experimental,description:"Usage metering and tracking",owners:["@platform.finance"],tags:["metering","usage","billing"]}}),q=g({meta:{key:"thresholds",version:"1.0.0",kind:"api",stability:h.Experimental,description:"Usage threshold alerts and limits",owners:["@platform.finance"],tags:["thresholds","limits","metering"]}});export{q as ThresholdsCapability,k as MeteringCapability};

package/dist/metering.feature.js

@@ -1,54 +1,2 @@
 // @bun
-// src/metering.feature.ts
-import { defineFeature } from "@contractspec/lib.contracts-spec";
-var MeteringFeature = defineFeature({
-  meta: {
-    key: "metrics",
-    version: "1.0.0",
-    title: "Usage Metering",
-    description: "Usage metering, metric definitions, and threshold alerting",
-    domain: "platform",
-    owners: ["@platform.metering"],
-    tags: ["metering", "usage", "billing", "thresholds"],
-    stability: "stable"
-  },
-  operations: [
-    { key: "metric.define", version: "1.0.0" },
-    { key: "metric.update", version: "1.0.0" },
-    { key: "metric.delete", version: "1.0.0" },
-    { key: "metric.get", version: "1.0.0" },
-    { key: "metric.list", version: "1.0.0" },
-    { key: "usage.record", version: "1.0.0" },
-    { key: "usage.recordBatch", version: "1.0.0" },
-    { key: "usage.get", version: "1.0.0" },
-    { key: "usage.getSummary", version: "1.0.0" },
-    { key: "threshold.create", version: "1.0.0" },
-    { key: "threshold.update", version: "1.0.0" },
-    { key: "threshold.delete", version: "1.0.0" },
-    { key: "threshold.list", version: "1.0.0" }
-  ],
-  events: [
-    { key: "metric.defined", version: "1.0.0" },
-    { key: "metric.updated", version: "1.0.0" },
-    { key: "usage.recorded", version: "1.0.0" },
-    { key: "usage.batch_recorded", version: "1.0.0" },
-    { key: "usage.aggregated", version: "1.0.0" },
-    { key: "threshold.created", version: "1.0.0" },
-    { key: "threshold.exceeded", version: "1.0.0" },
-    { key: "threshold.approaching", version: "1.0.0" },
-    { key: "model.selected", version: "1.0.0" }
-  ],
-  presentations: [],
-  opToPresentation: [],
-  presentationsTargets: [],
-  capabilities: {
-    provides: [
-      { key: "metering", version: "1.0.0" },
-      { key: "thresholds", version: "1.0.0" }
-    ],
-    requires: []
-  }
-});
-export {
-  MeteringFeature
-};
+import{defineFeature as g}from"@contractspec/lib.contracts-spec";var j=g({meta:{key:"metrics",version:"1.0.0",title:"Usage Metering",description:"Usage metering, metric definitions, and threshold alerting",domain:"platform",owners:["@platform.metering"],tags:["metering","usage","billing","thresholds"],stability:"stable"},operations:[{key:"metric.define",version:"1.0.0"},{key:"metric.update",version:"1.0.0"},{key:"metric.delete",version:"1.0.0"},{key:"metric.get",version:"1.0.0"},{key:"metric.list",version:"1.0.0"},{key:"usage.record",version:"1.0.0"},{key:"usage.recordBatch",version:"1.0.0"},{key:"usage.get",version:"1.0.0"},{key:"usage.getSummary",version:"1.0.0"},{key:"threshold.create",version:"1.0.0"},{key:"threshold.update",version:"1.0.0"},{key:"threshold.delete",version:"1.0.0"},{key:"threshold.list",version:"1.0.0"}],events:[{key:"metric.defined",version:"1.0.0"},{key:"metric.updated",version:"1.0.0"},{key:"usage.recorded",version:"1.0.0"},{key:"usage.batch_recorded",version:"1.0.0"},{key:"usage.aggregated",version:"1.0.0"},{key:"threshold.created",version:"1.0.0"},{key:"threshold.exceeded",version:"1.0.0"},{key:"threshold.approaching",version:"1.0.0"},{key:"model.selected",version:"1.0.0"}],presentations:[],opToPresentation:[],presentationsTargets:[],capabilities:{provides:[{key:"metering",version:"1.0.0"},{key:"thresholds",version:"1.0.0"}],requires:[]}});export{j as MeteringFeature};

package/dist/node/aggregation/index.js

@@ -1,265 +1 @@
-// src/aggregation/index.ts
-function getPeriodStart(date, periodType) {
-  const d = new Date(date);
-  switch (periodType) {
-    case "HOURLY":
-      d.setMinutes(0, 0, 0);
-      return d;
-    case "DAILY":
-      d.setHours(0, 0, 0, 0);
-      return d;
-    case "WEEKLY": {
-      d.setHours(0, 0, 0, 0);
-      const day = d.getDay();
-      d.setDate(d.getDate() - day);
-      return d;
-    }
-    case "MONTHLY":
-      d.setHours(0, 0, 0, 0);
-      d.setDate(1);
-      return d;
-    case "YEARLY":
-      d.setHours(0, 0, 0, 0);
-      d.setMonth(0, 1);
-      return d;
-  }
-}
-function getPeriodEnd(date, periodType) {
-  const start = getPeriodStart(date, periodType);
-  switch (periodType) {
-    case "HOURLY":
-      return new Date(start.getTime() + 60 * 60 * 1000);
-    case "DAILY":
-      return new Date(start.getTime() + 24 * 60 * 60 * 1000);
-    case "WEEKLY":
-      return new Date(start.getTime() + 7 * 24 * 60 * 60 * 1000);
-    case "MONTHLY": {
-      const end = new Date(start);
-      end.setMonth(end.getMonth() + 1);
-      return end;
-    }
-    case "YEARLY": {
-      const end = new Date(start);
-      end.setFullYear(end.getFullYear() + 1);
-      return end;
-    }
-  }
-}
-function formatPeriodKey(date, periodType) {
-  const start = getPeriodStart(date, periodType);
-  const year = start.getFullYear();
-  const month = String(start.getMonth() + 1).padStart(2, "0");
-  const day = String(start.getDate()).padStart(2, "0");
-  const hour = String(start.getHours()).padStart(2, "0");
-  switch (periodType) {
-    case "HOURLY":
-      return `${year}-${month}-${day}T${hour}`;
-    case "DAILY":
-      return `${year}-${month}-${day}`;
-    case "WEEKLY":
-      return `${year}-W${getWeekNumber(start)}`;
-    case "MONTHLY":
-      return `${year}-${month}`;
-    case "YEARLY":
-      return `${year}`;
-  }
-}
-function getWeekNumber(date) {
-  const d = new Date(Date.UTC(date.getFullYear(), date.getMonth(), date.getDate()));
-  const dayNum = d.getUTCDay() || 7;
-  d.setUTCDate(d.getUTCDate() + 4 - dayNum);
-  const yearStart = new Date(Date.UTC(d.getUTCFullYear(), 0, 1));
-  const weekNum = Math.ceil(((d.getTime() - yearStart.getTime()) / 86400000 + 1) / 7);
-  return String(weekNum).padStart(2, "0");
-}
-
-class UsageAggregator {
-  storage;
-  batchSize;
-  constructor(options) {
-    this.storage = options.storage;
-    this.batchSize = options.batchSize || 1000;
-  }
-  async aggregate(params) {
-    const { periodType, periodStart, metricKey } = params;
-    const periodEnd = params.periodEnd || getPeriodEnd(periodStart, periodType);
-    const result = {
-      periodType,
-      periodStart,
-      periodEnd,
-      recordsProcessed: 0,
-      summariesCreated: 0,
-      summariesUpdated: 0,
-      errors: []
-    };
-    const records = await this.storage.getUnaggregatedRecords({
-      metricKey,
-      periodStart,
-      periodEnd,
-      limit: this.batchSize
-    });
-    if (records.length === 0) {
-      return result;
-    }
-    const groups = this.groupRecords(records, periodType);
-    for (const [groupKey, groupRecords] of groups.entries()) {
-      try {
-        await this.aggregateGroup(groupKey, groupRecords, periodType, result);
-      } catch (error) {
-        const [metricKey2, subjectType, subjectId] = groupKey.split("::");
-        result.errors.push({
-          metricKey: metricKey2 ?? "unknown",
-          subjectType: subjectType ?? "unknown",
-          subjectId: subjectId ?? "unknown",
-          error: error instanceof Error ? error.message : String(error)
-        });
-      }
-    }
-    const recordIds = records.map((r) => r.id);
-    await this.storage.markRecordsAggregated(recordIds, new Date);
-    result.recordsProcessed = records.length;
-    return result;
-  }
-  groupRecords(records, periodType) {
-    const groups = new Map;
-    for (const record of records) {
-      const periodKey = formatPeriodKey(record.timestamp, periodType);
-      const groupKey = `${record.metricKey}::${record.subjectType}::${record.subjectId}::${periodKey}`;
-      const existing = groups.get(groupKey) || [];
-      existing.push(record);
-      groups.set(groupKey, existing);
-    }
-    return groups;
-  }
-  async aggregateGroup(groupKey, records, periodType, result) {
-    const [metricKey, subjectType, subjectId] = groupKey.split("::");
-    if (!metricKey || !subjectType || !subjectId || records.length === 0) {
-      return;
-    }
-    const firstRecord = records[0];
-    if (!firstRecord)
-      return;
-    const periodStart = getPeriodStart(firstRecord.timestamp, periodType);
-    const periodEnd = getPeriodEnd(firstRecord.timestamp, periodType);
-    const metric = await this.storage.getMetric(metricKey);
-    const aggregationType = metric?.aggregationType || "SUM";
-    const quantities = records.map((r) => r.quantity);
-    const aggregated = this.calculateAggregation(quantities, aggregationType);
-    await this.storage.upsertSummary({
-      metricKey,
-      subjectType,
-      subjectId,
-      periodType,
-      periodStart,
-      periodEnd,
-      totalQuantity: aggregated.total,
-      recordCount: records.length,
-      minQuantity: aggregated.min,
-      maxQuantity: aggregated.max,
-      avgQuantity: aggregated.avg
-    });
-    result.summariesCreated++;
-  }
-  calculateAggregation(quantities, aggregationType) {
-    if (quantities.length === 0) {
-      return { total: 0, min: 0, max: 0, avg: 0 };
-    }
-    const min = Math.min(...quantities);
-    const max = Math.max(...quantities);
-    const sum = quantities.reduce((a, b) => a + b, 0);
-    const avg = sum / quantities.length;
-    const count = quantities.length;
-    let total;
-    switch (aggregationType) {
-      case "COUNT":
-        total = count;
-        break;
-      case "SUM":
-        total = sum;
-        break;
-      case "AVG":
-        total = avg;
-        break;
-      case "MAX":
-        total = max;
-        break;
-      case "MIN":
-        total = min;
-        break;
-      case "LAST":
-        total = quantities[quantities.length - 1] ?? 0;
-        break;
-      default:
-        total = sum;
-    }
-    return { total, min, max, avg };
-  }
-}
-
-class InMemoryUsageStorage {
-  records = [];
-  summaries = new Map;
-  metrics = new Map;
-  addRecord(record) {
-    this.records.push(record);
-  }
-  addMetric(metric) {
-    this.metrics.set(metric.key, metric);
-  }
-  async getUnaggregatedRecords(options) {
-    let records = this.records.filter((r) => {
-      const inPeriod = r.timestamp >= options.periodStart && r.timestamp < options.periodEnd;
-      const matchesMetric = !options.metricKey || r.metricKey === options.metricKey;
-      return inPeriod && matchesMetric;
-    });
-    if (options.limit) {
-      records = records.slice(0, options.limit);
-    }
-    return records;
-  }
-  async markRecordsAggregated(recordIds) {
-    this.records = this.records.filter((r) => !recordIds.includes(r.id));
-  }
-  async upsertSummary(summary) {
-    const key = `${summary.metricKey}::${summary.subjectType}::${summary.subjectId}::${summary.periodType}::${summary.periodStart.toISOString()}`;
-    const existing = this.summaries.get(key);
-    if (existing) {
-      existing.totalQuantity += summary.totalQuantity;
-      existing.recordCount += summary.recordCount;
-      if (summary.minQuantity !== undefined) {
-        existing.minQuantity = Math.min(existing.minQuantity ?? Infinity, summary.minQuantity);
-      }
-      if (summary.maxQuantity !== undefined) {
-        existing.maxQuantity = Math.max(existing.maxQuantity ?? -Infinity, summary.maxQuantity);
-      }
-      return existing;
-    }
-    const newSummary = {
-      id: `summary-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-      ...summary
-    };
-    this.summaries.set(key, newSummary);
-    return newSummary;
-  }
-  async getMetric(key) {
-    return this.metrics.get(key) || null;
-  }
-  async listMetrics() {
-    return Array.from(this.metrics.values());
-  }
-  getSummaries() {
-    return Array.from(this.summaries.values());
-  }
-  clear() {
-    this.records = [];
-    this.summaries.clear();
-    this.metrics.clear();
-  }
-}
-export {
-  getPeriodStart,
-  getPeriodEnd,
-  formatPeriodKey,
-  UsageAggregator,
-  InMemoryUsageStorage
-};
+function Z(z,B){let A=new Date(z);switch(B){case"HOURLY":return A.setMinutes(0,0,0),A;case"DAILY":return A.setHours(0,0,0,0),A;case"WEEKLY":{A.setHours(0,0,0,0);let D=A.getDay();return A.setDate(A.getDate()-D),A}case"MONTHLY":return A.setHours(0,0,0,0),A.setDate(1),A;case"YEARLY":return A.setHours(0,0,0,0),A.setMonth(0,1),A}}function $(z,B){let A=Z(z,B);switch(B){case"HOURLY":return new Date(A.getTime()+3600000);case"DAILY":return new Date(A.getTime()+86400000);case"WEEKLY":return new Date(A.getTime()+604800000);case"MONTHLY":{let D=new Date(A);return D.setMonth(D.getMonth()+1),D}case"YEARLY":{let D=new Date(A);return D.setFullYear(D.getFullYear()+1),D}}}function C(z,B){let A=Z(z,B),D=A.getFullYear(),F=String(A.getMonth()+1).padStart(2,"0"),G=String(A.getDate()).padStart(2,"0"),H=String(A.getHours()).padStart(2,"0");switch(B){case"HOURLY":return`${D}-${F}-${G}T${H}`;case"DAILY":return`${D}-${F}-${G}`;case"WEEKLY":return`${D}-W${M(A)}`;case"MONTHLY":return`${D}-${F}`;case"YEARLY":return`${D}`}}function M(z){let B=new Date(Date.UTC(z.getFullYear(),z.getMonth(),z.getDate())),A=B.getUTCDay()||7;B.setUTCDate(B.getUTCDate()+4-A);let D=new Date(Date.UTC(B.getUTCFullYear(),0,1)),F=Math.ceil(((B.getTime()-D.getTime())/86400000+1)/7);return String(F).padStart(2,"0")}class U{storage;batchSize;constructor(z){this.storage=z.storage,this.batchSize=z.batchSize||1000}async aggregate(z){let{periodType:B,periodStart:A,metricKey:D}=z,F=z.periodEnd||$(A,B),G={periodType:B,periodStart:A,periodEnd:F,recordsProcessed:0,summariesCreated:0,summariesUpdated:0,errors:[]},H=await this.storage.getUnaggregatedRecords({metricKey:D,periodStart:A,periodEnd:F,limit:this.batchSize});if(H.length===0)return G;let J=this.groupRecords(H,B);for(let[L,_]of J.entries())try{await this.aggregateGroup(L,_,B,G)}catch(V){let[X,O,Y]=L.split("::");G.errors.push({metricKey:X??"unknown",subjectType:O??"unknown",subjectId:Y??"unknown",error:V instanceof Error?V.message:String(V)})}let Q=H.map((L)=>L.id);return await this.storage.markRecordsAggregated(Q,new Date),G.recordsProcessed=H.length,G}groupRecords(z,B){let A=new Map;for(let D of z){let F=C(D.timestamp,B),G=`${D.metricKey}::${D.subjectType}::${D.subjectId}::${F}`,H=A.get(G)||[];H.push(D),A.set(G,H)}return A}async aggregateGroup(z,B,A,D){let[F,G,H]=z.split("::");if(!F||!G||!H||B.length===0)return;let J=B[0];if(!J)return;let Q=Z(J.timestamp,A),L=$(J.timestamp,A),V=(await this.storage.getMetric(F))?.aggregationType||"SUM",X=B.map((Y)=>Y.quantity),O=this.calculateAggregation(X,V);await this.storage.upsertSummary({metricKey:F,subjectType:G,subjectId:H,periodType:A,periodStart:Q,periodEnd:L,totalQuantity:O.total,recordCount:B.length,minQuantity:O.min,maxQuantity:O.max,avgQuantity:O.avg}),D.summariesCreated++}calculateAggregation(z,B){if(z.length===0)return{total:0,min:0,max:0,avg:0};let A=Math.min(...z),D=Math.max(...z),F=z.reduce((Q,L)=>Q+L,0),G=F/z.length,H=z.length,J;switch(B){case"COUNT":J=H;break;case"SUM":J=F;break;case"AVG":J=G;break;case"MAX":J=D;break;case"MIN":J=A;break;case"LAST":J=z[z.length-1]??0;break;default:J=F}return{total:J,min:A,max:D,avg:G}}}class W{records=[];summaries=new Map;metrics=new Map;addRecord(z){this.records.push(z)}addMetric(z){this.metrics.set(z.key,z)}async getUnaggregatedRecords(z){let B=this.records.filter((A)=>{let D=A.timestamp>=z.periodStart&&A.timestamp<z.periodEnd,F=!z.metricKey||A.metricKey===z.metricKey;return D&&F});if(z.limit)B=B.slice(0,z.limit);return B}async markRecordsAggregated(z){this.records=this.records.filter((B)=>!z.includes(B.id))}async upsertSummary(z){let B=`${z.metricKey}::${z.subjectType}::${z.subjectId}::${z.periodType}::${z.periodStart.toISOString()}`,A=this.summaries.get(B);if(A){if(A.totalQuantity+=z.totalQuantity,A.recordCount+=z.recordCount,z.minQuantity!==void 0)A.minQuantity=Math.min(A.minQuantity??1/0,z.minQuantity);if(z.maxQuantity!==void 0)A.maxQuantity=Math.max(A.maxQuantity??-1/0,z.maxQuantity);return A}let D={id:`summary-${Date.now()}-${Math.random().toString(36).slice(2)}`,...z};return this.summaries.set(B,D),D}async getMetric(z){return this.metrics.get(z)||null}async listMetrics(){return Array.from(this.metrics.values())}getSummaries(){return Array.from(this.summaries.values())}clear(){this.records=[],this.summaries.clear(),this.metrics.clear()}}export{Z as getPeriodStart,$ as getPeriodEnd,C as formatPeriodKey,U as UsageAggregator,W as InMemoryUsageStorage};

package/dist/node/analytics/posthog-metering-reader.js

@@ -1,266 +1,4 @@
-// src/analytics/posthog-metering-reader.ts
-class PosthogMeteringReader {
-  reader;
-  eventPrefix;
-  constructor(reader, options = {}) {
-    this.reader = reader;
-    this.eventPrefix = options.eventPrefix ?? "metering";
-  }
-  async getUsageByMetric(input) {
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        "  properties.recordId as recordId,",
-        "  properties.metricKey as metricKey,",
-        "  properties.subjectType as subjectType,",
-        "  distinct_id as subjectId,",
-        "  properties.quantity as quantity,",
-        "  properties.source as source,",
-        "  timestamp as timestamp",
-        "from events",
-        `where ${buildUsageWhereClause(this.eventPrefix, input)}`,
-        "order by timestamp desc",
-        `limit ${input.limit ?? 200}`
-      ].join(`
-`),
-      values: buildUsageValues(input)
-    });
-    return mapUsageRecords(result);
-  }
-  async getUsageSummary(input) {
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        "  properties.summaryId as summaryId,",
-        "  properties.metricKey as metricKey,",
-        "  properties.subjectType as subjectType,",
-        "  distinct_id as subjectId,",
-        "  properties.periodType as periodType,",
-        "  properties.periodStart as periodStart,",
-        "  properties.periodEnd as periodEnd,",
-        "  properties.totalQuantity as totalQuantity,",
-        "  properties.recordCount as recordCount,",
-        "  timestamp as aggregatedAt",
-        "from events",
-        `where ${buildSummaryWhereClause(this.eventPrefix, input)}`,
-        "order by timestamp desc",
-        `limit ${input.limit ?? 200}`
-      ].join(`
-`),
-      values: buildSummaryValues(input)
-    });
-    return mapUsageSummaries(result);
-  }
-  async getUsageTrend(input) {
-    const result = await this.queryHogQL({
-      query: [
-        "select",
-        `  ${bucketExpression(input.bucket)} as bucketStart,`,
-        "  sum(properties.quantity) as totalQuantity,",
-        "  count() as recordCount",
-        "from events",
-        `where ${buildUsageWhereClause(this.eventPrefix, input)}`,
-        "group by bucketStart",
-        "order by bucketStart asc"
-      ].join(`
-`),
-      values: buildUsageValues(input)
-    });
-    return mapUsageTrend(result);
-  }
-  async queryHogQL(input) {
-    if (!this.reader.queryHogQL) {
-      throw new Error("Analytics reader does not support HogQL queries.");
-    }
-    return this.reader.queryHogQL(input);
-  }
-}
-function buildUsageWhereClause(eventPrefix, input) {
-  const clauses = [
-    `event = '${eventPrefix}.usage_recorded'`,
-    `properties.metricKey = {metricKey}`
-  ];
-  if (input.subjectId) {
-    clauses.push("distinct_id = {subjectId}");
-  }
-  if (input.dateRange?.from) {
-    clauses.push("timestamp >= {dateFrom}");
-  }
-  if (input.dateRange?.to) {
-    clauses.push("timestamp < {dateTo}");
-  }
-  return clauses.join(" and ");
-}
-function buildSummaryWhereClause(eventPrefix, input) {
-  const clauses = [
-    `event = '${eventPrefix}.usage_aggregated'`,
-    `properties.metricKey = {metricKey}`
-  ];
-  if (input.subjectId) {
-    clauses.push("distinct_id = {subjectId}");
-  }
-  if (input.periodType) {
-    clauses.push("properties.periodType = {periodType}");
-  }
-  if (input.dateRange?.from) {
-    clauses.push("timestamp >= {dateFrom}");
-  }
-  if (input.dateRange?.to) {
-    clauses.push("timestamp < {dateTo}");
-  }
-  return clauses.join(" and ");
-}
-function buildUsageValues(input) {
-  return {
-    metricKey: input.metricKey,
-    subjectId: input.subjectId,
-    dateFrom: toIsoString(input.dateRange?.from),
-    dateTo: toIsoString(input.dateRange?.to)
-  };
-}
-function buildSummaryValues(input) {
-  return {
-    metricKey: input.metricKey,
-    subjectId: input.subjectId,
-    periodType: input.periodType,
-    dateFrom: toIsoString(input.dateRange?.from),
-    dateTo: toIsoString(input.dateRange?.to)
-  };
-}
-function bucketExpression(bucket) {
-  switch (bucket) {
-    case "hour":
-      return "toStartOfHour(timestamp)";
-    case "week":
-      return "toStartOfWeek(timestamp)";
-    case "month":
-      return "toStartOfMonth(timestamp)";
-    case "day":
-    default:
-      return "toStartOfDay(timestamp)";
-  }
-}
-function mapUsageRecords(result) {
-  const rows = mapRows(result);
-  return rows.flatMap((row) => {
-    const metricKey = asString(row.metricKey);
-    const subjectType = asString(row.subjectType);
-    const subjectId = asString(row.subjectId);
-    const timestamp = asDate(row.timestamp);
-    if (!metricKey || !subjectType || !subjectId || !timestamp) {
-      return [];
-    }
-    return [
-      {
-        recordId: asOptionalString(row.recordId),
-        metricKey,
-        subjectType,
-        subjectId,
-        quantity: asNumber(row.quantity),
-        source: asOptionalString(row.source),
-        timestamp
-      }
-    ];
-  });
-}
-function mapUsageSummaries(result) {
-  const rows = mapRows(result);
-  return rows.flatMap((row) => {
-    const metricKey = asString(row.metricKey);
-    const subjectType = asString(row.subjectType);
-    const subjectId = asString(row.subjectId);
-    const periodType = asString(row.periodType);
-    const periodStart = asDate(row.periodStart);
-    const periodEnd = asDate(row.periodEnd);
-    const aggregatedAt = asDate(row.aggregatedAt);
-    if (!metricKey || !subjectType || !subjectId || !periodType || !periodStart || !periodEnd || !aggregatedAt) {
-      return [];
-    }
-    return [
-      {
-        summaryId: asOptionalString(row.summaryId),
-        metricKey,
-        subjectType,
-        subjectId,
-        periodType,
-        periodStart,
-        periodEnd,
-        totalQuantity: asNumber(row.totalQuantity),
-        recordCount: asNumber(row.recordCount),
-        aggregatedAt
-      }
-    ];
-  });
-}
-function mapUsageTrend(result) {
-  const rows = mapRows(result);
-  return rows.flatMap((row) => {
-    const bucketStart = asString(row.bucketStart);
-    if (!bucketStart)
-      return [];
-    return [
-      {
-        bucketStart,
-        totalQuantity: asNumber(row.totalQuantity),
-        recordCount: asNumber(row.recordCount)
-      }
-    ];
-  });
-}
-function mapRows(result) {
-  if (!Array.isArray(result.results) || !Array.isArray(result.columns)) {
-    return [];
-  }
-  const columns = result.columns;
-  return result.results.flatMap((row) => {
-    if (!Array.isArray(row))
-      return [];
-    const record = {};
-    columns.forEach((column, index) => {
-      record[column] = row[index];
-    });
-    return [record];
-  });
-}
-function asString(value) {
-  if (typeof value === "string" && value.trim())
-    return value;
-  if (typeof value === "number")
-    return String(value);
-  return null;
-}
-function asOptionalString(value) {
-  if (typeof value === "string")
-    return value;
-  if (typeof value === "number")
-    return String(value);
-  return;
-}
-function asNumber(value) {
-  if (typeof value === "number" && Number.isFinite(value))
-    return value;
-  if (typeof value === "string" && value.trim()) {
-    const parsed = Number(value);
-    if (Number.isFinite(parsed))
-      return parsed;
-  }
-  return 0;
-}
-function asDate(value) {
-  if (value instanceof Date)
-    return value;
-  if (typeof value === "string" || typeof value === "number") {
-    const date = new Date(value);
-    if (!Number.isNaN(date.getTime()))
-      return date;
-  }
-  return null;
-}
-function toIsoString(value) {
-  if (!value)
-    return;
-  return typeof value === "string" ? value : value.toISOString();
-}
-export {
-  PosthogMeteringReader
-};
+class R{reader;eventPrefix;constructor(e,r={}){this.reader=e,this.eventPrefix=r.eventPrefix??"metering"}async getUsageByMetric(e){let r=await this.queryHogQL({query:["select","  properties.recordId as recordId,","  properties.metricKey as metricKey,","  properties.subjectType as subjectType,","  distinct_id as subjectId,","  properties.quantity as quantity,","  properties.source as source,","  timestamp as timestamp","from events",`where ${b(this.eventPrefix,e)}`,"order by timestamp desc",`limit ${e.limit??200}`].join(`
+`),values:l(e)});return j(r)}async getUsageSummary(e){let r=await this.queryHogQL({query:["select","  properties.summaryId as summaryId,","  properties.metricKey as metricKey,","  properties.subjectType as subjectType,","  distinct_id as subjectId,","  properties.periodType as periodType,","  properties.periodStart as periodStart,","  properties.periodEnd as periodEnd,","  properties.totalQuantity as totalQuantity,","  properties.recordCount as recordCount,","  timestamp as aggregatedAt","from events",`where ${I(this.eventPrefix,e)}`,"order by timestamp desc",`limit ${e.limit??200}`].join(`
+`),values:T(e)});return S(r)}async getUsageTrend(e){let r=await this.queryHogQL({query:["select",`  ${h(e.bucket)} as bucketStart,`,"  sum(properties.quantity) as totalQuantity,","  count() as recordCount","from events",`where ${b(this.eventPrefix,e)}`,"group by bucketStart","order by bucketStart asc"].join(`
+`),values:l(e)});return U(r)}async queryHogQL(e){if(!this.reader.queryHogQL)throw Error("Analytics reader does not support HogQL queries.");return this.reader.queryHogQL(e)}}function b(e,r){let t=[`event = '${e}.usage_recorded'`,"properties.metricKey = {metricKey}"];if(r.subjectId)t.push("distinct_id = {subjectId}");if(r.dateRange?.from)t.push("timestamp >= {dateFrom}");if(r.dateRange?.to)t.push("timestamp < {dateTo}");return t.join(" and ")}function I(e,r){let t=[`event = '${e}.usage_aggregated'`,"properties.metricKey = {metricKey}"];if(r.subjectId)t.push("distinct_id = {subjectId}");if(r.periodType)t.push("properties.periodType = {periodType}");if(r.dateRange?.from)t.push("timestamp >= {dateFrom}");if(r.dateRange?.to)t.push("timestamp < {dateTo}");return t.join(" and ")}function l(e){return{metricKey:e.metricKey,subjectId:e.subjectId,dateFrom:d(e.dateRange?.from),dateTo:d(e.dateRange?.to)}}function T(e){return{metricKey:e.metricKey,subjectId:e.subjectId,periodType:e.periodType,dateFrom:d(e.dateRange?.from),dateTo:d(e.dateRange?.to)}}function h(e){switch(e){case"hour":return"toStartOfHour(timestamp)";case"week":return"toStartOfWeek(timestamp)";case"month":return"toStartOfMonth(timestamp)";case"day":default:return"toStartOfDay(timestamp)"}}function j(e){return p(e).flatMap((t)=>{let n=s(t.metricKey),i=s(t.subjectType),a=s(t.subjectId),o=c(t.timestamp);if(!n||!i||!a||!o)return[];return[{recordId:g(t.recordId),metricKey:n,subjectType:i,subjectId:a,quantity:u(t.quantity),source:g(t.source),timestamp:o}]})}function S(e){return p(e).flatMap((t)=>{let n=s(t.metricKey),i=s(t.subjectType),a=s(t.subjectId),o=s(t.periodType),m=c(t.periodStart),y=c(t.periodEnd),f=c(t.aggregatedAt);if(!n||!i||!a||!o||!m||!y||!f)return[];return[{summaryId:g(t.summaryId),metricKey:n,subjectType:i,subjectId:a,periodType:o,periodStart:m,periodEnd:y,totalQuantity:u(t.totalQuantity),recordCount:u(t.recordCount),aggregatedAt:f}]})}function U(e){return p(e).flatMap((t)=>{let n=s(t.bucketStart);if(!n)return[];return[{bucketStart:n,totalQuantity:u(t.totalQuantity),recordCount:u(t.recordCount)}]})}function p(e){if(!Array.isArray(e.results)||!Array.isArray(e.columns))return[];let r=e.columns;return e.results.flatMap((t)=>{if(!Array.isArray(t))return[];let n={};return r.forEach((i,a)=>{n[i]=t[a]}),[n]})}function s(e){if(typeof e==="string"&&e.trim())return e;if(typeof e==="number")return String(e);return null}function g(e){if(typeof e==="string")return e;if(typeof e==="number")return String(e);return}function u(e){if(typeof e==="number"&&Number.isFinite(e))return e;if(typeof e==="string"&&e.trim()){let r=Number(e);if(Number.isFinite(r))return r}return 0}function c(e){if(e instanceof Date)return e;if(typeof e==="string"||typeof e==="number"){let r=new Date(e);if(!Number.isNaN(r.getTime()))return r}return null}function d(e){if(!e)return;return typeof e==="string"?e:e.toISOString()}export{R as PosthogMeteringReader};

package/dist/node/analytics/posthog-metering.js

@@ -1,45 +1 @@
-// src/analytics/posthog-metering.ts
-class PosthogMeteringReporter {
-  provider;
-  eventPrefix;
-  includeSource;
-  constructor(provider, options = {}) {
-    this.provider = provider;
-    this.eventPrefix = options.eventPrefix ?? "metering";
-    this.includeSource = options.includeSource ?? true;
-  }
-  async captureUsageRecorded(record) {
-    await this.provider.capture({
-      distinctId: record.subjectId,
-      event: `${this.eventPrefix}.usage_recorded`,
-      timestamp: record.timestamp,
-      properties: {
-        recordId: record.recordId ?? null,
-        metricKey: record.metricKey,
-        subjectType: record.subjectType,
-        quantity: record.quantity,
-        ...this.includeSource && record.source ? { source: record.source } : {}
-      }
-    });
-  }
-  async captureUsageAggregated(summary) {
-    await this.provider.capture({
-      distinctId: summary.subjectId,
-      event: `${this.eventPrefix}.usage_aggregated`,
-      timestamp: summary.aggregatedAt,
-      properties: {
-        summaryId: summary.summaryId ?? null,
-        metricKey: summary.metricKey,
-        subjectType: summary.subjectType,
-        periodType: summary.periodType,
-        periodStart: summary.periodStart.toISOString(),
-        periodEnd: summary.periodEnd.toISOString(),
-        totalQuantity: summary.totalQuantity,
-        recordCount: summary.recordCount
-      }
-    });
-  }
-}
-export {
-  PosthogMeteringReporter
-};
+class r{provider;eventPrefix;includeSource;constructor(e,t={}){this.provider=e,this.eventPrefix=t.eventPrefix??"metering",this.includeSource=t.includeSource??!0}async captureUsageRecorded(e){await this.provider.capture({distinctId:e.subjectId,event:`${this.eventPrefix}.usage_recorded`,timestamp:e.timestamp,properties:{recordId:e.recordId??null,metricKey:e.metricKey,subjectType:e.subjectType,quantity:e.quantity,...this.includeSource&&e.source?{source:e.source}:{}}})}async captureUsageAggregated(e){await this.provider.capture({distinctId:e.subjectId,event:`${this.eventPrefix}.usage_aggregated`,timestamp:e.aggregatedAt,properties:{summaryId:e.summaryId??null,metricKey:e.metricKey,subjectType:e.subjectType,periodType:e.periodType,periodStart:e.periodStart.toISOString(),periodEnd:e.periodEnd.toISOString(),totalQuantity:e.totalQuantity,recordCount:e.recordCount}})}}export{r as PosthogMeteringReporter};