@heroku/sdk 0.12.2 → 0.12.4

package/dist/resources/extensions/data.js

@@ -2,6 +2,11 @@ export { databaseCredentialExtensions } from '../data/database-credential/index.
 export { databaseExtensions } from '../data/database.js';
 export { maintenanceExtensions } from '../data/maintenance.js';
 export { postgresDatabaseExtensions } from '../data/postgres-database.js';
+export { isCancellable, isRunnable, MigrationInvalidError, MigrationNotCancellableError, MigrationNotRunnableError, postgresMigrationExtensions, } from '../data/postgres-migration.js';
+export { LEADER_POOL_NAME, MAX_POOL_INSTANCES, postgresPoolExtensions, } from '../data/postgres-pool.js';
+export { postgresQuotaExtensions } from '../data/postgres-quota.js';
+export { postgresSettingsExtensions } from '../data/postgres-settings.js';
+export { postgresExtensions, } from '../data/postgres.js';
 export { redisExtensions } from '../data/redis/index.js';
 export { transferScheduleExtensions } from '../data/transfer-schedule.js';
 export { backupExtensions, restoreExtensions, transferExtensions, TransferFailedError, TransferTimeoutError, } from '../data/transfer/index.js';

package/dist/resources/platform/add-on/destroy-and-wait.d.ts

@@ -1,6 +1,5 @@
-import type { AddOn } from '@heroku/types/3.sdk';
 import type { ResourceCtx } from '../../../core/extend-resource.js';
-import type { DestroyAndWaitOptions } from './types.js';
+import type { DeprovisioningAddOn, DestroyAndWaitOptions } from './types.js';
 /**
  * Delete an add-on and optionally wait for deprovisioning to complete.
  *
@@ -19,4 +18,4 @@ import type { DestroyAndWaitOptions } from './types.js';
  *
  * Both the delete and the poll requests send `Accept-Expansion: plan`.
  */
-export declare function destroyAndWait(ctx: Pick<ResourceCtx, 'platform'>, appIdentity: string, addonIdentity: string, options?: DestroyAndWaitOptions): Promise<AddOn>;
+export declare function destroyAndWait(ctx: Pick<ResourceCtx, 'platform'>, appIdentity: string, addonIdentity: string, options?: DestroyAndWaitOptions): Promise<DeprovisioningAddOn>;

package/dist/resources/platform/add-on/destroy-and-wait.js

@@ -29,7 +29,13 @@ export async function destroyAndWait(ctx, appIdentity, addonIdentity, options =
         ? platform.withOptions({ body: { force: true } })
         : platform;
     const deleted = await deleteClient.addOn.delete(appIdentity, addonIdentity);
-    let addon = deleted ?? {};
+    if (!deleted) {
+        // The platform returns the (possibly still-deprovisioning) add-on on a
+        // successful delete; an empty body means we can't report a result, so fail
+        // loudly rather than fabricate a stateless phantom add-on.
+        throw new Error(`Deleting add-on ${addonIdentity} returned no response body.`);
+    }
+    let addon = deleted;
     if (!options.wait || (addon.state !== 'deprovisioning' && addon.state !== 'provisioning')) {
         return addon;
     }

package/dist/resources/platform/add-on/errors.d.ts

@@ -1,4 +1,5 @@
 import type { AddOn } from '@heroku/types/3.sdk';
+import type { DeprovisioningAddOn, ResolvedAddOn } from './types.js';
 export declare class AddonNotFoundError extends Error {
     readonly resource: string;
     readonly id = "not_found";
@@ -36,14 +37,46 @@ export declare class AddonConfirmationRequiredError extends Error {
         message: string;
     };
 }
+/**
+ * Thrown by `postgresDatabase.destroy` when the database can't be found under
+ * the requested app but does exist under another app. Restores the CLI's
+ * historical "is on <app> not <app>" guidance so a database scoped to the
+ * wrong app surfaces a targeted error rather than a bare not-found.
+ */
+export declare class AddonAppMismatchError extends Error {
+    readonly addon: ResolvedAddOn;
+    readonly requestedApp: string;
+    readonly id = "app_mismatch";
+    constructor(addon: ResolvedAddOn, requestedApp: string);
+    get body(): {
+        id: string;
+        message: string;
+    };
+}
+/**
+ * Thrown by `postgresDatabase.destroy` when the delete request (or its
+ * deprovisioning wait) fails after the database was resolved and any
+ * `beforeDestroy` confirmation passed. Carries the resolved add-on so callers
+ * can render tier-specific guidance without re-resolving; the underlying
+ * failure is preserved as the standard `cause`.
+ */
+export declare class AddonDestroyFailedError extends Error {
+    readonly addon: ResolvedAddOn;
+    readonly id = "destroy_failed";
+    constructor(addon: ResolvedAddOn, cause: unknown);
+    get body(): {
+        id: string;
+        message: string;
+    };
+}
 /**
  * Thrown by `createAndWait` when the Platform reports the add-on
  * settled into a non-provisioned terminal state (e.g. `deprovisioned`).
  */
 export declare class AddonProvisioningFailedError extends Error {
-    readonly addon: AddOn;
+    readonly addon: AddOn | DeprovisioningAddOn;
     readonly id = "provisioning_failed";
-    constructor(addon: AddOn);
+    constructor(addon: AddOn | DeprovisioningAddOn);
     get body(): {
         id: string;
         message: string;

package/dist/resources/platform/add-on/errors.js

@@ -43,6 +43,58 @@ export class AddonConfirmationRequiredError extends Error {
         return { id: this.id, message: this.message };
     }
 }
+/**
+ * Thrown by `postgresDatabase.destroy` when the database can't be found under
+ * the requested app but does exist under another app. Restores the CLI's
+ * historical "is on <app> not <app>" guidance so a database scoped to the
+ * wrong app surfaces a targeted error rather than a bare not-found.
+ */
+export class AddonAppMismatchError extends Error {
+    addon;
+    requestedApp;
+    id = 'app_mismatch';
+    constructor(addon, requestedApp) {
+        super(`Database ${addon.name} is on ${addon.app.name} not ${requestedApp}. Try again with the correct app.`);
+        this.addon = addon;
+        this.requestedApp = requestedApp;
+        this.name = 'AddonAppMismatchError';
+    }
+    get body() {
+        return { id: this.id, message: this.message };
+    }
+}
+/**
+ * Thrown by `postgresDatabase.destroy` when the delete request (or its
+ * deprovisioning wait) fails after the database was resolved and any
+ * `beforeDestroy` confirmation passed. Carries the resolved add-on so callers
+ * can render tier-specific guidance without re-resolving; the underlying
+ * failure is preserved as the standard `cause`.
+ */
+export class AddonDestroyFailedError extends Error {
+    addon;
+    id = 'destroy_failed';
+    constructor(addon, cause) {
+        super(messageFromCause(cause), { cause });
+        this.addon = addon;
+        this.name = 'AddonDestroyFailedError';
+    }
+    get body() {
+        return { id: this.id, message: this.message };
+    }
+}
+function messageFromCause(cause) {
+    if (typeof cause === 'object' && cause !== null) {
+        const { body } = cause;
+        if (body?.message) {
+            return body.message;
+        }
+        const { message } = cause;
+        if (message) {
+            return message;
+        }
+    }
+    return String(cause);
+}
 /**
  * Thrown by `createAndWait` when the Platform reports the add-on
  * settled into a non-provisioned terminal state (e.g. `deprovisioned`).

package/dist/resources/platform/add-on/index.d.ts

@@ -5,17 +5,17 @@ import { formatPlanPriceLabel, priceForPlan } from './pricing.js';
 export { createAndWait } from './create-and-wait.js';
 export { describeAddon } from './describe.js';
 export { destroyAndWait } from './destroy-and-wait.js';
-export { AddonAmbiguousError, AddonConfirmationRequiredError, AddonNotFoundError, AddonProvisioningFailedError, } from './errors.js';
+export { AddonAmbiguousError, AddonAppMismatchError, AddonConfirmationRequiredError, AddonDestroyFailedError, AddonNotFoundError, AddonProvisioningFailedError, } from './errors.js';
 export { listPlans, listPlansForAddon, type ListPlansForAddonOptions } from './list-plans.js';
 export { formatPlanPriceLabel, type FormatPlanPriceLabelOptions, type PlanPriceBreakdown, type PlanPriceKind, priceForPlan, } from './pricing.js';
 export { resolveAddon } from './resolve.js';
-export type { AddOnOptions, CreateAndWaitOptions, DescribedAddOn, DestroyAndWaitOptions, ResolveAddonOptions, ResolvedAddOn, UpgradeAddOnOptions, WaitForProvisioningOptions, } from './types.js';
+export type { AddOnOptions, CreateAndWaitOptions, DeprovisioningAddOn, DescribedAddOn, DestroyAndWaitOptions, ResolveAddonOptions, ResolvedAddOn, UpgradeAddOnOptions, WaitForProvisioningOptions, } from './types.js';
 export { upgrade } from './upgrade.js';
 export { waitForProvisioning } from './wait-for-provisioning.js';
 export declare const addOnExtensions: import("../../../core/extend-resource.js").ResourceExtension<"platform", "addOn", {
     createAndWait: (appIdentity: string, body: AddOnCreateOpts, options?: CreateAndWaitOptions) => Promise<AddOn>;
     describe: (addonIdentity: string, options?: ResolveAddonOptions) => Promise<import("./types.js").DescribedAddOn>;
-    destroyAndWait: (appIdentity: string, addonIdentity: string, options?: DestroyAndWaitOptions) => Promise<AddOn>;
+    destroyAndWait: (appIdentity: string, addonIdentity: string, options?: DestroyAndWaitOptions) => Promise<import("./types.js").DeprovisioningAddOn>;
     formatPlanPriceLabel: typeof formatPlanPriceLabel;
     listPlans: (serviceIdentity: string, options?: AddOnOptions) => Promise<import("@heroku/types/3.sdk").Plan[]>;
     listPlansForAddon: (addonIdentity: string, options?: ListPlansForAddonOptions) => Promise<import("@heroku/types/3.sdk").Plan[]>;

package/dist/resources/platform/add-on/index.js

@@ -10,7 +10,7 @@ import { waitForProvisioning } from './wait-for-provisioning.js';
 export { createAndWait } from './create-and-wait.js';
 export { describeAddon } from './describe.js';
 export { destroyAndWait } from './destroy-and-wait.js';
-export { AddonAmbiguousError, AddonConfirmationRequiredError, AddonNotFoundError, AddonProvisioningFailedError, } from './errors.js';
+export { AddonAmbiguousError, AddonAppMismatchError, AddonConfirmationRequiredError, AddonDestroyFailedError, AddonNotFoundError, AddonProvisioningFailedError, } from './errors.js';
 export { listPlans, listPlansForAddon } from './list-plans.js';
 export { formatPlanPriceLabel, priceForPlan, } from './pricing.js';
 export { resolveAddon } from './resolve.js';

package/dist/resources/platform/add-on/types.d.ts

@@ -25,6 +25,19 @@ export type ResolvedAddOn = AddOn & {
 export type DescribedAddOn = ResolvedAddOn & {
     attachments: AddOnAttachment[];
 };
+/**
+ * An add-on that may still be deprovisioning. The platform returns
+ * `deprovisioning` as a transient `state` while a delete is in flight, but
+ * `@heroku/types` models only the terminal states. Methods that surface an
+ * in-flight delete response (e.g. `destroyAndWait` returning before the poll)
+ * return this so callers can branch on `deprovisioning` without casting `state`.
+ *
+ * Stopgap: once `@heroku/types`' `AddOn['state']` includes `deprovisioning`,
+ * this type collapses to `AddOn` and should be deleted.
+ */
+export type DeprovisioningAddOn = Omit<AddOn, 'state'> & {
+    state: 'deprovisioning' | AddOn['state'];
+};
 export type UpgradeAddOnOptions = ResolveAddonOptions & {
     onResolved?: (addon: ResolvedAddOn) => Promise<void> | void;
 };
@@ -43,7 +56,7 @@ export type DestroyAndWaitOptions = {
      * Only invoked when `wait: true` and the delete response state is
      * `deprovisioning`.
      */
-    onDeprovisioning?: (addon: AddOn) => Promise<void> | void;
+    onDeprovisioning?: (addon: DeprovisioningAddOn) => Promise<void> | void;
     /**
      * If true, poll until the add-on leaves `deprovisioning`. If the
      * terminal state is not `deprovisioned`, throws `AddonProvisioningFailedError`.

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "0.12.2";
+export declare const SDK_VERSION = "0.12.4";

package/dist/version.js

@@ -1,2 +1,2 @@
 // Generated from package.json by scripts/write-version.mjs (build prebuild). Do not edit.
-export const SDK_VERSION = '0.12.2';
+export const SDK_VERSION = '0.12.4';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heroku/sdk",
-  "version": "0.12.2",
+  "version": "0.12.4",
   "description": "Heroku SDK",
   "author": "Heroku",
   "type": "module",