@hyperline/cli 0.1.0-build.1.bf6bdf2 → 0.1.0-build.1.deb4fbd

package/dist/bin/hyperline-main.js

@@ -379,6 +379,287 @@ async function promptCompanySelection({ baseUrl, accessToken }) {
 `);
 }
 
+// build/commands/confirm.js
+import * as readline2 from "node:readline";
+function confirmPrompt(message) {
+  const rl = readline2.createInterface({
+    input: process.stdin,
+    output: process.stderr
+  });
+  return new Promise((resolve) => {
+    rl.question(message, (answer) => {
+      rl.close();
+      resolve(answer.toLowerCase() === "y");
+    });
+  });
+}
+
+// build/commands/events.js
+function resolveIngestBaseUrl(apiBaseUrl) {
+  return apiBaseUrl.replace("api.", "ingest.");
+}
+function registerEventsCommands(parent) {
+  const resource = parent.command("events").description("Manage billable events");
+  resource.command("list").description(`List billable events filtered by event type with optional filters for customer_id, record_id, and timestamp range. Paginated with take/skip.`).requiredOption("--event-type <value>", `Event type to filter by`).option("--take <number>", `take`).option("--skip <number>", `skip`).option("--customer-id <value>", `Filter by customer ID`).option("--record-id-in <value>", `Filter by record ID (comma-separated for multiple)`).option("--timestamp-gte <value>", `Filter events with timestamp >= this ISO8601 date`).option("--timestamp-lte <value>", `Filter events with timestamp <= this ISO8601 date`).option("--order <value>", `Sort order for timestamp`).addHelpText("after", `
+Examples:
+    hyperline events list --event-type api_call
+    hyperline events list --event-type api_call --customer-id cus_xyz789 --take 10`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.eventType !== void 0)
+      args.event_type = opts.eventType;
+    if (opts.customerId !== void 0)
+      args.customer_id = opts.customerId;
+    if (opts.recordIdIn !== void 0)
+      args.record_id__in = opts.recordIdIn;
+    if (opts.timestampGte !== void 0)
+      args.timestamp_gte = opts.timestampGte;
+    if (opts.timestampLte !== void 0)
+      args.timestamp_lte = opts.timestampLte;
+    if (opts.order !== void 0)
+      args.order = opts.order;
+    if (opts.take !== void 0)
+      args.take = Number(opts.take);
+    if (opts.skip !== void 0)
+      args.skip = Number(opts.skip);
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/events",
+      args,
+      queryParamKeys: [
+        "event_type",
+        "customer_id",
+        "record_id__in",
+        "timestamp_gte",
+        "timestamp_lte",
+        "order",
+        "take",
+        "skip"
+      ],
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+  resource.command("send").description(`Send a single billable event.`).requiredOption("--customer-id <value>", `Customer ID or external ID`).requiredOption("--event-type <value>", `Event type`).requiredOption("--timestamp <value>", `ISO8601 timestamp`).requiredOption("--record <value>", `Event record as JSON (must include "id" key)`).option("--with-price-calculation", `Whether to calculate prices for the event`).addHelpText("after", `
+Examples:
+    hyperline events send --customer-id cus_xyz --event-type api_call --timestamp 2024-01-15T10:00:00Z --record '{"id":"evt_1","duration":32}'
+    hyperline events send --customer-id cus_xyz --event-type api_call --timestamp 2024-01-15T10:00:00Z --record '{"id":"evt_1"}' --with-price-calculation`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    let record;
+    try {
+      record = JSON.parse(opts.record);
+    } catch {
+      process.stderr.write(`Error: --record must be valid JSON (e.g. '{"id":"evt_1"}')
+`);
+      process.exit(1);
+    }
+    const body = {
+      customer_id: opts.customerId,
+      event_type: opts.eventType,
+      timestamp: opts.timestamp,
+      record
+    };
+    const args = {};
+    if (opts.withPriceCalculation !== void 0)
+      args.with_price_calculation = true;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/events",
+      args,
+      queryParamKeys: ["with_price_calculation"],
+      body,
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+  resource.command("send-batch").description(`Send multiple billable events in batch (max 5000 per request). All events must have the same event_type.`).requiredOption("--events <value>", `JSON array of events, each with customer_id, event_type, timestamp, record`).addHelpText("after", `
+Examples:
+    hyperline events send-batch --events '[{"customer_id":"cus_xyz","event_type":"api_call","timestamp":"2024-01-15T10:00:00Z","record":{"id":"evt_1"}},{"customer_id":"cus_xyz","event_type":"api_call","timestamp":"2024-01-15T10:01:00Z","record":{"id":"evt_2"}}]'`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    let events;
+    try {
+      events = JSON.parse(opts.events);
+    } catch {
+      process.stderr.write("Error: --events must be valid JSON array\n");
+      process.exit(1);
+    }
+    if (!Array.isArray(events)) {
+      process.stderr.write("Error: --events must be a JSON array\n");
+      process.exit(1);
+    }
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/events/batch",
+      args: {},
+      body: events,
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+  resource.command("delete").description(`Delete billable events by record IDs, customer ID, or all events.`).option("--matching <value>", `Matching strategy: record_ids, customer_id, or all`).option("--record-ids <value>", `Comma-separated list of record IDs (when matching=record_ids)`).option("--customer-id <value>", `Customer ID (when matching=customer_id)`).addHelpText("after", `
+Examples:
+    hyperline events delete --matching record_ids --record-ids evt_1,evt_2
+    hyperline events delete --matching customer_id --customer-id cus_xyz
+    hyperline events delete --matching all`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    const matching = opts.matching;
+    if (!matching || !["record_ids", "customer_id", "all"].includes(matching)) {
+      process.stderr.write("Error: --matching must be one of: record_ids, customer_id, all\n");
+      process.exit(1);
+    }
+    let body;
+    if (matching === "record_ids") {
+      if (!opts.recordIds) {
+        process.stderr.write("Error: --record-ids is required when matching=record_ids\n");
+        process.exit(1);
+      }
+      body = {
+        matching: "record_ids",
+        record_ids: opts.recordIds.split(",")
+      };
+    } else if (matching === "customer_id") {
+      if (!opts.customerId) {
+        process.stderr.write("Error: --customer-id is required when matching=customer_id\n");
+        process.exit(1);
+      }
+      body = { matching: "customer_id", customer_id: opts.customerId };
+    } else {
+      const confirmed = await confirmPrompt("Are you sure you want to delete ALL events? (y/N) ");
+      if (!confirmed) {
+        process.stdout.write("Aborted.\n");
+        return;
+      }
+      body = { matching: "all" };
+    }
+    await ctx.execute({
+      method: "DELETE",
+      path: "/v1/events",
+      args: {},
+      body,
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+  resource.command("calculate-prices").description(`Ingest a billable event and calculate its prices. After first ingestion, returns cached prices.`).requiredOption("--customer-id <value>", `Customer ID or external ID`).requiredOption("--event-type <value>", `Event type`).requiredOption("--timestamp <value>", `ISO8601 timestamp`).requiredOption("--record <value>", `Event record as JSON (must include "id" key)`).option("--product-id <value>", `Hyperline product ID`).option("--subscription-id <value>", `Hyperline subscription ID`).option("--include-tax", `Include amounts with tax`).addHelpText("after", `
+Examples:
+    hyperline events calculate-prices --customer-id cus_xyz --event-type api_call --timestamp 2024-01-15T10:00:00Z --record '{"id":"evt_1"}'
+    hyperline events calculate-prices --customer-id cus_xyz --event-type api_call --timestamp 2024-01-15T10:00:00Z --record '{"id":"evt_1"}' --product-id itm_abc --include-tax`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    let record;
+    try {
+      record = JSON.parse(opts.record);
+    } catch {
+      process.stderr.write(`Error: --record must be valid JSON (e.g. '{"id":"evt_1"}')
+`);
+      process.exit(1);
+    }
+    const body = {
+      customer_id: opts.customerId,
+      event_type: opts.eventType,
+      timestamp: opts.timestamp,
+      record
+    };
+    const args = {};
+    if (opts.productId !== void 0)
+      args.product_id = opts.productId;
+    if (opts.subscriptionId !== void 0)
+      args.subscription_id = opts.subscriptionId;
+    if (opts.includeTax !== void 0)
+      args.include_tax = true;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/events/prices",
+      args,
+      queryParamKeys: ["product_id", "subscription_id", "include_tax"],
+      body,
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+  resource.command("simulate-prices").description(`Simulate prices for a billable event without ingesting it.`).requiredOption("--event-type <value>", `Event type`).requiredOption("--record <value>", `Event record as JSON (must include "id" key)`).option("--customer-id <value>", `Customer ID or external ID`).option("--timestamp <value>", `ISO8601 timestamp`).option("--product-id <value>", `Hyperline product ID`).option("--subscription-id <value>", `Hyperline subscription ID`).option("--include-tax", `Include amounts with tax`).addHelpText("after", `
+Examples:
+    hyperline events simulate-prices --event-type api_call --record '{"id":"evt_1","duration":32}'
+    hyperline events simulate-prices --event-type api_call --record '{"id":"evt_1"}' --product-id itm_abc --include-tax`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    let record;
+    try {
+      record = JSON.parse(opts.record);
+    } catch {
+      process.stderr.write(`Error: --record must be valid JSON (e.g. '{"id":"evt_1"}')
+`);
+      process.exit(1);
+    }
+    const body = {
+      event_type: opts.eventType,
+      record
+    };
+    if (opts.customerId !== void 0)
+      body.customer_id = opts.customerId;
+    if (opts.timestamp !== void 0)
+      body.timestamp = opts.timestamp;
+    const args = {};
+    if (opts.productId !== void 0)
+      args.product_id = opts.productId;
+    if (opts.subscriptionId !== void 0)
+      args.subscription_id = opts.subscriptionId;
+    if (opts.includeTax !== void 0)
+      args.include_tax = true;
+    await ctx.execute({
+      method: "POST",
+      path: "/v1/events/simulate-prices",
+      args,
+      queryParamKeys: ["product_id", "subscription_id", "include_tax"],
+      body,
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+  resource.command("get-prices").description(`Get previous price calculation results by calculation ID or record ID.`).option("--record-id <value>", `Record ID to look up`).option("--calculation-id <value>", `Calculation ID to look up`).addHelpText("after", `
+Examples:
+    hyperline events get-prices --record-id D32NAA8
+    hyperline events get-prices --calculation-id cal_1234567890`).action(async (opts) => {
+    const ctx = resource.parent?.opts()._ctx;
+    if (!ctx) {
+      process.stderr.write("Error: Not authenticated\n");
+      process.exit(1);
+    }
+    if (!opts.recordId && !opts.calculationId) {
+      process.stderr.write("Error: at least one of --record-id or --calculation-id is required\n");
+      process.exit(1);
+    }
+    const args = {};
+    if (opts.recordId !== void 0)
+      args.record_id = opts.recordId;
+    if (opts.calculationId !== void 0)
+      args.calculation_id = opts.calculationId;
+    await ctx.execute({
+      method: "GET",
+      path: "/v1/events/prices",
+      args,
+      queryParamKeys: ["record_id", "calculation_id"],
+      baseUrlOverride: resolveIngestBaseUrl(ctx.baseUrl)
+    });
+  });
+}
+
 // build/commands/generated/analytics.js
 function registerAnalyticsCommands(parent) {
   const resource = parent.command("analytics").description("Manage analytics");
@@ -489,21 +770,6 @@ Examples:
   });
 }
 
-// build/commands/confirm.js
-import * as readline2 from "node:readline";
-function confirmPrompt(message) {
-  const rl = readline2.createInterface({
-    input: process.stdin,
-    output: process.stderr
-  });
-  return new Promise((resolve) => {
-    rl.question(message, (answer) => {
-      rl.close();
-      resolve(answer.toLowerCase() === "y");
-    });
-  });
-}
-
 // build/commands/generated/coupons.js
 function registerCouponsCommands(parent) {
   const resource = parent.command("coupons").description("Manage coupons");
@@ -8954,8 +9220,9 @@ function createCLIContext({ apiKey, baseUrl, outputFormat, source, companyId })
     }
   });
   return {
+    baseUrl,
     outputFormat,
-    async execute({ method, path: path2, args, queryParamKeys = [], body }) {
+    async execute({ method, path: path2, args, queryParamKeys = [], body, baseUrlOverride }) {
       const { url, params, data } = buildRequestConfig(path2, args, method, queryParamKeys);
       const requestData = body ?? data;
       const hasData = Array.isArray(requestData) ? requestData.length > 0 : requestData != null && Object.keys(requestData).length > 0;
@@ -8965,6 +9232,7 @@ function createCLIContext({ apiKey, baseUrl, outputFormat, source, companyId })
           url,
           params,
           data: hasData ? requestData : void 0,
+          ...baseUrlOverride ? { baseURL: baseUrlOverride } : {},
           headers: {
             "Hyperline-Source": source,
             ...companyId ? { "Hyperline-CompanyId": companyId } : {}
@@ -9077,6 +9345,7 @@ companyCommand.command("current").description("Show the currently active company
   }
 });
 registerAllCommands(program);
+registerEventsCommands(program);
 var selfAuthCommands = /* @__PURE__ */ new Set(["login", "logout", "company"]);
 program.hook("preAction", async (thisCommand, actionCommand) => {
   const commandName = actionCommand.name();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperline/cli",
-  "version": "0.1.0-build.1.bf6bdf2",
+  "version": "0.1.0-build.1.deb4fbd",
   "description": "Agent-first CLI for Hyperline API",
   "type": "module",
   "main": "./dist/index.js",