dub 0.70.0 → 0.71.0

package/src/models/operations/listbountysubmissions.ts

@@ -0,0 +1,287 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { safeParse } from "../../lib/schemas.js";
+import { ClosedEnum } from "../../types/enums.js";
+import { Result as SafeParseResult } from "../../types/fp.js";
+import { SDKValidationError } from "../errors/sdkvalidationerror.js";
+
+/**
+ * The status of the submissions to list.
+ */
+export const ListBountySubmissionsQueryParamStatus = {
+  Draft: "draft",
+  Submitted: "submitted",
+  Approved: "approved",
+  Rejected: "rejected",
+} as const;
+/**
+ * The status of the submissions to list.
+ */
+export type ListBountySubmissionsQueryParamStatus = ClosedEnum<
+  typeof ListBountySubmissionsQueryParamStatus
+>;
+
+/**
+ * The field to sort the submissions by.
+ */
+export const ListBountySubmissionsQueryParamSortBy = {
+  CompletedAt: "completedAt",
+  PerformanceCount: "performanceCount",
+} as const;
+/**
+ * The field to sort the submissions by.
+ */
+export type ListBountySubmissionsQueryParamSortBy = ClosedEnum<
+  typeof ListBountySubmissionsQueryParamSortBy
+>;
+
+/**
+ * The order to sort the submissions by.
+ */
+export const ListBountySubmissionsQueryParamSortOrder = {
+  Asc: "asc",
+  Desc: "desc",
+} as const;
+/**
+ * The order to sort the submissions by.
+ */
+export type ListBountySubmissionsQueryParamSortOrder = ClosedEnum<
+  typeof ListBountySubmissionsQueryParamSortOrder
+>;
+
+export type ListBountySubmissionsRequest = {
+  /**
+   * The ID of the bounty
+   */
+  bountyId: string;
+  /**
+   * The status of the submissions to list.
+   */
+  status?: ListBountySubmissionsQueryParamStatus | undefined;
+  /**
+   * The ID of the group to list submissions for.
+   */
+  groupId?: string | undefined;
+  /**
+   * The ID of the partner to list submissions for.
+   */
+  partnerId?: string | undefined;
+  /**
+   * The field to sort the submissions by.
+   */
+  sortBy?: ListBountySubmissionsQueryParamSortBy | undefined;
+  /**
+   * The order to sort the submissions by.
+   */
+  sortOrder?: ListBountySubmissionsQueryParamSortOrder | undefined;
+  /**
+   * The page number for pagination.
+   */
+  page?: number | undefined;
+  /**
+   * The number of items per page.
+   */
+  pageSize?: number | undefined;
+};
+
+export type Files = {
+  /**
+   * The URL of the uploaded file.
+   */
+  url: string;
+  /**
+   * The original file name.
+   */
+  fileName: string;
+  /**
+   * The file size in bytes.
+   */
+  size: number;
+};
+
+/**
+ * The status of the submission
+ */
+export const ListBountySubmissionsStatus = {
+  Draft: "draft",
+  Submitted: "submitted",
+  Approved: "approved",
+  Rejected: "rejected",
+} as const;
+/**
+ * The status of the submission
+ */
+export type ListBountySubmissionsStatus = ClosedEnum<
+  typeof ListBountySubmissionsStatus
+>;
+
+export type ListBountySubmissionsResponseBody = {
+  /**
+   * The ID of the bounty submission
+   */
+  id: string;
+  /**
+   * The ID of the bounty
+   */
+  bountyId: string;
+  /**
+   * The ID of the partner
+   */
+  partnerId: string;
+  /**
+   * The description of the submission
+   */
+  description: string | null;
+  /**
+   * The URLs submitted for the submission
+   */
+  urls: Array<string> | null;
+  /**
+   * The files uploaded for the submission
+   */
+  files: Array<Files> | null;
+  /**
+   * The status of the submission
+   */
+  status: ListBountySubmissionsStatus;
+  /**
+   * The performance count of the submission
+   */
+  performanceCount: number | null;
+  /**
+   * The date and time the submission was created
+   */
+  createdAt: string;
+  /**
+   * The date and time the submission was completed
+   */
+  completedAt: string | null;
+  /**
+   * The date and time the submission was reviewed
+   */
+  reviewedAt: string | null;
+  /**
+   * The reason for rejecting the submission
+   */
+  rejectionReason: string | null;
+  /**
+   * The note for rejecting the submission
+   */
+  rejectionNote: string | null;
+};
+
+/** @internal */
+export const ListBountySubmissionsQueryParamStatus$outboundSchema:
+  z.ZodNativeEnum<typeof ListBountySubmissionsQueryParamStatus> = z.nativeEnum(
+    ListBountySubmissionsQueryParamStatus,
+  );
+
+/** @internal */
+export const ListBountySubmissionsQueryParamSortBy$outboundSchema:
+  z.ZodNativeEnum<typeof ListBountySubmissionsQueryParamSortBy> = z.nativeEnum(
+    ListBountySubmissionsQueryParamSortBy,
+  );
+
+/** @internal */
+export const ListBountySubmissionsQueryParamSortOrder$outboundSchema:
+  z.ZodNativeEnum<typeof ListBountySubmissionsQueryParamSortOrder> = z
+    .nativeEnum(ListBountySubmissionsQueryParamSortOrder);
+
+/** @internal */
+export type ListBountySubmissionsRequest$Outbound = {
+  bountyId: string;
+  status?: string | undefined;
+  groupId?: string | undefined;
+  partnerId?: string | undefined;
+  sortBy: string;
+  sortOrder: string;
+  page: number;
+  pageSize: number;
+};
+
+/** @internal */
+export const ListBountySubmissionsRequest$outboundSchema: z.ZodType<
+  ListBountySubmissionsRequest$Outbound,
+  z.ZodTypeDef,
+  ListBountySubmissionsRequest
+> = z.object({
+  bountyId: z.string(),
+  status: ListBountySubmissionsQueryParamStatus$outboundSchema.optional(),
+  groupId: z.string().optional(),
+  partnerId: z.string().optional(),
+  sortBy: ListBountySubmissionsQueryParamSortBy$outboundSchema.default(
+    "completedAt",
+  ),
+  sortOrder: ListBountySubmissionsQueryParamSortOrder$outboundSchema.default(
+    "asc",
+  ),
+  page: z.number().default(1),
+  pageSize: z.number().default(100),
+});
+
+export function listBountySubmissionsRequestToJSON(
+  listBountySubmissionsRequest: ListBountySubmissionsRequest,
+): string {
+  return JSON.stringify(
+    ListBountySubmissionsRequest$outboundSchema.parse(
+      listBountySubmissionsRequest,
+    ),
+  );
+}
+
+/** @internal */
+export const Files$inboundSchema: z.ZodType<Files, z.ZodTypeDef, unknown> = z
+  .object({
+    url: z.string(),
+    fileName: z.string(),
+    size: z.number(),
+  });
+
+export function filesFromJSON(
+  jsonString: string,
+): SafeParseResult<Files, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => Files$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'Files' from JSON`,
+  );
+}
+
+/** @internal */
+export const ListBountySubmissionsStatus$inboundSchema: z.ZodNativeEnum<
+  typeof ListBountySubmissionsStatus
+> = z.nativeEnum(ListBountySubmissionsStatus);
+
+/** @internal */
+export const ListBountySubmissionsResponseBody$inboundSchema: z.ZodType<
+  ListBountySubmissionsResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  id: z.string(),
+  bountyId: z.string(),
+  partnerId: z.string(),
+  description: z.nullable(z.string()),
+  urls: z.nullable(z.array(z.string())),
+  files: z.nullable(z.array(z.lazy(() => Files$inboundSchema))),
+  status: ListBountySubmissionsStatus$inboundSchema,
+  performanceCount: z.nullable(z.number()),
+  createdAt: z.string(),
+  completedAt: z.nullable(z.string()),
+  reviewedAt: z.nullable(z.string()),
+  rejectionReason: z.nullable(z.string()),
+  rejectionNote: z.nullable(z.string()),
+});
+
+export function listBountySubmissionsResponseBodyFromJSON(
+  jsonString: string,
+): SafeParseResult<ListBountySubmissionsResponseBody, SDKValidationError> {
+  return safeParse(
+    jsonString,
+    (x) => ListBountySubmissionsResponseBody$inboundSchema.parse(JSON.parse(x)),
+    `Failed to parse 'ListBountySubmissionsResponseBody' from JSON`,
+  );
+}

package/src/models/operations/listcommissions.ts

@@ -198,10 +198,6 @@ export type ListCommissionsCustomer = {
    * The unique ID of the customer. You may use either the customer's `id` on Dub (obtained via `/customers` endpoint) or their `externalId` (unique ID within your system, prefixed with `ext_`, e.g. `ext_123`).
    */
   id: string;
-  /**
-   * Unique identifier for the customer in the client's app.
-   */
-  externalId: string;
   /**
    * Name of the customer.
    */
@@ -214,6 +210,14 @@ export type ListCommissionsCustomer = {
    * Avatar URL of the customer.
    */
   avatar?: string | null | undefined;
+  /**
+   * Unique identifier for the customer in the client's app.
+   */
+  externalId: string;
+  /**
+   * The customer's Stripe customer ID. This is useful for attributing recurring sale events to the partner who referred the customer.
+   */
+  stripeCustomerId?: string | null | undefined;
   /**
    * Country of the customer.
    */
@@ -227,9 +231,17 @@ export type ListCommissionsCustomer = {
    */
   saleAmount?: number | null | undefined;
   /**
-   * The date the customer was created.
+   * The date the customer was created (usually the signup date or trial start date).
    */
   createdAt: string;
+  /**
+   * The date the customer made their first sale. Useful for calculating the time to first sale and LTV.
+   */
+  firstSaleAt?: string | null | undefined;
+  /**
+   * The date the customer canceled their subscription. Useful for calculating LTV and churn rate.
+   */
+  subscriptionCanceledAt?: string | null | undefined;
 };
 
 export type ListCommissionsResponseBody = {
@@ -374,14 +386,17 @@ export const ListCommissionsCustomer$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   id: z.string(),
-  externalId: z.string(),
   name: z.string(),
   email: z.nullable(z.string()).optional(),
   avatar: z.nullable(z.string()).optional(),
+  externalId: z.string(),
+  stripeCustomerId: z.nullable(z.string()).optional(),
   country: z.nullable(z.string()).optional(),
   sales: z.nullable(z.number()).optional(),
   saleAmount: z.nullable(z.number()).optional(),
   createdAt: z.string(),
+  firstSaleAt: z.nullable(z.string()).optional(),
+  subscriptionCanceledAt: z.nullable(z.string()).optional(),
 });
 
 export function listCommissionsCustomerFromJSON(

package/src/models/operations/listevents.ts

@@ -525,10 +525,6 @@ export type ResponseBodyCustomer = {
    * The unique ID of the customer. You may use either the customer's `id` on Dub (obtained via `/customers` endpoint) or their `externalId` (unique ID within your system, prefixed with `ext_`, e.g. `ext_123`).
    */
   id: string;
-  /**
-   * Unique identifier for the customer in the client's app.
-   */
-  externalId: string;
   /**
    * Name of the customer.
    */
@@ -541,6 +537,14 @@ export type ResponseBodyCustomer = {
    * Avatar URL of the customer.
    */
   avatar?: string | null | undefined;
+  /**
+   * Unique identifier for the customer in the client's app.
+   */
+  externalId: string;
+  /**
+   * The customer's Stripe customer ID. This is useful for attributing recurring sale events to the partner who referred the customer.
+   */
+  stripeCustomerId?: string | null | undefined;
   /**
    * Country of the customer.
    */
@@ -554,9 +558,17 @@ export type ResponseBodyCustomer = {
    */
   saleAmount?: number | null | undefined;
   /**
-   * The date the customer was created.
+   * The date the customer was created (usually the signup date or trial start date).
    */
   createdAt: string;
+  /**
+   * The date the customer made their first sale. Useful for calculating the time to first sale and LTV.
+   */
+  firstSaleAt?: string | null | undefined;
+  /**
+   * The date the customer canceled their subscription. Useful for calculating LTV and churn rate.
+   */
+  subscriptionCanceledAt?: string | null | undefined;
 };
 
 export type SaleEvent = {
@@ -858,10 +870,6 @@ export type ListEventsResponseBodyCustomer = {
    * The unique ID of the customer. You may use either the customer's `id` on Dub (obtained via `/customers` endpoint) or their `externalId` (unique ID within your system, prefixed with `ext_`, e.g. `ext_123`).
    */
   id: string;
-  /**
-   * Unique identifier for the customer in the client's app.
-   */
-  externalId: string;
   /**
    * Name of the customer.
    */
@@ -874,6 +882,14 @@ export type ListEventsResponseBodyCustomer = {
    * Avatar URL of the customer.
    */
   avatar?: string | null | undefined;
+  /**
+   * Unique identifier for the customer in the client's app.
+   */
+  externalId: string;
+  /**
+   * The customer's Stripe customer ID. This is useful for attributing recurring sale events to the partner who referred the customer.
+   */
+  stripeCustomerId?: string | null | undefined;
   /**
    * Country of the customer.
    */
@@ -887,9 +903,17 @@ export type ListEventsResponseBodyCustomer = {
    */
   saleAmount?: number | null | undefined;
   /**
-   * The date the customer was created.
+   * The date the customer was created (usually the signup date or trial start date).
    */
   createdAt: string;
+  /**
+   * The date the customer made their first sale. Useful for calculating the time to first sale and LTV.
+   */
+  firstSaleAt?: string | null | undefined;
+  /**
+   * The date the customer canceled their subscription. Useful for calculating LTV and churn rate.
+   */
+  subscriptionCanceledAt?: string | null | undefined;
 };
 
 export type LeadEvent = {
@@ -1601,14 +1625,17 @@ export const ResponseBodyCustomer$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   id: z.string(),
-  externalId: z.string(),
   name: z.string(),
   email: z.nullable(z.string()).optional(),
   avatar: z.nullable(z.string()).optional(),
+  externalId: z.string(),
+  stripeCustomerId: z.nullable(z.string()).optional(),
   country: z.nullable(z.string()).optional(),
   sales: z.nullable(z.number()).optional(),
   saleAmount: z.nullable(z.number()).optional(),
   createdAt: z.string(),
+  firstSaleAt: z.nullable(z.string()).optional(),
+  subscriptionCanceledAt: z.nullable(z.string()).optional(),
 });
 
 export function responseBodyCustomerFromJSON(
@@ -1811,14 +1838,17 @@ export const ListEventsResponseBodyCustomer$inboundSchema: z.ZodType<
   unknown
 > = z.object({
   id: z.string(),
-  externalId: z.string(),
   name: z.string(),
   email: z.nullable(z.string()).optional(),
   avatar: z.nullable(z.string()).optional(),
+  externalId: z.string(),
+  stripeCustomerId: z.nullable(z.string()).optional(),
   country: z.nullable(z.string()).optional(),
   sales: z.nullable(z.number()).optional(),
   saleAmount: z.nullable(z.number()).optional(),
   createdAt: z.string(),
+  firstSaleAt: z.nullable(z.string()).optional(),
+  subscriptionCanceledAt: z.nullable(z.string()).optional(),
 });
 
 export function listEventsResponseBodyCustomerFromJSON(