@amerged/ohmyhost-sdk 0.1.40 → 0.1.41

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@amerged/ohmyhost-sdk",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "type": "module",
   "engines": {
     "node": ">=22"

package/src/packages/sdk-ts/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ohmyhost/sdk-ts",
-  "version": "0.1.40",
+  "version": "0.1.41",
   "private": true,
   "type": "module",
   "exports": {

package/src/packages/sdk-ts/src/generated/sdk.gen.ts

@@ -1930,7 +1930,7 @@ export const createOrganization = <ThrowOnError extends boolean = true>(
 /**
  * Create or resume an owner's hosted Stripe Checkout
  *
- * Returns a human payment URL, never charges a saved card. Paid is USD 10/month; each top-up pack is USD 10 before tax; a purchase grants 100 credits per dollar up to USD 100 and 125 credits per dollar for the part above, so 10 packs grant 10000 and 20 packs grant 22500 credits. Top-ups require active Paid access and have no time limit during uninterrupted Paid membership; remaining top-ups expire when the workspace returns to Free. Monthly Paid credits expire at billing-period end without rollover. Retry the same offer, packs and Idempotency-Key after uncertainty. Browser return is not payment proof; read this checkout and the organization balance. A conflicting or existing subscription returns billing_purchase_conflict (409); read the original checkout or request an owner billing portal URL instead of another purchase. Works at zero credits.
+ * Returns a human payment URL, never charges a saved card. Paid is USD 10/month; each top-up pack is USD 10 before tax; a purchase grants 100 credits per dollar up to USD 100 and 125 credits per dollar for the part above, so 10 packs grant 10000 and 20 packs grant 22500 credits. Top-ups require active Paid access and never expire, also after the workspace returns to Free. Monthly Paid credits expire at billing-period end without rollover. Retry the same offer, packs and Idempotency-Key after uncertainty. Browser return is not payment proof; read this checkout and the organization balance. A conflicting or existing subscription returns billing_purchase_conflict (409); read the original checkout or request an owner billing portal URL instead of another purchase. Works at zero credits.
  */
 export const createBillingCheckout = <ThrowOnError extends boolean = true>(
   parameters: {
@@ -1983,7 +1983,7 @@ export const createBillingCheckout = <ThrowOnError extends boolean = true>(
 /**
  * Observe and reconcile an owner's original checkout
  *
- * Reads Stripe and reconciles confirmed credits/refunds idempotently. payment_confirmed describes the original Checkout, not spendable credit or current Paid entitlement. Read organization credits for available funding and the organization account's effective plan for Paid coverage; paid_until is the paid Stripe period end, not the end of renewal grace. No new purchase intent or payment is created; an uncertain original Checkout can resume using its stored identity.
+ * Reads Stripe and reconciles confirmed credits/refunds idempotently. payment_confirmed describes the original Checkout, not spendable credit or current Paid entitlement. Read organization credits for available funding and the organization account's effective plan for Paid coverage; paid_until is the end of paid coverage, the paid Stripe period end plus its 14-day renewal grace. No new purchase intent or payment is created; an uncertain original Checkout can resume using its stored identity.
  */
 export const getBillingCheckout = <ThrowOnError extends boolean = true>(
   parameters: {
@@ -2105,7 +2105,7 @@ export const getBillingRecharge = <ThrowOnError extends boolean = true>(
 /**
  * Enable or disable explicitly authorized auto-recharge
  *
- * Owner-only. An agent must obtain explicit approval for off-session charges and the gross monthly spending cap before enabling. Each refill costs USD 9 before tax for 1000 top-up credits when available credits fall below 100. Active Paid access is required to enable recharge and initiate a payment; remaining refill credits expire on downgrade to Free. A saved Stripe card is required; follow setup_url if returned. Current revision prevents stale edits; retry the original Idempotency-Key and payload after uncertainty. Disable prevents new charge initiation; already initiated payments may complete. No subscription or Paid features are created.
+ * Owner-only. An agent must obtain explicit approval for off-session charges and the gross monthly spending cap before enabling. Each refill costs USD 9 before tax for 1000 top-up credits when available credits fall below 100. Active Paid access is required to enable recharge and initiate a payment; bought credits never expire, also after a downgrade to Free. A saved Stripe card is required; follow setup_url if returned. Current revision prevents stale edits; retry the original Idempotency-Key and payload after uncertainty. Disable prevents new charge initiation; already initiated payments may complete. No subscription or Paid features are created.
  */
 export const configureBillingRecharge = <ThrowOnError extends boolean = true>(
   parameters: {
@@ -2162,7 +2162,7 @@ export const configureBillingRecharge = <ThrowOnError extends boolean = true>(
 /**
  * Read the owner's shared organization credit pool
  *
- * Returns posted credits and reservations, in microcredits (one credit is 1000000 microcredits). Monthly entitlement posting is idempotent. Only the organization Owner may read this balance. active_meters names the currently billed sources; unreported usage is not included. platform_overrun_micros is recorded platform exposure, not customer debt. Remains available at zero credit.
+ * Returns the spendable credit and the open reservations, in microcredits (one credit is 1000000 microcredits). available_micros is the monthly credit plus the one-time credit minus the reservations, never below zero. Only the organization Owner may read this balance. active_meters names the currently billed sources; usage that is not billed yet is not included. When the credit is used up, grace_started_at and grace_expires_at name the seven days that keep existing services running. Remains available at zero credit.
  */
 export const getOrganizationCredits = <ThrowOnError extends boolean = true>(
   parameters: {
@@ -2202,16 +2202,14 @@ export const getOrganizationCredits = <ThrowOnError extends boolean = true>(
 };
 
 /**
- * Read monthly measured usage by project and meter
+ * Read recent measured usage by day, project and meter
  *
- * Owner-only event-month ledger totals, including signed corrections posted by as_of. Returns up to 20 projects per page in ID order; use next_cursor with the same month. Current unresolved reservations are separate from measured consumption. Null environment_id means project-shared cost, never guessed Dev allocation. Only posted measurements are included; this is not a complete provider invoice or zero-usage guarantee. Billing may arrive later. No credit is granted or charged by this read; it remains usable at zero credits.
+ * Owner-only. days holds the credit-log charges of the last up to 14 UTC days (today included, oldest first), grouped by day, project and meter. projects holds what each project has used so far in the current UTC month. A null environment_id means a project-shared cost, never a guessed Dev allocation. Only billed usage is included; charges may arrive later, so this is not a complete provider invoice or a zero-usage guarantee. No credit is granted or charged by this read; it remains usable at zero credits.
  */
 export const getOrganizationCreditUsage = <ThrowOnError extends boolean = true>(
   parameters: {
     "X-Request-Id"?: string;
     organization_id: Ulid;
-    month: string;
-    cursor?: Ulid;
   },
   options?: Options<never, ThrowOnError>,
 ): RequestResult<
@@ -2227,8 +2225,6 @@ export const getOrganizationCreditUsage = <ThrowOnError extends boolean = true>(
         args: [
           { in: "headers", key: "X-Request-Id" },
           { in: "path", key: "organization_id" },
-          { in: "query", key: "month" },
-          { in: "query", key: "cursor" },
         ],
       },
     ],

package/src/packages/sdk-ts/src/generated/types.gen.ts

@@ -321,15 +321,12 @@ export type OrganizationCredits = {
   as_of: string;
   available_micros: CreditMicros;
   reserved_micros: CreditMicros;
-  spent_micros: CreditMicros;
-  expired_micros: CreditMicros;
-  platform_overrun_micros: CreditMicros;
   /**
-   * First confirmed exhaustion in this continuous period; null while funded.
+   * When the credit was used up; null while funded or after the monthly credit renewed.
    */
   grace_started_at: string | null;
   /**
-   * Seven days after first confirmed exhaustion. Existing services and domains are retained during this grace; no automatic data deletion. Explicit project stop budgets are separate.
+   * Seven days after the credit was used up. Existing services and domains are retained during this grace; no automatic data deletion. Explicit project stop budgets are separate.
    */
   grace_expires_at: string | null;
   active_meters: Array<string>;
@@ -346,22 +343,38 @@ export type UsageTotal = string;
 
 export type OrganizationCreditUsage = {
   organization_id: Ulid;
-  month: string;
   as_of: string;
   unit: "microcredits";
-  next_cursor: Ulid | null;
-  data: Array<{
+  /**
+   * The UTC month that projects[].used_micros counts.
+   */
+  period: string;
+  /**
+   * The start of the oldest UTC day in days.
+   */
+  from: string;
+  /**
+   * What each project has used so far in period, in ID order; projects without use are left out.
+   */
+  projects: Array<{
     project_id: Ulid;
-    reserved_micros: UsageTotal;
-    meters: Array<{
-      environment_id: Ulid | null;
-      meter: string;
-      unit: string;
-      rate_card_id: string;
-      quantity: UsageTotal;
-      charged_micros: UsageTotal;
-      funded_micros: UsageTotal;
-      platform_overrun_micros: UsageTotal;
+    used_micros: UsageTotal;
+  }>;
+  /**
+   * Billed charges of the last up to 14 UTC days, oldest first.
+   */
+  days: Array<{
+    day: string;
+    projects: Array<{
+      project_id: Ulid;
+      meters: Array<{
+        environment_id: Ulid | null;
+        meter: string;
+        unit: string;
+        rate_card_id: string;
+        quantity: string;
+        charged_micros: UsageTotal;
+      }>;
     }>;
   }>;
 };
@@ -384,6 +397,9 @@ export type PublishedCreditRateCard = {
 };
 
 export type SetProjectCreditBudgetRequest = {
+  /**
+   * The monthly budget, at most 9007199254740991 microcredits (about 9 billion credits); null removes it.
+   */
   amount_micros: CreditMicros | null;
   mode: "continue" | "stop";
 };
@@ -1264,13 +1280,28 @@ export type OrganizationAccount = {
   plan: "free" | "paid";
   plan_source: "free" | "stripe" | "granted" | "manual";
   /**
-   * End of the paid Stripe billing period or the applicable grant; null on Free or for an unbounded grant. During an unpaid renewal the effective Paid plan may remain available for up to 14 days after this Stripe period end, without new monthly credits.
+   * End of the paid coverage: the Stripe billing period plus its 14-day renewal grace, or the end of the grant; null on Free. Paid features stay available until this instant.
    */
   paid_until: string | null;
+  /**
+   * Spendable credit: monthly plus one-time credit minus the open reservations, never below zero.
+   */
   available_micros: CreditMicros;
+  /**
+   * The monthly credit, which ends at next_expiry; the Free allowance is 200 credits and the Paid allowance 1000 credits per period.
+   */
   monthly_micros: CreditMicros;
+  /**
+   * Top-up, bonus and referral credit. It does not expire.
+   */
   one_time_micros: CreditMicros;
+  /**
+   * Credit held for open builds; it is part of the monthly and one-time credit until the build settles.
+   */
   reserved_micros: CreditMicros;
+  /**
+   * When the monthly credit ends and renews; null when none is left.
+   */
   next_expiry: string | null;
   as_of: string;
 };
@@ -4396,10 +4427,7 @@ export type GetOrganizationCreditUsageData = {
   path: {
     organization_id: Ulid;
   };
-  query: {
-    month: string;
-    cursor?: Ulid;
-  };
+  query?: never;
   url: "/v1/organizations/{organization_id}/credit-usage";
 };
 
@@ -4431,7 +4459,7 @@ export type GetOrganizationCreditUsageError =
 
 export type GetOrganizationCreditUsageResponses = {
   /**
-   * Current posted usage for the selected UTC month and project page.
+   * Recent billed usage of the organization.
    */
   200: OrganizationCreditUsage;
 };