feat: add API to pull account info

.sdk.json

@@ -1,5 +1,5 @@
 {
-  "id": "88c7735c-a5b9-4bd6-aac7-a4e1dbdd3200",
+  "id": "a3774c17-32bb-4640-bcac-f894d270aca5",
   "tracked_paths": [
     {
       "editable": true,
@@ -49,6 +49,22 @@
       "editable": true,
       "path": "src/resources/v1/README.md"
     },
+    {
+      "editable": true,
+      "path": "src/resources/v1/account/README.md"
+    },
+    {
+      "editable": true,
+      "path": "src/resources/v1/account/index.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/resources/v1/account/request-types.ts"
+    },
+    {
+      "editable": true,
+      "path": "src/resources/v1/account/resource-client.ts"
+    },
     {
       "editable": true,
       "path": "src/resources/v1/ai-clothes-changer/README.md"
@@ -593,6 +609,34 @@
       "editable": true,
       "path": "src/types/index.ts"
     },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response-subscription-billing-interval-enum.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response-subscription-discount.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response-subscription-price.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response-subscription-status-enum.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response-subscription.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response-tier-enum.ts"
+    },
+    {
+      "editable": false,
+      "path": "src/types/v1-account-list-response.ts"
+    },
     {
       "editable": false,
       "path": "src/types/v1-ai-clothes-changer-create-body-assets-garment-type-enum.ts"
@@ -1285,6 +1329,10 @@
       "editable": false,
       "path": "src/types/v1-video-to-video-create-response.ts"
     },
+    {
+      "editable": false,
+      "path": "test/v1-account.test.ts"
+    },
     {
       "editable": false,
       "path": "test/v1-ai-clothes-changer.test.ts"

README.md

@@ -201,6 +201,10 @@ Valid values are: `none`, `error`, `warn`, `info`, `debug` (case insensitive). I
 
 ## Module Documentation and Snippets
 
+### [v1.account](src/resources/v1/account/README.md)
+
+- [list](src/resources/v1/account/README.md#list) - Get account details
+
 ### [v1.aiClothesChanger](src/resources/v1/ai-clothes-changer/README.md)
 
 - [create](src/resources/v1/ai-clothes-changer/README.md#create) - AI Clothes Changer

package.json

@@ -1,6 +1,6 @@
 {
   "name": "magic-hour",
-  "version": "0.74.1",
+  "version": "0.75.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "exports": {

src/README.md

@@ -2,6 +2,7 @@
 
 ## Submodules
 
+- [account](resources/v1/account/README.md) - account
 - [ai-clothes-changer](resources/v1/ai-clothes-changer/README.md) - ai-clothes-changer
 - [ai-face-editor](resources/v1/ai-face-editor/README.md) - ai-face-editor
 - [ai-gif-generator](resources/v1/ai-gif-generator/README.md) - ai-gif-generator

src/environment.ts

@@ -1,4 +1,4 @@
 export enum Environment {
   Environment = "https://api.magichour.ai",
-  MockServer = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.78.1",
+  MockServer = "https://api.sideko.dev/v1/mock/magichour/magic-hour/0.79.0",
 }

src/resources/v1/README.md

@@ -2,6 +2,7 @@
 
 ## Submodules
 
+- [account](account/README.md) - account
 - [ai-clothes-changer](ai-clothes-changer/README.md) - ai-clothes-changer
 - [ai-face-editor](ai-face-editor/README.md) - ai-face-editor
 - [ai-gif-generator](ai-gif-generator/README.md) - ai-gif-generator

src/resources/v1/account/README.md

@@ -0,0 +1,30 @@
+# v1.account
+
+## Module Functions
+
+### Get account details <a name="list"></a>
+
+Get the current credit balance and subscription details of the account that owns the API key.
+
+**API Endpoint**: `GET /v1/account`
+
+#### Example Snippet
+
+```typescript
+import { Client } from "magic-hour";
+
+const client = new Client({ token: process.env["API_TOKEN"]!! });
+const res = await client.v1.account.list();
+```
+
+#### Response
+
+##### Type
+
+[V1AccountListResponse](/src/types/v1-account-list-response.ts)
+
+##### Example
+
+```typescript
+{"credits": 12500, "email": "user@example.com", "id": "cuid-example", "subscription": {"billingInterval": "month", "cancelAtPeriodEnd": false, "currentPeriodEnd": "2026-10-01T00:00:00.000Z", "discount": {"amountOff": 123, "percentOff": 20.0}, "name": "Pro", "price": {"amount": 4900, "currency": "usd"}, "status": "active"}, "tier": "pro"}
+```

src/resources/v1/account/index.ts

@@ -0,0 +1 @@
+export { AccountClient } from "./resource-client";

src/resources/v1/account/resource-client.ts

@@ -0,0 +1,33 @@
+import {
+  ApiPromise,
+  CoreClient,
+  CoreResourceClient,
+  RequestOptions,
+  ResourceClientOptions,
+} from "make-api-request-js";
+
+import * as types from "magic-hour/types";
+import { Schemas$V1AccountListResponse } from "magic-hour/types/v1-account-list-response";
+
+export class AccountClient extends CoreResourceClient {
+  constructor(coreClient: CoreClient, opts: ResourceClientOptions) {
+    super(coreClient, opts);
+  }
+
+  /**
+   * Get account details
+   *
+   * Get the current credit balance and subscription details of the account that owns the API key.
+   *
+   * GET /v1/account
+   */
+  list(opts?: RequestOptions): ApiPromise<types.V1AccountListResponse> {
+    return this._client.makeRequest({
+      method: "get",
+      path: "/v1/account",
+      auth: ["bearerAuth"],
+      responseSchema: Schemas$V1AccountListResponse.in,
+      opts,
+    });
+  }
+}

src/resources/v1/index.ts

@@ -1,3 +1,4 @@
+export * as account from "./account";
 export * as aiClothesChanger from "./ai-clothes-changer";
 export * as aiFaceEditor from "./ai-face-editor";
 export * as aiGifGenerator from "./ai-gif-generator";

src/resources/v1/resource-client.ts

@@ -4,6 +4,7 @@ import {
   ResourceClientOptions,
 } from "make-api-request-js";
 
+import { AccountClient } from "magic-hour/resources/v1/account";
 import { AiClothesChangerClient } from "magic-hour/resources/v1/ai-clothes-changer";
 import { AiFaceEditorClient } from "magic-hour/resources/v1/ai-face-editor";
 import { AiGifGeneratorClient } from "magic-hour/resources/v1/ai-gif-generator";
@@ -38,6 +39,7 @@ import { VideoProjectsClient } from "magic-hour/resources/v1/video-projects";
 import { VideoToVideoClient } from "magic-hour/resources/v1/video-to-video";
 
 export class V1Client extends CoreResourceClient {
+  private _accountLazy?: AccountClient; // lazy-loading cache
   private _characterReplaceLazy?: CharacterReplaceClient; // lazy-loading cache
   private _aiVideoEditorLazy?: AiVideoEditorClient; // lazy-loading cache
   private _audioToVideoLazy?: AudioToVideoClient; // lazy-loading cache
@@ -75,6 +77,7 @@ export class V1Client extends CoreResourceClient {
   constructor(coreClient: CoreClient, opts: ResourceClientOptions) {
     super(coreClient, opts);
     if (this._opts.lazyLoad === false) {
+      this.account;
       this.aiClothesChanger;
       this.aiFaceEditor;
       this.aiGifGenerator;
@@ -455,4 +458,14 @@ export class V1Client extends CoreResourceClient {
         ))
     );
   }
+
+  get account(): AccountClient {
+    return (
+      this._accountLazy ??
+      (this._accountLazy = new (require("./account").AccountClient)(
+        this._client,
+        this._opts,
+      ))
+    );
+  }
 }

src/types/index.ts

@@ -1,3 +1,10 @@
+export { V1AccountListResponse } from "./v1-account-list-response";
+export { V1AccountListResponseSubscription } from "./v1-account-list-response-subscription";
+export { V1AccountListResponseSubscriptionBillingIntervalEnum } from "./v1-account-list-response-subscription-billing-interval-enum";
+export { V1AccountListResponseSubscriptionDiscount } from "./v1-account-list-response-subscription-discount";
+export { V1AccountListResponseSubscriptionPrice } from "./v1-account-list-response-subscription-price";
+export { V1AccountListResponseSubscriptionStatusEnum } from "./v1-account-list-response-subscription-status-enum";
+export { V1AccountListResponseTierEnum } from "./v1-account-list-response-tier-enum";
 export { V1AiClothesChangerCreateBody } from "./v1-ai-clothes-changer-create-body";
 export { V1AiClothesChangerCreateBodyAssets } from "./v1-ai-clothes-changer-create-body-assets";
 export { V1AiClothesChangerCreateBodyAssetsGarmentTypeEnum } from "./v1-ai-clothes-changer-create-body-assets-garment-type-enum";

src/types/v1-account-list-response-subscription-billing-interval-enum.ts

@@ -0,0 +1,6 @@
+/**
+ * How often the subscription is billed. `null` if unknown.
+ */
+export type V1AccountListResponseSubscriptionBillingIntervalEnum =
+  | "month"
+  | "year";

src/types/v1-account-list-response-subscription-discount.ts

@@ -0,0 +1,70 @@
+import { zodTransform } from "make-api-request-js";
+import * as z from "zod";
+
+/**
+ * Discount applied to the subscription. `null` if no discount is applied.
+ */
+export type V1AccountListResponseSubscriptionDiscount = {
+  /**
+   * Fixed amount taken off `price.amount` each billing interval, in the smallest unit of the currency. `null` if the discount is a percentage.
+   */
+  amountOff: number | null;
+  /**
+   * Percentage taken off `price.amount` each billing interval. `null` if the discount is a fixed amount.
+   */
+  percentOff: number | null;
+};
+
+/**
+ * @internal
+ * V1AccountListResponseSubscriptionDiscount without any key transformation, this is what
+ * we expect to come in as network data
+ */
+export type External$V1AccountListResponseSubscriptionDiscount = {
+  amount_off: number | null;
+  percent_off: number | null;
+};
+
+/**
+ * Takes network data, validates it, and transforms keys to match typescript object V1AccountListResponseSubscriptionDiscount
+ */
+const SchemaIn$V1AccountListResponseSubscriptionDiscount: z.ZodType<
+  V1AccountListResponseSubscriptionDiscount, // output type of this zod object
+  z.ZodTypeDef,
+  unknown
+> = z
+  .object({
+    amount_off: z.number().int().nullable(),
+    percent_off: z.number().nullable(),
+  })
+  .transform((obj) => {
+    return zodTransform(obj, {
+      amount_off: "amountOff",
+      percent_off: "percentOff",
+    });
+  });
+
+/**
+ * @internal
+ * Takes typescript data, validates it, and maps keys to match the expected external object External$V1AccountListResponseSubscriptionDiscount
+ */
+const SchemaOut$V1AccountListResponseSubscriptionDiscount: z.ZodType<
+  External$V1AccountListResponseSubscriptionDiscount, // output type of this zod object
+  z.ZodTypeDef,
+  V1AccountListResponseSubscriptionDiscount // the object to be transformed
+> = z
+  .object({
+    amountOff: z.number().int().nullable(),
+    percentOff: z.number().nullable(),
+  })
+  .transform((obj) => {
+    return zodTransform(obj, {
+      amountOff: "amount_off",
+      percentOff: "percent_off",
+    });
+  });
+
+export const Schemas$V1AccountListResponseSubscriptionDiscount = {
+  in: SchemaIn$V1AccountListResponseSubscriptionDiscount,
+  out: SchemaOut$V1AccountListResponseSubscriptionDiscount,
+};