@bounded-sh/core 0.0.1 → 0.0.3

package/README.md

@@ -63,7 +63,7 @@ function getConfig(): Promise<ClientConfig>;
 function get(path: string): Promise<any>;
 function getMany(paths: string[], options?: { bypassCache?: boolean }): Promise<GetManyResult[]>;
 function set(path: string, data: any, options?: SetOptions): Promise<any>;
-function setMany(paths: { [key: string]: any }, options?: SetOptions): Promise<any>;
+function setMany(many: { path: string; document: any }[], options?: SetOptions): Promise<any>;
 function setFile(path: string, file: File, metadata?: any): Promise<any>;
 function getFiles(path: string): Promise<any>;
 function runQuery(queryString: string, variables?: any): Promise<any>;
@@ -75,4 +75,4 @@ function subscribe(path: string, options?: SubscriptionOptions): Promise<() => v
 
 ## Contributing
 
-Please see the main repository for contribution guidelines.
+Please see the main repository for contribution guidelines.

package/dist/client/config.d.ts

@@ -96,7 +96,7 @@ export declare function getWebhookKeysUrl(): string | undefined;
 /**
  * True when init() configured a Bounded network (the Cloudflare-native stack).
  * Synchronous + non-blocking. Used to route reads/writes that behave differently
- * on Bounded vs the legacy Tarobase backend (e.g. `count`/`aggregate`, which on
+ * on Bounded vs the legacy backend (e.g. `count`/`aggregate`, which on
  * Bounded must use the deterministic server aggregation, not the legacy AI query).
  */
 export declare function isBoundedNetwork(): boolean;

package/dist/client/live.d.ts

@@ -12,6 +12,31 @@ export type LiveIntentOptions = {
      */
     fireAndForget?: boolean;
 };
+export type LiveStatusOptions = {
+    /** Per-call timeout (ms) for the HTTP request to the realtime worker. */
+    timeoutMs?: number;
+    /** Extra headers (advanced/testing). */
+    headers?: Record<string, string>;
+};
+export type LiveStopReason = 'idle' | 'lifetime' | 'error' | 'manual' | 'evicted' | string;
+export type LiveStatus = {
+    available: boolean;
+    started: boolean;
+    module?: string;
+    etag?: string;
+    running?: boolean;
+    tick?: number;
+    lastErr?: string | null;
+    stopReason?: LiveStopReason | null;
+    lastTickAt?: number | null;
+    nextTickAt?: number | null;
+    nextAlarmAt?: number | null;
+    generation?: number;
+    connections?: number;
+    startedAtMs?: number | null;
+    stoppedAtMs?: number | null;
+    reason?: string;
+};
 export declare class LiveIntentError extends Error {
     statusCode?: number | undefined;
     details?: any | undefined;
@@ -33,8 +58,21 @@ export declare class LiveIntentError extends Error {
 export declare function intent(roomPath: string, intent: unknown, opts?: LiveIntentOptions): Promise<{
     ok: true;
 }>;
+/**
+ * Fetch the runtime status for a live room.
+ *
+ *   const s = await bounded.live.status('rooms/abc');
+ *   console.log(s.running, s.stopReason, s.generation, s.etag);
+ *
+ * This is diagnostic/ops surface. It reports whether the room facet exists,
+ * whether it is currently ticking, why it last stopped, which module etag is
+ * loaded, and the current generation used after terminal restarts.
+ */
+export declare function status(roomPath: string, opts?: LiveStatusOptions): Promise<LiveStatus>;
 export type SubscribeViewOptions = {
-    /** Address whose view to read. Defaults to the logged-in user's address. */
+    /** User id whose view to read. Defaults to the logged-in user's @user.id. */
+    userId?: string;
+    /** Legacy alias for wallet-address keyed view docs. Prefer userId for new rooms. */
     address?: string;
     /** Called with the latest per-player view document. */
     onData: (view: any) => void;
@@ -44,10 +82,11 @@ export type SubscribeViewOptions = {
 /**
  * Subscribe to YOUR per-player view of a room. Thin sugar over:
  *
- *   subscribe('<roomPath>/view/<myAddress>', { onData, onError })
+ *   subscribe('<roomPath>/view/<myUserId>', { onData, onError })
  *
- * The address defaults to the logged-in user's address (from the session
- * token's claims); pass `opts.address` to override. Returns the unsubscribe
+ * The view id defaults to the logged-in user's @user.id (from the session token
+ * claims); pass `opts.userId` to override. `opts.address` is kept as a legacy
+ * alias for older wallet-address keyed policies. Returns the unsubscribe
  * function (a Promise<() => Promise<void>>, same as `subscribe`).
  *
  * Note: this is a browser-first helper (the WS subscription manager is
@@ -57,5 +96,6 @@ export declare function subscribeView(roomPath: string, opts: SubscribeViewOptio
 /** The `bounded.live` namespace surface. */
 export declare const live: {
     intent: typeof intent;
+    status: typeof status;
     subscribeView: typeof subscribeView;
 };

package/dist/client/operations.d.ts

@@ -91,7 +91,7 @@ export type AggregateOptions = {
  * Count items in a collection path. Returns a numeric result.
  *
  * This uses the AI query engine with a count-specific prompt prefix,
- * so TaroBase will generate a $count aggregation pipeline and return
+ * so Bounded will generate a $count aggregation pipeline and return
  * just the count rather than full documents.
  *
  * IMPORTANT: This only works for collections where the read policy is "true".
@@ -236,6 +236,13 @@ export declare function runExpressionMany(many: {
     returnType?: 'Bool' | 'String' | 'Int' | 'UInt';
     _overrides?: RequestOverrides;
 }[]): Promise<RunExpressionResult[]>;
+/**
+ * Write a document at `path`. Sugar for a one-element {@link setMany}.
+ *
+ * **Delete:** pass `null` as the document to delete it — `set(path, null)` is
+ * the delete (there is no separate `del`/`remove`). It is routed through the
+ * collection's policy `delete` rule and broadcasts a delete to subscribers.
+ */
 export declare function set(path: string, document: any, options?: SetOptions): Promise<any>;
 export declare function setMany(many: {
     path: string;

package/dist/client/subscription-v2.d.ts

@@ -87,6 +87,6 @@ export declare function wsDelete(path: string): Promise<any>;
 export declare function wsGetMany(paths: string[]): Promise<any>;
 declare global {
     interface Window {
-        CUSTOM_TAROBASE_APP_ID_HEADER?: string;
+        CUSTOM_BOUNDED_APP_ID_HEADER?: string;
     }
 }

package/dist/client/subscription.d.ts

@@ -59,6 +59,6 @@ export declare function getCachedData(path: string, prompt?: string): any | null
 export declare function reconnectWithNewAuth(): Promise<void>;
 declare global {
     interface Window {
-        CUSTOM_TAROBASE_APP_ID_HEADER?: string;
+        CUSTOM_BOUNDED_APP_ID_HEADER?: string;
     }
 }

package/dist/index.d.ts

@@ -16,14 +16,14 @@ export { getActiveSessionManager } from './utils/session-manager';
 export type { ClientSessionManager } from './utils/session-manager';
 export { ServerSessionManager } from './utils/server-session-manager';
 export { createSessionWithSignature, refreshSession, revokeSession, signSessionCreateMessage, genAuthNonce } from './utils/auth-api';
-export { Tarobase as Tarobase6 } from './utils/sol/taro6CvKqwrYrDc16ufYgzQ2NZcyyVKStffbtudrhRuDevnet-program';
-export { Tarobase as TarobasePoof } from './utils/sol/poof4b5pk1L9tmThvBmaABjcyjfhFGbMbQP5BXk2QZpMainnet-program';
+export { Tarobase as Bounded6 } from './utils/sol/taro6CvKqwrYrDc16ufYgzQ2NZcyyVKStffbtudrhRuDevnet-program';
+export { Tarobase as BoundedPoof } from './utils/sol/poof4b5pk1L9tmThvBmaABjcyjfhFGbMbQP5BXk2QZpMainnet-program';
 export { buildSetDocumentsTransaction, convertRemainingAccounts, RemainingAccount, genSolanaMessage } from './utils/sol/sol-utils';
 export { RealtimeStore, getRealtimeStore, resetRealtimeStore } from './client/realtime-store';
 export type { StorageTier, SubscriptionStatus, SubscriptionState, SubscribeOptions, DeltaChange } from './client/realtime-store';
 export { functions, invoke as invokeFunction, FunctionInvokeError } from './client/functions';
 export type { InvokeOptions } from './client/functions';
-export { live, intent as liveIntent, subscribeView as subscribeLiveView, LiveIntentError } from './client/live';
-export type { LiveIntentOptions, SubscribeViewOptions } from './client/live';
+export { live, intent as liveIntent, status as liveStatus, subscribeView as subscribeLiveView, LiveIntentError } from './client/live';
+export type { LiveIntentOptions, LiveStatus, LiveStatusOptions, SubscribeViewOptions } from './client/live';
 export { withEffects, isEffectResult, defineLiveModule, EFFECT_INTENT_ADDRESS } from './client/live-effects';
 export type { Effect, EffectKind, EffectResult, LiveIntent, LiveTickResult, LiveModule } from './client/live-effects';