@plitzi/plitzi-sdk 0.37.2 → 0.37.3

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { default as ComponentProvider } from '@plitzi/sdk-elements/Component/ComponentProvider';
 import { default as sdkComponents } from './modules/Element';
+import { default as ComponentProvider } from '@plitzi/sdk-elements/Component/ComponentProvider';
 import { default as withElement } from '@plitzi/sdk-elements/Element/hocs/withElement';
 import { default as useElement } from '@plitzi/sdk-elements/Element/hooks/useElement';
 import { default as useRscData } from '@plitzi/sdk-elements/Element/hooks/useRscData';
@@ -8,6 +8,7 @@ import { default as PluginManager } from '@plitzi/sdk-elements/Element/PluginMan
 import { default as PluginRemote } from '@plitzi/sdk-elements/Element/PluginRemote';
 import { default as ReplicaProvider } from '@plitzi/sdk-elements/Element/ReplicaProvider';
 import { default as RootElement } from '@plitzi/sdk-elements/Element/RootElement';
+import { default as useChannel, ChannelHandle } from '@plitzi/sdk-elements/realtime/useChannel';
 import { default as ComponentContext } from '@plitzi/sdk-shared/elements/ComponentContext';
 import { PlitziServiceProvider } from '@plitzi/sdk-shared/hooks/usePlitziServiceContext';
 import { default as useRscRefresh } from '@plitzi/sdk-shared/server/rsc/useRscRefresh';
@@ -16,7 +17,9 @@ import { track } from './modules/Analytics';
 import { ElementContextValue } from '@plitzi/sdk-elements/Element/ElementContext';
 import { default as EventBridge } from '@plitzi/sdk-event-bridge';
 import { default as InteractionsManager } from '@plitzi/sdk-interactions/InteractionsManager';
-import { ActionRunSummary, AnalyticsConfig, Element, Schema, Style, ComponentPluginFC, ComponentPlugin, InteractionCallback, InteractionCallbackParamValues, Environment, EventBridgeContextValue, HostActions, OfflineDataRaw, RenderMode, Server, RuntimeStateInstance, Theme, ThemeScope, PlitziServiceContextValue as BasePlitziServiceContextValue } from '@plitzi/sdk-shared';
+import { ActionRunSummary, AnalyticsConfig, Element, Schema, Style, ComponentPluginFC, ComponentPlugin, InteractionCallback, InteractionCallbackParamValues, Environment, EventBridgeContextValue, HostActions, OfflineDataRaw, RenderMode, Server, RuntimeStateInstance, Theme, ThemeScope, PlitziServiceContextValue as BasePlitziServiceContextValue, RealtimeMessage } from '@plitzi/sdk-shared';
+import { PluginDeclaration } from '@plitzi/sdk-shared/authoring/declare';
+import { RealtimeMember } from '@plitzi/sdk-shared/realtime';
 import { ReactNode } from 'react';
 /**
  * A registered plugin is a COMPONENT, not a decorated one.
@@ -68,6 +71,11 @@ export type PlitziSdkProps = {
     debugMode?: boolean;
     /** What the server ran to build this page, for the dev-tools. Only ever sent to a page allowed to debug them. */
     actionRuns?: ActionRunSummary[];
+    /**
+     * Set by the server that rendered this page: `offlineData.style.cache` was left out of the payload because the
+     * page's own stylesheet holds it, and `render()` reads it back from there before hydrating.
+     */
+    styleCacheInDocument?: boolean;
     isHydrating?: boolean;
     previewMode?: boolean;
     /** Set by the server that metered this render: the account behind this space is over its quota, so the page says
@@ -111,8 +119,8 @@ declare const PlitziSdk: {
 };
 type PlitziServiceContextValue = BasePlitziServiceContextValue<InstanceType<typeof EventBridge>, InstanceType<typeof InteractionsManager>>;
 declare const usePlitziServiceContext: () => PlitziServiceContextValue;
-export { track, useSdkStore as useStore, ComponentProvider, ComponentContext, usePlitziServiceContext, PlitziServiceProvider, RootElement, withElement, JsxManager, PluginManager, sdkComponents, PluginRemote, ReplicaProvider, useElement, useRscData, useRscRefresh };
-export type { AnalyticsConfig, ElementContextValue, Element, Schema, Style, ComponentPlugin, ComponentPluginFC, PlitziServiceContextValue, OfflineDataRaw, InteractionCallback, InteractionCallbackParamValues };
+export { track, useSdkStore as useStore, ComponentProvider, ComponentContext, usePlitziServiceContext, PlitziServiceProvider, RootElement, withElement, JsxManager, PluginManager, sdkComponents, PluginRemote, ReplicaProvider, useElement, useRscData, useRscRefresh, useChannel };
+export type { AnalyticsConfig, ElementContextValue, Element, Schema, Style, ComponentPlugin, ComponentPluginFC, PlitziServiceContextValue, OfflineDataRaw, InteractionCallback, InteractionCallbackParamValues, PluginDeclaration, ChannelHandle, RealtimeMember, RealtimeMessage };
 export declare const version: string;
 export declare const getStateManager: () => RuntimeStateInstance;
 export declare const getEventBridge: () => EventBridgeContextValue;

package/dist/index.html

@@ -24,6 +24,7 @@
           "react-dom": "/plitzi-sdk-vendor.js",
           "react-dom/client": "/plitzi-sdk-vendor.js",
           "react/jsx-runtime": "/plitzi-sdk-vendor.js",
+          "react/compiler-runtime": "/plitzi-sdk-vendor.js",
           "@plitzi/plitzi-sdk": "/plitzi-sdk.js"
         }
       }
@@ -57,7 +58,7 @@
       render(
         'plitzi',
         {
-          webKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3JpZ2lucyI6WyJodHRwczovL3dlYnNpdGUucGxpdHppLmFwcCIsImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly9sb2NhbGhvc3Q6MzAwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly8xMjcuMC4wLjE6ODA4MCJdLCJpc3MiOiJodHRwczovL3NlcnZlci5wbGl0emkubG9jYWwiLCJhdWQiOlsiaHR0cHM6Ly9wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWwiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbDozMDAxIiwiaHR0cHM6Ly9hcGkucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zc3IucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9zZXJ2ZXIucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9tY3AucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hdXRoLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly8xMjcuMC4wLjE6NTMwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6NTE4MCJdLCJzY29wZSI6InNwYWNlOnJlbmRlciIsImlhdCI6MTc4OTg0OTYyMywianRpIjoiMmM0ZTRkNDI1NzEzMTI4YyIsIm5iZiI6MTc4OTg0OTYyM30.VKxz7K9A8tvKnCwWLnB02NgAQY7Oftr6NzAXH8v4nsU',
+          webKey: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxIiwib3JpZ2lucyI6WyJodHRwczovL3dlYnNpdGUucGxpdHppLmFwcCIsImh0dHBzOi8vcGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDAiLCJodHRwczovL2FwcC5wbGl0emkubG9jYWw6MzAwMSIsImh0dHBzOi8vc3NyLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImh0dHA6Ly9sb2NhbGhvc3Q6MzAwMCIsImh0dHA6Ly9sb2NhbGhvc3Q6ODA4MCIsImh0dHA6Ly8xMjcuMC4wLjE6ODA4MCIsImh0dHBzOi8vZGV2LnBsaXR6aS5jb20iLCJodHRwczovL3BsaXR6aS5jb20iLCJodHRwczovL3N0Zy5wbGl0emkuY29tIl0sImlzcyI6Imh0dHBzOi8vc2VydmVyLnBsaXR6aS5sb2NhbCIsImF1ZCI6WyJodHRwczovL3BsaXR6aS5sb2NhbCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbCIsImh0dHBzOi8vYXBwLnBsaXR6aS5sb2NhbDozMDAwIiwiaHR0cHM6Ly9hcHAucGxpdHppLmxvY2FsOjMwMDEiLCJodHRwczovL2FwaS5wbGl0emkubG9jYWwiLCJodHRwczovL3Nzci5wbGl0emkubG9jYWwiLCJodHRwczovL3NlcnZlci5wbGl0emkubG9jYWwiLCJodHRwczovL21jcC5wbGl0emkubG9jYWwiLCJodHRwczovL2F1dGgucGxpdHppLmxvY2FsIiwiaHR0cDovLzEyNy4wLjAuMTo1MzAwIiwiaHR0cDovL2xvY2FsaG9zdDo1MTgwIl0sInNjb3BlIjoic3BhY2U6cmVuZGVyIiwiaWF0IjoxNzkwMjEzMjg5LCJqdGkiOiJhZDgyN2EyMjliZjhlMzk3IiwibmJmIjoxNzkwMjEzMjg5fQ.dedpVVA5Nv3Xr7nEOZ8UmEJcIamF9AHGnLgqQyDV8-k',
           environment: 'main',
           revision: 0,
           renderMode: 'raw',

package/dist/modules/App/SpaceThemeProvider.d.ts

@@ -0,0 +1,19 @@
+import { ThemeScope } from '@plitzi/sdk-shared';
+import { Theme } from '@plitzi/sdk-shared/types';
+import { ReactNode } from 'react';
+export type SpaceThemeProviderProps = {
+    scope: ThemeScope;
+    /** A theme the host already settled — the cookie a server read — which wins over everything here. */
+    theme?: Theme;
+    children?: ReactNode;
+};
+/**
+ * The theme provider, starting where the SPACE says to start.
+ *
+ * `style.theme.default` is what a space declares a first visit looks like; the provider was mounted with a hard-coded
+ * `system`, so the setting was stored, edited in the builder and written by authoring, and never rendered. It is read
+ * from the store because a space fetched after mount arrives there late — the provider re-applies its default when
+ * it does, and a visitor's own choice (the cookie) still wins.
+ */
+declare const SpaceThemeProvider: ({ scope, theme, children }: SpaceThemeProviderProps) => import('react').JSX.Element;
+export default SpaceThemeProvider;

package/dist/modules/Network/graphqlClient.d.ts

@@ -0,0 +1,18 @@
+/** Where a request stopped: never reached the server, refused by it, or answered with errors in place of data. */
+export type GraphqlFailure = 'network' | 'http' | 'graphql';
+export declare class GraphqlRequestError extends Error {
+    readonly failure: GraphqlFailure;
+    readonly statusCode?: number;
+    constructor(message: string, failure: GraphqlFailure, statusCode?: number);
+}
+export type GraphqlClient = {
+    request: <T>(document: string, variables?: Record<string, unknown>) => Promise<T>;
+};
+/**
+ * What the SDK sends its server: a handful of queries, always to the network, never cached, never subscribed to. A
+ * GraphQL client with a normalized cache would be most of the SDK's weight for that, so this is a `fetch`.
+ *
+ * A refusal still counts for the session: it goes to the auth-failure channel, the way the builder's Apollo link sends
+ * it, so a session revoked elsewhere is noticed by whichever request is refused next.
+ */
+export declare const createGraphqlClient: (uri: string, webKey: string) => GraphqlClient;