@polar-sh/sdk 0.32.4 → 0.32.7

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.32.4",
+    currentVersion: "0.32.7",
   },
 });
 

package/src/mcp-server/prompts.ts

@@ -74,7 +74,14 @@ export function createRegisterPrompt(
     prompt: PromptDefinition<A>,
   ): void => {
     const scopes = prompt.scopes ?? [];
-    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+    if (allowedScopes.size > 0 && scopes.length === 0) {
+      return;
+    }
+
+    if (
+      allowedScopes.size > 0
+      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
+    ) {
       return;
     }
 

package/src/mcp-server/resources.ts

@@ -109,7 +109,14 @@ export function createRegisterResource(
 ): (resource: ResourceDefinition) => void {
   return (resource: ResourceDefinition): void => {
     const scopes = resource.scopes ?? [];
-    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+    if (allowedScopes.size > 0 && scopes.length === 0) {
+      return;
+    }
+
+    if (
+      allowedScopes.size > 0
+      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
+    ) {
       return;
     }
 
@@ -137,7 +144,14 @@ export function createRegisterResourceTemplate(
 ): (resource: ResourceTemplateDefinition) => void {
   return (resource: ResourceTemplateDefinition): void => {
     const scopes = resource.scopes ?? [];
-    if (!scopes.every((s: MCPScope) => allowedScopes.has(s))) {
+    if (allowedScopes.size > 0 && scopes.length === 0) {
+      return;
+    }
+
+    if (
+      allowedScopes.size > 0
+      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
+    ) {
       return;
     }
 

package/src/mcp-server/scopes.ts

@@ -3,6 +3,7 @@
  */
 
 export const mcpScopes = [
+  "customer_meters",
   "customers",
   "metrics",
   "orders",

package/src/mcp-server/server.ts

@@ -11,8 +11,10 @@ import {
   createRegisterResource,
   createRegisterResourceTemplate,
 } from "./resources.js";
-import { MCPScope, mcpScopes } from "./scopes.js";
+import { MCPScope } from "./scopes.js";
 import { createRegisterTool } from "./tools.js";
+import { tool$customerMetersGet } from "./tools/customerMetersGet.js";
+import { tool$customerMetersList } from "./tools/customerMetersList.js";
 import { tool$customersCreate } from "./tools/customersCreate.js";
 import { tool$customersDelete } from "./tools/customersDelete.js";
 import { tool$customersDeleteExternal } from "./tools/customersDeleteExternal.js";
@@ -49,7 +51,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Polar",
-    version: "0.32.4",
+    version: "0.32.7",
   });
 
   const client = new PolarCore({
@@ -58,7 +60,7 @@ export function createMCPServer(deps: {
     server: deps.server,
   });
 
-  const scopes = new Set(deps.scopes ?? mcpScopes);
+  const scopes = new Set(deps.scopes);
 
   const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
   const tool = createRegisterTool(
@@ -104,6 +106,8 @@ export function createMCPServer(deps: {
   tool(tool$customersDeleteExternal);
   tool(tool$customersGetState);
   tool(tool$customersGetStateExternal);
+  tool(tool$customerMetersList);
+  tool(tool$customerMetersGet);
 
   return server;
 }

package/src/mcp-server/tools/customerMetersGet.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { customerMetersGet } from "../../funcs/customerMetersGet.js";
+import { CustomerMetersGetRequest$inboundSchema } from "../../models/operations/customermetersget.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CustomerMetersGetRequest$inboundSchema,
+};
+
+export const tool$customerMetersGet: ToolDefinition<typeof args> = {
+  name: "customer-meters-get",
+  description: `Get Customer Meter
+
+Get a customer meter by ID.
+
+**Scopes**: \`customer_meters:read\``,
+  scopes: ["read", "customer_meters"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await customerMetersGet(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/customerMetersList.ts

@@ -0,0 +1,40 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { customerMetersList } from "../../funcs/customerMetersList.js";
+import { CustomerMetersListRequest$inboundSchema } from "../../models/operations/customermeterslist.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CustomerMetersListRequest$inboundSchema,
+};
+
+export const tool$customerMetersList: ToolDefinition<typeof args> = {
+  name: "customer-meters-list",
+  description: `List Customer Meters
+
+List customer meters.
+
+**Scopes**: \`customer_meters:read\``,
+  scopes: ["read", "customer_meters"],
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await customerMetersList(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools.ts

@@ -102,12 +102,15 @@ export function createRegisterTool(
       return;
     }
 
-    const toolScopes = tool.scopes ?? [];
-    if (allowedScopes.size > 0 && toolScopes.length === 0) {
+    const scopes = tool.scopes ?? [];
+    if (allowedScopes.size > 0 && scopes.length === 0) {
       return;
     }
 
-    if (!toolScopes.every((s) => allowedScopes.has(s))) {
+    if (
+      allowedScopes.size > 0
+      && !scopes.every((s: MCPScope) => allowedScopes.has(s))
+    ) {
       return;
     }
 

package/src/models/components/benefitgrantmetercreditproperties.ts

@@ -0,0 +1,90 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+export type BenefitGrantMeterCreditProperties = {
+  lastCreditedMeterId: string;
+  lastCreditedUnits: number;
+  lastCreditedAt: string;
+};
+
+/** @internal */
+export const BenefitGrantMeterCreditProperties$inboundSchema: z.ZodType<
+  BenefitGrantMeterCreditProperties,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  last_credited_meter_id: z.string(),
+  last_credited_units: z.number().int(),
+  last_credited_at: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "last_credited_meter_id": "lastCreditedMeterId",
+    "last_credited_units": "lastCreditedUnits",
+    "last_credited_at": "lastCreditedAt",
+  });
+});
+
+/** @internal */
+export type BenefitGrantMeterCreditProperties$Outbound = {
+  last_credited_meter_id: string;
+  last_credited_units: number;
+  last_credited_at: string;
+};
+
+/** @internal */
+export const BenefitGrantMeterCreditProperties$outboundSchema: z.ZodType<
+  BenefitGrantMeterCreditProperties$Outbound,
+  z.ZodTypeDef,
+  BenefitGrantMeterCreditProperties
+> = z.object({
+  lastCreditedMeterId: z.string(),
+  lastCreditedUnits: z.number().int(),
+  lastCreditedAt: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    lastCreditedMeterId: "last_credited_meter_id",
+    lastCreditedUnits: "last_credited_units",
+    lastCreditedAt: "last_credited_at",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BenefitGrantMeterCreditProperties$ {
+  /** @deprecated use `BenefitGrantMeterCreditProperties$inboundSchema` instead. */
+  export const inboundSchema = BenefitGrantMeterCreditProperties$inboundSchema;
+  /** @deprecated use `BenefitGrantMeterCreditProperties$outboundSchema` instead. */
+  export const outboundSchema =
+    BenefitGrantMeterCreditProperties$outboundSchema;
+  /** @deprecated use `BenefitGrantMeterCreditProperties$Outbound` instead. */
+  export type Outbound = BenefitGrantMeterCreditProperties$Outbound;
+}
+
+export function benefitGrantMeterCreditPropertiesToJSON(
+  benefitGrantMeterCreditProperties: BenefitGrantMeterCreditProperties,
+): string {
+  return JSON.stringify(
+    BenefitGrantMeterCreditProperties$outboundSchema.parse(
+      benefitGrantMeterCreditProperties,
+    ),
+  );
+}
+
+export function benefitGrantMeterCreditPropertiesFromJSON(
+  jsonString: string,
+): SafeParseResult<BenefitGrantMeterCreditProperties, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BenefitGrantMeterCreditProperties$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BenefitGrantMeterCreditProperties' from JSON`,
+  );
+}

package/src/models/components/benefitmetercreditcreateproperties.ts

@@ -12,7 +12,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * Properties for creating a benefit of type `meter_unit`.
  */
 export type BenefitMeterCreditCreateProperties = {
-  unit: number;
+  units: number;
   meterId: string;
 };
 
@@ -22,7 +22,7 @@ export const BenefitMeterCreditCreateProperties$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  unit: z.number().int(),
+  units: z.number().int(),
   meter_id: z.string(),
 }).transform((v) => {
   return remap$(v, {
@@ -32,7 +32,7 @@ export const BenefitMeterCreditCreateProperties$inboundSchema: z.ZodType<
 
 /** @internal */
 export type BenefitMeterCreditCreateProperties$Outbound = {
-  unit: number;
+  units: number;
   meter_id: string;
 };
 
@@ -42,7 +42,7 @@ export const BenefitMeterCreditCreateProperties$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   BenefitMeterCreditCreateProperties
 > = z.object({
-  unit: z.number().int(),
+  units: z.number().int(),
   meterId: z.string(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/benefitmetercreditproperties.ts

@@ -12,7 +12,7 @@ import { SDKValidationError } from "../errors/sdkvalidationerror.js";
  * Properties for a benefit of type `meter_unit`.
  */
 export type BenefitMeterCreditProperties = {
-  unit: number;
+  units: number;
   meterId: string;
 };
 
@@ -22,7 +22,7 @@ export const BenefitMeterCreditProperties$inboundSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  unit: z.number().int(),
+  units: z.number().int(),
   meter_id: z.string(),
 }).transform((v) => {
   return remap$(v, {
@@ -32,7 +32,7 @@ export const BenefitMeterCreditProperties$inboundSchema: z.ZodType<
 
 /** @internal */
 export type BenefitMeterCreditProperties$Outbound = {
-  unit: number;
+  units: number;
   meter_id: string;
 };
 
@@ -42,7 +42,7 @@ export const BenefitMeterCreditProperties$outboundSchema: z.ZodType<
   z.ZodTypeDef,
   BenefitMeterCreditProperties
 > = z.object({
-  unit: z.number().int(),
+  units: z.number().int(),
   meterId: z.string(),
 }).transform((v) => {
   return remap$(v, {

package/src/models/components/benefitmetercreditsubscriber.ts

@@ -0,0 +1,155 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+import {
+  BenefitMeterCreditSubscriberProperties,
+  BenefitMeterCreditSubscriberProperties$inboundSchema,
+  BenefitMeterCreditSubscriberProperties$Outbound,
+  BenefitMeterCreditSubscriberProperties$outboundSchema,
+} from "./benefitmetercreditsubscriberproperties.js";
+import {
+  Organization,
+  Organization$inboundSchema,
+  Organization$Outbound,
+  Organization$outboundSchema,
+} from "./organization.js";
+
+export type BenefitMeterCreditSubscriber = {
+  /**
+   * Creation timestamp of the object.
+   */
+  createdAt: Date;
+  /**
+   * Last modification timestamp of the object.
+   */
+  modifiedAt: Date | null;
+  /**
+   * The ID of the benefit.
+   */
+  id: string;
+  type?: "meter_credit" | undefined;
+  /**
+   * The description of the benefit.
+   */
+  description: string;
+  /**
+   * Whether the benefit is selectable when creating a product.
+   */
+  selectable: boolean;
+  /**
+   * Whether the benefit is deletable.
+   */
+  deletable: boolean;
+  /**
+   * The ID of the organization owning the benefit.
+   */
+  organizationId: string;
+  organization: Organization;
+  /**
+   * Properties available to subscribers for a benefit of type `meter_unit`.
+   */
+  properties: BenefitMeterCreditSubscriberProperties;
+};
+
+/** @internal */
+export const BenefitMeterCreditSubscriber$inboundSchema: z.ZodType<
+  BenefitMeterCreditSubscriber,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  created_at: z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  modified_at: z.nullable(
+    z.string().datetime({ offset: true }).transform(v => new Date(v)),
+  ),
+  id: z.string(),
+  type: z.literal("meter_credit").optional(),
+  description: z.string(),
+  selectable: z.boolean(),
+  deletable: z.boolean(),
+  organization_id: z.string(),
+  organization: Organization$inboundSchema,
+  properties: BenefitMeterCreditSubscriberProperties$inboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    "created_at": "createdAt",
+    "modified_at": "modifiedAt",
+    "organization_id": "organizationId",
+  });
+});
+
+/** @internal */
+export type BenefitMeterCreditSubscriber$Outbound = {
+  created_at: string;
+  modified_at: string | null;
+  id: string;
+  type: "meter_credit";
+  description: string;
+  selectable: boolean;
+  deletable: boolean;
+  organization_id: string;
+  organization: Organization$Outbound;
+  properties: BenefitMeterCreditSubscriberProperties$Outbound;
+};
+
+/** @internal */
+export const BenefitMeterCreditSubscriber$outboundSchema: z.ZodType<
+  BenefitMeterCreditSubscriber$Outbound,
+  z.ZodTypeDef,
+  BenefitMeterCreditSubscriber
+> = z.object({
+  createdAt: z.date().transform(v => v.toISOString()),
+  modifiedAt: z.nullable(z.date().transform(v => v.toISOString())),
+  id: z.string(),
+  type: z.literal("meter_credit").default("meter_credit" as const),
+  description: z.string(),
+  selectable: z.boolean(),
+  deletable: z.boolean(),
+  organizationId: z.string(),
+  organization: Organization$outboundSchema,
+  properties: BenefitMeterCreditSubscriberProperties$outboundSchema,
+}).transform((v) => {
+  return remap$(v, {
+    createdAt: "created_at",
+    modifiedAt: "modified_at",
+    organizationId: "organization_id",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BenefitMeterCreditSubscriber$ {
+  /** @deprecated use `BenefitMeterCreditSubscriber$inboundSchema` instead. */
+  export const inboundSchema = BenefitMeterCreditSubscriber$inboundSchema;
+  /** @deprecated use `BenefitMeterCreditSubscriber$outboundSchema` instead. */
+  export const outboundSchema = BenefitMeterCreditSubscriber$outboundSchema;
+  /** @deprecated use `BenefitMeterCreditSubscriber$Outbound` instead. */
+  export type Outbound = BenefitMeterCreditSubscriber$Outbound;
+}
+
+export function benefitMeterCreditSubscriberToJSON(
+  benefitMeterCreditSubscriber: BenefitMeterCreditSubscriber,
+): string {
+  return JSON.stringify(
+    BenefitMeterCreditSubscriber$outboundSchema.parse(
+      benefitMeterCreditSubscriber,
+    ),
+  );
+}
+
+export function benefitMeterCreditSubscriberFromJSON(
+  jsonString: string,
+): SafeParseResult<BenefitMeterCreditSubscriber, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => BenefitMeterCreditSubscriber$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BenefitMeterCreditSubscriber' from JSON`,
+  );
+}

package/src/models/components/benefitmetercreditsubscriberproperties.ts

@@ -0,0 +1,88 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { remap as remap$ } from "../../lib/primitives.js";
+import { safeParse } from "../../lib/schemas.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * Properties available to subscribers for a benefit of type `meter_unit`.
+ */
+export type BenefitMeterCreditSubscriberProperties = {
+  units: number;
+  meterId: string;
+};
+
+/** @internal */
+export const BenefitMeterCreditSubscriberProperties$inboundSchema: z.ZodType<
+  BenefitMeterCreditSubscriberProperties,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  units: z.number().int(),
+  meter_id: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    "meter_id": "meterId",
+  });
+});
+
+/** @internal */
+export type BenefitMeterCreditSubscriberProperties$Outbound = {
+  units: number;
+  meter_id: string;
+};
+
+/** @internal */
+export const BenefitMeterCreditSubscriberProperties$outboundSchema: z.ZodType<
+  BenefitMeterCreditSubscriberProperties$Outbound,
+  z.ZodTypeDef,
+  BenefitMeterCreditSubscriberProperties
+> = z.object({
+  units: z.number().int(),
+  meterId: z.string(),
+}).transform((v) => {
+  return remap$(v, {
+    meterId: "meter_id",
+  });
+});
+
+/**
+ * @internal
+ * @deprecated This namespace will be removed in future versions. Use schemas and types that are exported directly from this module.
+ */
+export namespace BenefitMeterCreditSubscriberProperties$ {
+  /** @deprecated use `BenefitMeterCreditSubscriberProperties$inboundSchema` instead. */
+  export const inboundSchema =
+    BenefitMeterCreditSubscriberProperties$inboundSchema;
+  /** @deprecated use `BenefitMeterCreditSubscriberProperties$outboundSchema` instead. */
+  export const outboundSchema =
+    BenefitMeterCreditSubscriberProperties$outboundSchema;
+  /** @deprecated use `BenefitMeterCreditSubscriberProperties$Outbound` instead. */
+  export type Outbound = BenefitMeterCreditSubscriberProperties$Outbound;
+}
+
+export function benefitMeterCreditSubscriberPropertiesToJSON(
+  benefitMeterCreditSubscriberProperties:
+    BenefitMeterCreditSubscriberProperties,
+): string {
+  return JSON.stringify(
+    BenefitMeterCreditSubscriberProperties$outboundSchema.parse(
+      benefitMeterCreditSubscriberProperties,
+    ),
+  );
+}
+
+export function benefitMeterCreditSubscriberPropertiesFromJSON(
+  jsonString: string,
+): SafeParseResult<BenefitMeterCreditSubscriberProperties, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) =>
+      BenefitMeterCreditSubscriberProperties$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'BenefitMeterCreditSubscriberProperties' from JSON`,
+  );
+}

package/src/models/components/checkout.ts

@@ -156,7 +156,7 @@ export type Checkout = {
   /**
    * Currency code of the checkout session.
    */
-  currency: string | null;
+  currency: string;
   /**
    * ID of the product to checkout.
    */
@@ -547,7 +547,7 @@ export const Checkout$inboundSchema: z.ZodType<
   net_amount: z.number().int(),
   tax_amount: z.nullable(z.number().int()),
   total_amount: z.number().int(),
-  currency: z.nullable(z.string()),
+  currency: z.string(),
   product_id: z.string(),
   product_price_id: z.string(),
   discount_id: z.nullable(z.string()),
@@ -645,7 +645,7 @@ export type Checkout$Outbound = {
   net_amount: number;
   tax_amount: number | null;
   total_amount: number;
-  currency: string | null;
+  currency: string;
   product_id: string;
   product_price_id: string;
   discount_id: string | null;
@@ -710,7 +710,7 @@ export const Checkout$outboundSchema: z.ZodType<
   netAmount: z.number().int(),
   taxAmount: z.nullable(z.number().int()),
   totalAmount: z.number().int(),
-  currency: z.nullable(z.string()),
+  currency: z.string(),
   productId: z.string(),
   productPriceId: z.string(),
   discountId: z.nullable(z.string()),

package/src/models/components/checkoutpublic.ts

@@ -160,7 +160,7 @@ export type CheckoutPublic = {
   /**
    * Currency code of the checkout session.
    */
-  currency: string | null;
+  currency: string;
   /**
    * ID of the product to checkout.
    */
@@ -451,7 +451,7 @@ export const CheckoutPublic$inboundSchema: z.ZodType<
   net_amount: z.number().int(),
   tax_amount: z.nullable(z.number().int()),
   total_amount: z.number().int(),
-  currency: z.nullable(z.string()),
+  currency: z.string(),
   product_id: z.string(),
   product_price_id: z.string(),
   discount_id: z.nullable(z.string()),
@@ -541,7 +541,7 @@ export type CheckoutPublic$Outbound = {
   net_amount: number;
   tax_amount: number | null;
   total_amount: number;
-  currency: string | null;
+  currency: string;
   product_id: string;
   product_price_id: string;
   discount_id: string | null;
@@ -603,7 +603,7 @@ export const CheckoutPublic$outboundSchema: z.ZodType<
   netAmount: z.number().int(),
   taxAmount: z.nullable(z.number().int()),
   totalAmount: z.number().int(),
-  currency: z.nullable(z.string()),
+  currency: z.string(),
   productId: z.string(),
   productPriceId: z.string(),
   discountId: z.nullable(z.string()),