@base44-preview/sdk 0.8.46-pr.272.8052da4 → 0.8.46-pr.272.f64ff62

package/dist/actor.d.ts

@@ -11,7 +11,7 @@
 import type { Base44Client } from "./client";
 /**
  * A single client connection. `Send` is the message type this connection accepts
- * via {@link send}: the actor's *outgoing* (server→client) messages.
+ * via {@link send}, the actor's *outgoing* (server→client) messages.
  */
 export interface Conn<Send = unknown> {
     /** Unique per-connection id (one per socket/tab), the same value the client
@@ -33,9 +33,9 @@ export interface Storage {
  * Base class for an Actor.
  *
  * @typeParam Incoming - messages this actor *receives* from clients
- *   (`handleMessage`'s `msg`): the schema's `toServer` section.
+ *   (`handleMessage`'s `msg`), the schema's `toServer` section.
  * @typeParam Outgoing - messages this actor *sends* to clients
- *   (`conn.send`/`broadcast`): the schema's `toClient` section.
+ *   (`conn.send`/`broadcast`), the schema's `toClient` section.
  *
  * With a generated `schema.jsonc`, wire both from the registry so they can't drift
  * from the client's types:
@@ -51,7 +51,7 @@ export declare abstract class Actor<Incoming = unknown, Outgoing = unknown> {
     abstract handleTick(): void | Promise<void>;
     /**
      * Optional wake hook: runs once when the instance starts, before any
-     * connection is handled. Safe to load persisted state here.
+     * connection is handled. It is safe to load persisted state here.
      */
     handleStart(): void | Promise<void>;
     /**

package/dist/actor.js

@@ -12,9 +12,9 @@
  * Base class for an Actor.
  *
  * @typeParam Incoming - messages this actor *receives* from clients
- *   (`handleMessage`'s `msg`): the schema's `toServer` section.
+ *   (`handleMessage`'s `msg`), the schema's `toServer` section.
  * @typeParam Outgoing - messages this actor *sends* to clients
- *   (`conn.send`/`broadcast`): the schema's `toClient` section.
+ *   (`conn.send`/`broadcast`), the schema's `toClient` section.
  *
  * With a generated `schema.jsonc`, wire both from the registry so they can't drift
  * from the client's types:
@@ -39,7 +39,7 @@ export class Actor {
     }
     /**
      * Optional wake hook: runs once when the instance starts, before any
-     * connection is handled. Safe to load persisted state here.
+     * connection is handled. It is safe to load persisted state here.
      */
     handleStart() { }
     /**

package/dist/modules/actors.d.ts

@@ -35,7 +35,7 @@ interface ActorsConfig {
  * The legacy platform-proxy URL, byte-for-byte what PartySocket built before
  * the direct path existed: same scheme swap (including its localhost-needs-a-
  * port quirk), case-preserved party segment, `_pk` first in the query. The
- * `handler` param is load-bearing: the proxy reads it for the actor name.
+ * `handler` param is load-bearing. The proxy reads it for the actor name.
  */
 export declare function buildProxyActorUrl(rawHost: string, actorName: string, instanceId: string, connectionId: string, appId: string, token: string | null | undefined, functionsVersion?: string): string;
 /**

package/dist/modules/actors.js

@@ -13,7 +13,7 @@ const DEAD_MS = 3000;
 const PROXY_FALLBACK_STATUSES = new Set([405, 409, 422, 503]);
 // Mint responses no retry can fix (bad request / forbidden / not found): the
 // connection closes instead of re-minting forever; a fresh connect() re-probes.
-// 401 is deliberately absent: the auth token is re-read on every attempt, so a
+// 401 is deliberately absent. The auth token is re-read on every attempt, so a
 // login recovers on the next retry. Disjoint from PROXY_FALLBACK_STATUSES.
 const TERMINAL_MINT_STATUSES = new Set([400, 403, 404]);
 /** The mint's rejection can be anything; a `Base44Error` carries a numeric
@@ -29,7 +29,7 @@ function toError(err) {
 }
 /**
  * A live connection to an actor instance. Only obtainable from
- * {@link ActorRef.connect}, so `subscribe`/`send` are always valid: the socket
+ * {@link ActorRef.connect}, so `subscribe`/`send` are always valid. The socket
  * exists for this object's whole lifetime.
  */
 class Connection {
@@ -172,7 +172,7 @@ function makeActorRef(actorName, instanceId, config, connections) {
  * The legacy platform-proxy URL, byte-for-byte what PartySocket built before
  * the direct path existed: same scheme swap (including its localhost-needs-a-
  * port quirk), case-preserved party segment, `_pk` first in the query. The
- * `handler` param is load-bearing: the proxy reads it for the actor name.
+ * `handler` param is load-bearing. The proxy reads it for the actor name.
  */
 export function buildProxyActorUrl(rawHost, actorName, instanceId, connectionId, appId, token, functionsVersion) {
     let host = rawHost.replace(/^(http|https|ws|wss):\/\//, "");

package/dist/modules/actors.types.d.ts

@@ -35,7 +35,7 @@ type ToServerFor<N extends string> = N extends keyof ActorRegistry ? ActorRegist
 /** Options for {@link ActorRef.connect}. */
 export interface ActorConnectOptions {
     /**
-     * The connection id, which becomes the actor's `conn.id`. Supply a stable value
+     * The connection id, used as the actor's `conn.id`. Supply a stable value
      * (e.g. persisted per tab) so a reconnect reuses the same server-side
      * identity; omit for an auto-generated per-connection id.
      */
@@ -48,7 +48,7 @@ export interface ActorSubscription {
 }
 /**
  * A live connection to an actor instance, returned by {@link ActorRef.connect}.
- * `subscribe`/`send` are always valid: you only get a `Connection` once the
+ * `subscribe`/`send` are always valid. You only get a `Connection` once the
  * socket has been opened, so there's no pre-connect state to guard against.
  */
 export interface Connection<N extends string = string> {
@@ -62,7 +62,7 @@ export interface Connection<N extends string = string> {
     /**
      * Tear down the socket, heartbeat, and all listeners. Safe to call more
      * than once. A connection also closes itself when it fails permanently.
-     * see {@link ActorRef.connect}.
+     * See {@link ActorRef.connect}.
      */
     close(): void;
 }

package/dist/modules/analytics.js

@@ -255,7 +255,7 @@ async function getSessionContext(userAuthModule) {
         // With no token there is no identity to resolve: `me()` can only answer 401,
         // which the browser logs to the console before any handler here sees it. On
         // a public page that request is the sole reason an error appears, so skip
-        // it. This is not memoized: a visitor who logs in later must still resolve.
+        // it. This is not memoized. A visitor who logs in later must still resolve.
         if (!userAuthModule.hasToken()) {
             return { user_id: null, session_id: getAnalyticsSessionId() };
         }

package/dist/modules/app.types.d.ts

@@ -29,9 +29,9 @@ export interface AppModule {
      * Get the app's public configuration.
      *
      * Rejects with a {@linkcode Base44Error} when the visitor may not open the app:
-     * `status` is `403` and `data.extra_data.reason` says why: `"auth_required"`
-     * when the visitor must sign in, `"user_not_registered"` when the signed-in
-     * visitor has no access to this app.
+     * `status` is `403` and `data.extra_data.reason` says why. It is
+     * `"auth_required"` when the visitor must sign in, and
+     * `"user_not_registered"` when the signed-in visitor has no access to this app.
      *
      * @returns Promise resolving to the app's ID and access policy.
      *

package/dist/modules/connectors.types.d.ts

@@ -87,7 +87,7 @@ export interface ConnectorApiResponse<T = unknown> {
     status: number | null;
     /**
      * The parsed upstream response body, or proxy error details when no response
-     * was received. `null` when the response was binary. See {@link dataBase64}.
+     * was received. It is `null` when the response was binary. See {@link dataBase64}.
      */
     data: T | null;
     /**
@@ -148,9 +148,9 @@ export interface ConnectorProxyRawResponse {
  *
  * ## Metered connectors
  *
- * A few [platform connectors](#shared-connectors) are backed by paid third-party APIs that charge Base44 per call. For those, the OAuth token is **not** available to your code, and {@linkcode getConnection | getConnection()} rejects with a `403`. Call them with {@linkcode callApi | callApi()} instead: Base44 attaches the credential server-side, forwards the request, and bills your workspace's integration credits for the call.
+ * A few [platform connectors](#shared-connectors) are backed by paid third-party APIs that charge Base44 per call. For those, the OAuth token is **not** available to your code, and {@linkcode getConnection | getConnection()} rejects with a `403`. Call them with {@linkcode callApi | callApi()} instead. Base44 attaches the credential server-side, forwards the request, and bills your workspace's integration credits for the call.
  *
- * This applies to platform connectors only. A workspace-registered or app user connector runs on **your own** OAuth app, so the provider invoices you directly and there is nothing for Base44 to meter, so those keep normal token access via {@linkcode getWorkspaceConnection | getWorkspaceConnection()} and {@linkcode getCurrentAppUserConnection | getCurrentAppUserConnection()}.
+ * This applies to platform connectors only. A workspace-registered or app user connector runs on **your own** OAuth app, so the provider invoices you directly and there is nothing for Base44 to meter. Those keep normal token access via {@linkcode getWorkspaceConnection | getWorkspaceConnection()} and {@linkcode getCurrentAppUserConnection | getCurrentAppUserConnection()}.
  *
  * Two things to keep in mind when writing against a metered connector:
  *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.46-pr.272.8052da4",
+  "version": "0.8.46-pr.272.f64ff62",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",