palbase 0.17.0 → 0.18.0

package/types/internal/src/modules/purchases.d.ts

@@ -5937,6 +5937,314 @@ export type StoreID = {
      */
     product: string;
 };
+/**
+ * A customer support found, and what found them.
+ */
+export type CustomerMatch = {
+    /**
+     * The customer; null for a purchase made on the web by no one yet (its link not redeemed).
+     */
+    customer_id: string | null;
+    /**
+     * What found them: `customer_id`, an id a store gave the purchase or the buyer (`app_store`, `play_store`, `stripe`), or `email` (the address a buyer with no account gave at checkout).
+     */
+    matched_by: "customer_id" | "app_store" | "play_store" | "stripe" | "email";
+    /**
+     * The purchase found, when one was.
+     */
+    chain_id?: string;
+    /**
+     * The purchase's store.
+     */
+    store?: "app_store" | "play_store" | "stripe";
+    /**
+     * The purchase's product, as the catalog names it.
+     */
+    product?: string;
+    /**
+     * The purchase is the store's sandbox's.
+     */
+    is_sandbox: boolean;
+    /**
+     * When the customer was first seen, or the purchase made.
+     */
+    at: string;
+};
+/**
+ * The customers a query found, the newest first (at most 50).
+ */
+export type CustomerSearch = {
+    /**
+     * The query, trimmed.
+     */
+    query: string;
+    customers: CustomerMatch[];
+};
+/**
+ * A movement of a customer's credits.
+ */
+export type CreditMove = {
+    /**
+     * The credits' currency.
+     */
+    currency: string;
+    /**
+     * What moved them.
+     */
+    kind: "grant" | "revoke" | "unrevoke" | "expire" | "merge" | "forgive";
+    /**
+     * The change of the balance (negative: taken).
+     */
+    delta: number;
+};
+/**
+ * One thing that happened to a customer.
+ */
+export type CustomerEvent = {
+    /**
+     * When it happened, as the store or the module recorded it.
+     */
+    at: string;
+    /**
+     * What happened: a payment (`purchase`, `renewal`), a `refund`, a subscription's renewal turned off (`cancellation`) or back on (`resumption`), a failed charge (`billing_issue`), its end (`expiration`), a grant given (`grant`) or taken back (`grant_revoked`), credits moved (`credits`), a purchase moved to (`transfer_in`) or from (`transfer_out`) the customer.
+     */
+    kind: "purchase" | "renewal" | "refund" | "cancellation" | "resumption" | "billing_issue" | "expiration" | "grant" | "grant_revoked" | "credits" | "transfer_in" | "transfer_out";
+    /**
+     * The purchase's store.
+     */
+    store?: "app_store" | "play_store" | "stripe";
+    /**
+     * The product, as the catalog names it.
+     */
+    product?: string;
+    /**
+     * The product's plan, as the catalog names it.
+     */
+    plan?: string;
+    /**
+     * The store's id of the product.
+     */
+    store_product_id?: string;
+    /**
+     * The purchase is the store's sandbox's.
+     */
+    is_sandbox: boolean;
+    /**
+     * What was paid — a refund: what was given back —, as the store said it, in millionths of `currency`.
+     */
+    amount_micros?: number;
+    /**
+     * ISO 4217.
+     */
+    currency?: string;
+    /**
+     * The record's why: a refund's kind (`refund`, `chargeback`, `family`, `other`), a grant's or a credit movement's reason, how a purchase moved (`restore`, `merge`, `assign`, `purchase`).
+     */
+    reason?: string;
+    /**
+     * Who did it: `store` (the store, or the customer at it), `customer`, `project`, the developer whose Studio or CLI call it was (`developer:…`), or the key or user that gave a grant or moved credits (`key:…`, `user:…`).
+     */
+    actor: string;
+    /**
+     * The purchase.
+     */
+    chain_id?: string;
+    /**
+     * The store's id of the transaction.
+     */
+    transaction_id?: string;
+    /**
+     * The grant.
+     */
+    grant_id?: string;
+    /**
+     * The grant's entitlement.
+     */
+    entitlement?: string;
+    credits?: CreditMove;
+    /**
+     * A transfer's other side: whom from, whom to (null: a purchase that was no one's).
+     */
+    other_customer_id?: string | null;
+};
+/**
+ * What happened to a customer, the newest first, a page at a time.
+ */
+export type CustomerHistory = {
+    /**
+     * The customer.
+     */
+    customer_id: string;
+    events: CustomerEvent[];
+    /**
+     * Goes on to the next page (send it as `cursor`); absent on the last page.
+     */
+    next_cursor?: string;
+};
+/**
+ * A grant as support reads it: active or not, and who took it back.
+ */
+export type GrantRecord = {
+    /**
+     * Its customer.
+     */
+    customer_id: string;
+    /**
+     * The entitlement.
+     */
+    entitlement: string;
+    /**
+     * When it ends; null for life.
+     */
+    expires_at: string | null;
+    /**
+     * Who gave it (the API key).
+     */
+    granted_by: string;
+    /**
+     * The grant's id.
+     */
+    id: string;
+    /**
+     * Why.
+     */
+    reason: string;
+    /**
+     * When it was revoked.
+     */
+    revoked_at: string | null;
+    /**
+     * When it started.
+     */
+    starts_at: string;
+    /**
+     * Who revoked it (`developer:…` for Studio or the CLI, `key:…`, `user:…`); null while it is not.
+     */
+    revoked_by: string | null;
+    /**
+     * Given now: started, not ended, not revoked.
+     */
+    active: boolean;
+};
+/**
+ * The grants given a customer, the newest first.
+ */
+export type CustomerGrants = {
+    /**
+     * The customer.
+     */
+    customer_id: string;
+    grants: GrantRecord[];
+};
+/**
+ * A revision of the catalog, as the list shows it.
+ */
+export type CatalogRevision = {
+    /**
+     * Its number.
+     */
+    revision: number;
+    /**
+     * When it was saved.
+     */
+    created_at: string;
+    /**
+     * Who saved it (the API key or user).
+     */
+    created_by: string;
+    /**
+     * The catalog is this revision now.
+     */
+    current: boolean;
+    /**
+     * How many products it defines.
+     */
+    products: number;
+    /**
+     * How many entitlements it defines.
+     */
+    entitlements: number;
+    /**
+     * How many credit currencies it defines.
+     */
+    currencies: number;
+    /**
+     * How many limits it defines.
+     */
+    limits: number;
+    /**
+     * How many offers it defines.
+     */
+    offers: number;
+    /**
+     * When a confirmed plan of it was last written to the stores; null for one never written.
+     */
+    applied_at: string | null;
+};
+/**
+ * The catalog's revisions, the newest first.
+ */
+export type CatalogRevisions = {
+    revisions: CatalogRevision[];
+    /**
+     * Goes on to the next page (send it as `cursor`); absent on the last page.
+     */
+    next_cursor?: string;
+};
+/**
+ * An entitlement, and the product that gives it with more of a limit.
+ */
+export type LimitUpgrade = {
+    /**
+     * The entitlement.
+     */
+    entitlement: string;
+    /**
+     * The entitlement's name, as the catalog gives it.
+     */
+    name: string;
+    /**
+     * The product that gives it.
+     */
+    product: string;
+    /**
+     * What the product gives of the limit in a window.
+     */
+    max: number;
+};
+/**
+ * The error envelope of a refused spend: with `limit_reached`, the limit and what would give the customer more of it.
+ */
+export type SpendRefusal = {
+    /**
+     * Machine-readable error code (snake_case)
+     */
+    error: string;
+    /**
+     * Human-readable explanation
+     */
+    error_description: string;
+    /**
+     * Correlation ID for log/audit lookup
+     */
+    request_id: string;
+    /**
+     * Seconds to wait before retrying; present on a refusal that ends with time.
+     */
+    retry_after?: number;
+    /**
+     * HTTP status code (mirrors the response status)
+     */
+    status: number;
+    /**
+     * With `limit_reached`: the limit.
+     */
+    limit?: string;
+    /**
+     * With `limit_reached`: the entitlements whose products give more of the limit than the customer has now, the smallest step up first (empty when none does) — for the app to offer.
+     */
+    upgrades?: LimitUpgrade[];
+};
 /** The events this module sends the project's webhooks (x-palbase-events), by type: each one's payload, the event's data. */
 export interface Events {
     /**
@@ -6391,6 +6699,17 @@ export declare function client(t: Transport): {
         body: CreditForgiveRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, CreditForgiven>>;
+    /**
+     * List a customer's grants
+     *
+     * The grants given the customer, active, ended and revoked, the newest first (at most 500): a grant is revoked by the id read here (DELETE …/grants/{grant_id}).
+     */
+    listCustomerGrants(input: {
+        path: {
+            customer_id: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, CustomerGrants>>;
     /**
      * Grant an entitlement
      *
@@ -7283,5 +7602,69 @@ export declare function client(t: Transport): {
         body: XcodeOfferKeyRequest; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
         signal?: AbortSignal;
     }): Promise<Reply<200, XcodeOfferKey>>;
+    /**
+     * Find customers
+     *
+     * Finds customers by what a person writing in has: their id; Apple's original transaction id or any transaction id of theirs; a Google order id (a renewal's `..N` or not); Stripe's subscription, payment intent, invoice or customer id; or the email address a buyer with no account gave at checkout, matched whole (case and spaces around it aside). The address is never kept: an HMAC of it is.
+     */
+    searchCustomers(input: {
+        query: {
+            q: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, CustomerSearch>>;
+    /**
+     * Read a customer's history
+     *
+     * What happened to the customer, the newest first: their purchases' payments and refunds, their subscriptions' renewal turned off and on, failed charges and ends, the grants given and taken back (with their reason and by whom), the credits granted, taken back, expired and forgiven (spends are the credits' entries: GET …/credits/entries), and the purchases that moved to or from them.
+     */
+    getCustomerHistory(input: {
+        path: {
+            customer_id: string;
+        };
+        query?: {
+            cursor?: string; /** Events in a page (default 50). */
+            limit?: number;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, CustomerHistory>>;
+    /**
+     * List the catalog's revisions
+     *
+     * Every revision the catalog was saved as, the newest first: who saved it, when, what it defines, and when a confirmed plan of it was last written to the stores.
+     */
+    listCatalogRevisions(input?: {
+        query?: {
+            cursor?: string; /** Revisions in a page (default 50). */
+            limit?: number;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, CatalogRevisions>>;
+    /**
+     * Read a revision of the catalog
+     *
+     * The catalog as it was saved at that revision.
+     */
+    getCatalogRevision(input: {
+        path: {
+            revision: number;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, CatalogDoc>>;
+    /**
+     * Put an older revision back
+     *
+     * Saves the revision's catalog as the next revision, as an edit is: checked against the catalog's rules now (an older revision may break one added since: 422 `invalid_catalog`), what customers bought kept in it, If-Match the revision the catalog is now. Nothing is written to a store: a plan of it is made and confirmed (POST /purchases/catalog/plans). Emits `purchases.catalog.changed` with `restored_from`.
+     */
+    restoreCatalogRevision(input: {
+        path: {
+            revision: number;
+        };
+        headers: {
+            "If-Match": string; /** Makes the write safe to send again (at most 255 characters). A retry with the same key and the same request gets the first answer back, marked `Idempotent-Replayed: true`, and changes nothing; the same key with a different request is refused with 422, and while the first request still runs a retry gets 409 with Retry-After. Answers are kept for 24 hours. */
+            "Idempotency-Key"?: string;
+        }; /** Stops the call: the request in flight, a wait before a retry, a proof-of-work being solved. */
+        signal?: AbortSignal;
+    }): Promise<Reply<200, CatalogDoc>>;
 };
 export type Client = ReturnType<typeof client>;

package/types/web/src/client.d.ts

@@ -10,6 +10,7 @@ import { Notify } from './notify.js';
 import { Purchases } from './purchases.js';
 import { type ChatToolCall } from './chat.js';
 import { Flags } from './flags.js';
+import { Messaging, type MessagingOptions } from './messaging.js';
 export interface ClientOptions {
     /** The project's address: https://<ref>.<domain> */
     url: string;
@@ -68,6 +69,8 @@ export interface ClientOptions {
      * pb.setLanguage changes it.
      */
     language?: string | readonly string[];
+    /** What the device keeps of the signed-in person's conversations (pb.messaging): dropped on sign-out unless keepOnSignOut. */
+    messaging?: MessagingOptions;
 }
 /**
  * The app's client. A backend's generated Palbe module (palbase apps:sync)
@@ -93,6 +96,8 @@ export interface PalbaseClient {
     notify: Notify;
     /** The project's feature flags and remote configuration, resolved for this app and its reader, kept current as they change. */
     flags: Flags;
+    /** The signed-in person's conversations — direct ones and groups — kept up to date, on the device and live. */
+    messaging: Messaging;
     /** The language every request says from now on (ClientOptions.language); null for the browser's own. */
     setLanguage(language: string | readonly string[] | null): void;
     /**

package/types/web/src/index.d.ts

@@ -10,6 +10,7 @@ export { connectVoice, type StartedVoice, type VoiceConnection, type VoiceOption
 export { Purchases, redemptionToken, type CheckoutSource, type CustomerInfo, type CustomerInfoListener, type GrantInfo, type MergeGrant, type OfferView, type Offerings, type Redeemed, type RedemptionLink, } from './purchases.js';
 export { Notify, WebPush, type PushPermission, type PushSubscribeOptions } from './notify.js';
 export { Flags, type FlagSource, type FlagsListener } from './flags.js';
+export { ConversationList, ConversationView, indexedDBKeyValue, Messaging, ScheduledList, ThreadView, type Conversation, type ConversationViewState, type ConversationListState, type Entry, type Member, type Message, type MessagingOptions, type MyProfile, type Observed, type OpenedFile, type OutboxItem, type OutgoingFile, type Profile, type ScheduledMessage, type SendOptions, type ThreadState, type ThreadViewState, } from './messaging.js';
 export { Inbox, type InboxItem, type InboxListOptions, type InboxPage, type InboxView, type InboxViewOptions } from './inbox.js';
 export { InApp, SESSION_START, type InAppOptions } from './inapp.js';
 export type { Paywall, PaywallRenderOptions } from './paywall/placement.js';