@aventurevc/api-schemas 0.8.161 → 0.8.164

package/dist/billing/catalog-plan.d.ts

@@ -11,6 +11,7 @@ declare const BillingCatalogPlanSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>;
     tier: z.ZodEnum<{
         ESSENTIAL: "ESSENTIAL";

package/dist/billing/catalog-tier.d.ts

@@ -8,6 +8,7 @@ declare const BillingCatalogTierSchemaDefinition: z.ZodObject<{
         limit?: number | null | undefined;
         type: "COMPANY" | "ENTITY_BRAND" | "ENTITY_VIEW" | "PERSON" | "PERSON_VIEW" | "WEB_SEARCH";
     }, import("./catalog-allowance.ts").BillingCatalogAllowanceSchemaInput>>>;
+    description: z.ZodString;
     displayName: z.ZodString;
     tier: z.ZodEnum<{
         ESSENTIAL: "ESSENTIAL";

package/dist/billing/catalog-tier.js

@@ -5,6 +5,8 @@ const BillingCatalogTierSchemaDefinition = z.object({
     /** Researchly AI credits per Researchly billing period; 0 withholds them and absent means uncapped. */
     aiCreditLimit: z.int().nullish(),
     allowance: z.array(BillingCatalogAllowanceSchema),
+    /** Who the tier is for, in one or two sentences; it states no caps or prices, which allowance and plan carry. */
+    description: z.string(),
     displayName: z.string(),
     tier: z.enum(["ESSENTIAL", "PLUS", "PRO", "UNLIMITED"]),
 });

package/dist/billing/catalog.d.ts

@@ -40,6 +40,7 @@ declare const BillingCatalogSchemaDefinition: z.ZodObject<{
             limit?: number | null | undefined;
             type: "COMPANY" | "ENTITY_BRAND" | "ENTITY_VIEW" | "PERSON" | "PERSON_VIEW" | "WEB_SEARCH";
         }[];
+        description: string;
         displayName: string;
         tier: "ESSENTIAL" | "PLUS" | "PRO" | "UNLIMITED";
     }, import("./catalog-tier.ts").BillingCatalogTierSchemaInput, z.core.$ZodTypeInternals<{
@@ -48,6 +49,7 @@ declare const BillingCatalogSchemaDefinition: z.ZodObject<{
             limit?: number | null | undefined;
             type: "COMPANY" | "ENTITY_BRAND" | "ENTITY_VIEW" | "PERSON" | "PERSON_VIEW" | "WEB_SEARCH";
         }[];
+        description: string;
         displayName: string;
         tier: "ESSENTIAL" | "PLUS" | "PRO" | "UNLIMITED";
     }, import("./catalog-tier.ts").BillingCatalogTierSchemaInput>>>;

package/dist/billing/checkout-mutation.d.ts

@@ -6,6 +6,7 @@ declare const BillingCheckoutMutationSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>;
     uiMode: z.ZodOptional<z.ZodEnum<{
         ELEMENTS: "ELEMENTS";

package/dist/billing/checkout.d.ts

@@ -8,6 +8,7 @@ declare const BillingCheckoutSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>;
     publishableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
     url: z.ZodOptional<z.ZodNullable<z.ZodString>>;

package/dist/billing/payment-method.d.ts

@@ -3,13 +3,17 @@ import { z } from "zod/v4";
  * Card on file that pays the subscription.
  *
  * @openapiSchema BillingPaymentMethod
+ * @endpoint GET /v1/billing/subscription/payment-profile
  * @endpoint POST /v1/billing/plan-change-previews
+ * @usedBySchema BillingPaymentProfileSchema
  * @usedBySchema BillingPlanChangePreviewSchema
  * @contractShape billing.payment-method
  * @contractRole canonical
  */
 export declare const BillingPaymentMethodSchema: z.ZodObject<{
     brand: z.ZodString;
+    expiryMonth: z.ZodInt;
+    expiryYear: z.ZodInt;
     last4: z.ZodString;
 }, z.core.$strip>;
 export type BillingPaymentMethod = z.infer<typeof BillingPaymentMethodSchema>;

package/dist/billing/payment-method.js

@@ -4,7 +4,9 @@ import { z } from "zod/v4";
  * Card on file that pays the subscription.
  *
  * @openapiSchema BillingPaymentMethod
+ * @endpoint GET /v1/billing/subscription/payment-profile
  * @endpoint POST /v1/billing/plan-change-previews
+ * @usedBySchema BillingPaymentProfileSchema
  * @usedBySchema BillingPlanChangePreviewSchema
  * @contractShape billing.payment-method
  * @contractRole canonical
@@ -12,6 +14,10 @@ import { z } from "zod/v4";
 export const BillingPaymentMethodSchema = z.object({
     /** Card brand as Stripe reports it */
     brand: z.string(),
+    /** Expiry month, 1 through 12 */
+    expiryMonth: z.int(),
+    /** Four-digit expiry year */
+    expiryYear: z.int(),
     /** Last four digits of the card number */
     last4: z.string(),
 });

package/dist/billing/payment-profile.d.ts

@@ -0,0 +1,25 @@
+import { z } from "zod/v4";
+declare const BillingPaymentProfileSchemaDefinition: z.ZodObject<{
+    introductoryOfferEligible: z.ZodBoolean;
+    paymentMethod: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+        brand: z.ZodString;
+        expiryMonth: z.ZodInt;
+        expiryYear: z.ZodInt;
+        last4: z.ZodString;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+type BillingPaymentProfileDefinition = z.infer<typeof BillingPaymentProfileSchemaDefinition>;
+export interface BillingPaymentProfileSchemaInput extends z.input<typeof BillingPaymentProfileSchemaDefinition> {
+}
+/**
+ * The caller's card on file and whether Checkout would charge each plan's introductoryAmount on the first payment, read live from Stripe.
+ *
+ * @openapiSchema BillingPaymentProfile
+ * @endpoint GET /v1/billing/subscription/payment-profile
+ * @contractShape billing.payment-profile
+ * @contractRole canonical
+ */
+export declare const BillingPaymentProfileSchema: z.ZodType<BillingPaymentProfileDefinition, BillingPaymentProfileSchemaInput>;
+export type BillingPaymentProfile = z.infer<typeof BillingPaymentProfileSchema>;
+export {};
+//# sourceMappingURL=payment-profile.d.ts.map

package/dist/billing/payment-profile.js

@@ -0,0 +1,19 @@
+// LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
+import { z } from "zod/v4";
+import { BillingPaymentMethodSchema } from "./payment-method.js";
+const BillingPaymentProfileSchemaDefinition = z.object({
+    /** True when the catalog offers introductoryAmount, the App Store does not bill the account, and it has no earlier subscription, payment, or unvoided invoice; false otherwise */
+    introductoryOfferEligible: z.boolean(),
+    /** Card that pays the continuing Stripe subscription; absent without one or when it is paid by something other than a card */
+    paymentMethod: BillingPaymentMethodSchema.nullish(),
+});
+/**
+ * The caller's card on file and whether Checkout would charge each plan's introductoryAmount on the first payment, read live from Stripe.
+ *
+ * @openapiSchema BillingPaymentProfile
+ * @endpoint GET /v1/billing/subscription/payment-profile
+ * @contractShape billing.payment-profile
+ * @contractRole canonical
+ */
+export const BillingPaymentProfileSchema = BillingPaymentProfileSchemaDefinition;
+//# sourceMappingURL=payment-profile.js.map

package/dist/billing/plan-change-mutation.d.ts

@@ -6,6 +6,7 @@ declare const BillingPlanChangeMutationSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>;
     prorationDate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
 }, z.core.$strip>;

package/dist/billing/plan-change-preview.d.ts

@@ -5,6 +5,8 @@ declare const BillingPlanChangePreviewSchemaDefinition: z.ZodObject<{
     effectiveAt: z.ZodISODateTime;
     paymentMethod: z.ZodOptional<z.ZodNullable<z.ZodObject<{
         brand: z.ZodString;
+        expiryMonth: z.ZodInt;
+        expiryYear: z.ZodInt;
         last4: z.ZodString;
     }, z.core.$strip>>>;
     prorationDate: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;

package/dist/billing/plan-change.d.ts

@@ -9,6 +9,7 @@ declare const BillingPlanChangeSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>;
     publishableKey: z.ZodOptional<z.ZodNullable<z.ZodString>>;
 }, z.core.$strip>;

package/dist/billing/plan-type.d.ts

@@ -23,6 +23,7 @@ export declare const BillingPlanTypeSchema: z.ZodUnion<readonly [z.ZodEnum<{
     PRO_MONTHLY: "PRO_MONTHLY";
     PRO_YEARLY: "PRO_YEARLY";
     PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+    UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
 }>, z.ZodString]>;
 export type BillingPlanType = z.infer<typeof BillingPlanTypeSchema>;
 //# sourceMappingURL=plan-type.d.ts.map

package/dist/billing/plan-type.js

@@ -19,7 +19,14 @@ import { z } from "zod/v4";
  * @contractRole canonical
  */
 export const BillingPlanTypeSchema = z.union([
-    z.enum(["PLUS_MONTHLY", "PLUS_YEARLY", "PRO_MONTHLY", "PRO_YEARLY", "PRO_YEARLY_PROMOTION"]),
+    z.enum([
+        "PLUS_MONTHLY",
+        "PLUS_YEARLY",
+        "PRO_MONTHLY",
+        "PRO_YEARLY",
+        "PRO_YEARLY_PROMOTION",
+        "UNLIMITED_MONTHLY",
+    ]),
     z.string(),
 ]);
 //# sourceMappingURL=plan-type.js.map

package/dist/billing/subscription.d.ts

@@ -155,6 +155,7 @@ declare const BillingSubscriptionSchemaDefinition: z.ZodObject<{
         };
     }, import("../research/allowance-usage.ts").ResearchAllowanceUsageSchemaInput>>;
     cancelAtPeriodEnd: z.ZodBoolean;
+    creditPurchasable: z.ZodBoolean;
     entitled: z.ZodBoolean;
     originalStart: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     pendingPlan: z.ZodOptional<z.ZodNullable<z.ZodUnion<readonly [z.ZodEnum<{
@@ -163,6 +164,7 @@ declare const BillingSubscriptionSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>>>;
     pendingPlanAt: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
     periodEnd: z.ZodOptional<z.ZodNullable<z.ZodISODateTime>>;
@@ -173,6 +175,7 @@ declare const BillingSubscriptionSchemaDefinition: z.ZodObject<{
         PRO_MONTHLY: "PRO_MONTHLY";
         PRO_YEARLY: "PRO_YEARLY";
         PRO_YEARLY_PROMOTION: "PRO_YEARLY_PROMOTION";
+        UNLIMITED_MONTHLY: "UNLIMITED_MONTHLY";
     }>, z.ZodString]>>>;
     provider: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
         APP_STORE: "APP_STORE";

package/dist/billing/subscription.js

@@ -10,6 +10,8 @@ const BillingSubscriptionSchemaDefinition = z.object({
     allowance: ResearchAllowanceUsageSchema,
     /** True when the plan is cancelled and ends at periodEnd */
     cancelAtPeriodEnd: z.boolean(),
+    /** True when POST /v1/billing/credit-purchases sells this account a prepaid credit pack; false for an operator, a plan the App Store bills, an Unlimited plan, or a continuing paid plan that is not entitled (INCOMPLETE, PAST_DUE, UNPAID, or PAUSED) */
+    creditPurchasable: z.boolean(),
     /** True while the subscription grants its paid tier */
     entitled: z.boolean(),
     /** Original start of the continuing paid subscription; absent when the provider did not supply it */

package/dist/entity/acquisition.js

@@ -17,7 +17,7 @@ const EntityAcquisitionSchemaDefinition = z.object({
         .string()
         .regex(/^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$/)
         .nullish(),
-    /** Effective acquisition date or instant, retaining its stored precision. */
+    /** Effective acquisition date the server derives on write: announcedAt, else completedAt, else the submitted asOf, as a calendar day; it can differ from the asOf written. */
     asOf: z
         .string()
         .regex(/^(?!0000)[0-9]{4}(?:-(?:0[1-9]|1[0-2])(?:-(?:0[1-9]|[12][0-9]|3[01])(?:T(?:[01][0-9]|2[0-3]):[0-5][0-9](?::[0-5][0-9](?:\.[0-9]{1,9})?)?(?:Z|[+-](?:(?:0[0-9]|1[0-7]):[0-5][0-9]|18:00)))?)?)?$/)

package/dist/federated/natural-search.js

@@ -21,7 +21,7 @@ const FederatedNaturalSearchSchemaDefinition = z.object({
     personSize: z.int().nullish(),
     /** Plain-English search request. */
     query: z.string().min(1),
-    /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`. Null keeps the configured per-call and per-model defaults. */
+    /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`: an explicit value above it is lowered, and when it is null the resolved effort — the per-model default, the tier default, or, absent an app default, the gateway's own — is still bounded at `medium`. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
     /** Search catalog revision this search reads its qualifier prompts and startup vocabulary from, to compare catalog edits; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
     searchCatalogRevision: z.int().nullish(),

package/dist/natural/search.js

@@ -14,7 +14,7 @@ const NaturalSearchSchemaDefinition = z.object({
     model: z.string().nullish(),
     /** Plain-English search request. */
     query: z.string().min(1),
-    /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`. Null keeps the configured per-call and per-model defaults. */
+    /** Optional reasoning effort for every model call this search makes: the query planner and the synthesis answer. Each call sends the nearest level its model supports, the lower one on a tie. Callers without private-data access are capped at `medium`: an explicit value above it is lowered, and when it is null the resolved effort — the per-model default, the tier default, or, absent an app default, the gateway's own — is still bounded at `medium`. */
     reasoningEffort: ReasoningEffortSchema.nullish(),
     /** Search catalog revision this search reads its qualifier prompts and startup vocabulary from, to compare catalog edits; null reads the current revision. Callers without private-data access always read the current revision. An unknown revision returns 404. */
     searchCatalogRevision: z.int().nullish(),

package/dist/openapi-component-manifest.js

@@ -113,6 +113,10 @@ export const OPENAPI_COMPONENT_MANIFEST = Object.freeze({
         modulePath: "billing/payment-method",
         schemaName: "BillingPaymentMethodSchema",
     },
+    BillingPaymentProfile: {
+        modulePath: "billing/payment-profile",
+        schemaName: "BillingPaymentProfileSchema",
+    },
     BillingPlanChange: { modulePath: "billing/plan-change", schemaName: "BillingPlanChangeSchema" },
     BillingPlanChangeMutation: {
         modulePath: "billing/plan-change-mutation",

package/dist/research/paragraph-shape.d.ts

@@ -1,6 +1,6 @@
 import { z } from "zod/v4";
 /**
- * Write-time per-paragraph shape rule for governed text bodies. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence.
+ * Write-time per-paragraph shape rule for governed text bodies. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence. Each paragraph ends in terminal punctuation (. ! ? or the CJK full stop, exclamation, and question marks), optionally followed by a closing quote, parenthesis, bracket, or guillemet.
  *
  * @openapiSchema ResearchParagraphShape
  * @endpoint GET /v1/entities/research-snippets/types

package/dist/research/paragraph-shape.js

@@ -1,7 +1,7 @@
 // LLM AGENTS MAY NOT EDIT THIS FILE UNDER ANY CIRCUMSTANCES. DO NOT EDIT - generated from Kotlin data classes via OpenAPI. Edit the backend owner and run: make docs-openapi && make docs-zod
 import { z } from "zod/v4";
 /**
- * Write-time per-paragraph shape rule for governed text bodies. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence.
+ * Write-time per-paragraph shape rule for governed text bodies. Paragraphs split on `\n\n` (one blank line). Each paragraph must satisfy minChars..maxChars and minSentences..maxSentences; whole body must satisfy minParagraphs..maxParagraphs (null maxParagraphs = unbounded). Sentence boundaries follow Unicode rules (java.text.BreakIterator), so 'Inc.' and 'U.S.' do not split a sentence. Each paragraph ends in terminal punctuation (. ! ? or the CJK full stop, exclamation, and question marks), optionally followed by a closing quote, parenthesis, bracket, or guillemet.
  *
  * @openapiSchema ResearchParagraphShape
  * @endpoint GET /v1/entities/research-snippets/types

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventurevc/api-schemas",
-  "version": "0.8.161",
+  "version": "0.8.164",
   "private": false,
   "description": "Zod v4 schemas and TypeScript types for the aVenture API.",
   "license": "Apache-2.0",