@procedures/client 0.0.0-stage → 0.1.0

package/dist/components/types.d.ts

@@ -0,0 +1,264 @@
+/**
+ * Component Types
+ *
+ * Components are procedures that return serializable UI descriptors.
+ * This enables SSR, caching, and transport over wire.
+ *
+ * Components integrate with splay's rendering model where a renderer
+ * produces output based on data, size, and path context.
+ */
+import type { ZodLike } from "../client/validation/types.js";
+import type { ProcedureMetadata, ProcedurePath } from "../procedures/types.js";
+import type { EventBus } from "../events/types.js";
+/**
+ * Serializable component output descriptor.
+ * Can be transported over wire, cached, and hydrated by any framework.
+ *
+ * @example
+ * ```typescript
+ * const descriptor: ComponentOutput = {
+ *   type: "user-card",
+ *   props: {
+ *     name: "John Doe",
+ *     avatar: "/images/john.png",
+ *   },
+ *   children: [
+ *     { type: "badge", props: { label: "Admin" } },
+ *   ],
+ * };
+ * ```
+ */
+export interface ComponentOutput {
+    /** Component type identifier (maps to registered component) */
+    type: string;
+    /** Serializable props for the component */
+    props: Record<string, unknown>;
+    /** Nested child descriptors (optional) */
+    children?: ComponentOutput[];
+    /** Component key for reconciliation (optional) */
+    key?: string;
+}
+/**
+ * Fragment output - multiple components without wrapper.
+ */
+export interface FragmentOutput {
+    type: "__fragment__";
+    children: ComponentOutput[];
+}
+/**
+ * Null output - render nothing.
+ */
+export interface NullOutput {
+    type: "__null__";
+}
+/**
+ * Any valid component output.
+ */
+export type AnyComponentOutput = ComponentOutput | FragmentOutput | NullOutput;
+/**
+ * Size information for responsive rendering.
+ */
+export interface Size {
+    width: number;
+    height: number;
+}
+/**
+ * Context passed to component factories.
+ * Compatible with splay's RenderContext.
+ *
+ * @example
+ * ```typescript
+ * factory: (ctx) => ({
+ *   type: "user-card",
+ *   props: {
+ *     user: ctx.data,
+ *     compact: ctx.size.width < 400,
+ *   },
+ *   children: ctx.data.posts?.map((post, i) =>
+ *     ctx.render(post, ctx.size, `${ctx.path}.posts[${i}]`)
+ *   ),
+ * })
+ * ```
+ */
+export interface ComponentContext<TData = unknown> {
+    /** Input data for the component */
+    data: TData;
+    /** Available rendering size */
+    size: Size;
+    /** Path in the render tree (for debugging and keys) */
+    path: string;
+    /** Current depth in the render tree */
+    depth: number;
+    /**
+     * Render a child component.
+     * Delegates to the renderer to produce a ComponentOutput.
+     *
+     * @param data - Data for the child component
+     * @param size - Size available for the child
+     * @param path - Path for the child (for keys and debugging)
+     * @returns ComponentOutput from the child render
+     */
+    render: (data: unknown, size: Size, path: string) => ComponentOutput | Promise<ComponentOutput>;
+    /**
+     * Event bus for streaming coordination.
+     * Available when executing in a procedure context.
+     */
+    bus?: EventBus;
+    /**
+     * Additional metadata from the procedure context.
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Component factory function (single output).
+ * Returns a serializable component descriptor.
+ */
+export type ComponentFactory<TData = unknown> = (ctx: ComponentContext<TData>) => ComponentOutput | Promise<ComponentOutput>;
+/**
+ * Streaming component factory (multi-yield).
+ * Yields descriptors over time for live updates.
+ */
+export type StreamingComponentFactory<TData = unknown> = (ctx: ComponentContext<TData>) => AsyncGenerator<ComponentOutput, void, unknown>;
+/**
+ * Any component factory (single or streaming).
+ */
+export type AnyComponentFactory<TData = unknown> = ComponentFactory<TData> | StreamingComponentFactory<TData>;
+/**
+ * Component metadata (extends ProcedureMetadata).
+ */
+export interface ComponentMetadata extends ProcedureMetadata {
+    /** Component category for organization */
+    category?: string;
+    /** Whether the component supports streaming updates */
+    streaming?: boolean;
+    /** Default size constraints */
+    defaultSize?: Size;
+    /** Minimum size constraints */
+    minSize?: Size;
+    /** Maximum size constraints */
+    maxSize?: Size;
+}
+/**
+ * Component definition.
+ * Wraps a factory function with type information and metadata.
+ *
+ * @example
+ * ```typescript
+ * const userCard: ComponentDefinition<User> = {
+ *   type: "user-card",
+ *   namespace: "ui",
+ *   input: userSchema,
+ *   metadata: {
+ *     description: "Displays user information",
+ *     category: "profile",
+ *   },
+ *   factory: (ctx) => ({
+ *     type: "user-card",
+ *     props: { user: ctx.data },
+ *   }),
+ * };
+ * ```
+ */
+export interface ComponentDefinition<TData = unknown> {
+    /** Component type identifier */
+    type: string;
+    /**
+     * Namespace for the component (optional).
+     * Results in path: ["components", namespace, type]
+     *
+     * @example
+     * namespace: "ui" → ["components", "ui", "user-card"]
+     */
+    namespace?: string;
+    /**
+     * Input schema for validating component data.
+     * Optional - if not provided, accepts any data.
+     */
+    input?: ZodLike<TData>;
+    /**
+     * Component metadata for documentation and tooling.
+     */
+    metadata?: ComponentMetadata;
+    /**
+     * Whether this component streams updates.
+     * When true, factory is expected to be a generator.
+     */
+    streaming?: boolean;
+    /**
+     * Component factory function.
+     * Can be a regular function (single output) or generator (streaming).
+     */
+    factory: AnyComponentFactory<TData>;
+}
+/**
+ * Any component definition (type-erased for storage).
+ */
+export type AnyComponentDefinition = ComponentDefinition<unknown>;
+/**
+ * Registered component with resolved path.
+ */
+export interface RegisteredComponent<TData = unknown> {
+    /** Full procedure path */
+    path: ProcedurePath;
+    /** Original component definition */
+    definition: ComponentDefinition<TData>;
+}
+/**
+ * Component bundle - collection of components with shared namespace.
+ *
+ * @example
+ * ```typescript
+ * const uiComponents: ComponentBundle = {
+ *   namespace: "ui",
+ *   components: [
+ *     buttonComponent,
+ *     cardComponent,
+ *     modalComponent,
+ *   ],
+ * };
+ * ```
+ */
+export interface ComponentBundle {
+    /** Shared namespace for all components in bundle */
+    namespace: string;
+    /** Component definitions */
+    components: AnyComponentDefinition[];
+    /** Bundle metadata */
+    metadata?: {
+        /** Bundle name */
+        name?: string;
+        /** Bundle description */
+        description?: string;
+        /** Bundle version */
+        version?: string;
+    };
+}
+/**
+ * Infer input type from a component definition.
+ */
+export type InferComponentInput<T> = T extends ComponentDefinition<infer TData> ? TData : unknown;
+/**
+ * Infer whether a component is streaming.
+ */
+export type IsStreamingComponent<T> = T extends ComponentDefinition<unknown> ? T["streaming"] extends true ? true : false : false;
+/**
+ * Create a null output (render nothing).
+ */
+export declare function nullOutput(): NullOutput;
+/**
+ * Create a fragment output (multiple children without wrapper).
+ */
+export declare function fragment(...children: ComponentOutput[]): FragmentOutput;
+/**
+ * Check if output is a fragment.
+ */
+export declare function isFragment(output: AnyComponentOutput): output is FragmentOutput;
+/**
+ * Check if output is null.
+ */
+export declare function isNullOutput(output: AnyComponentOutput): output is NullOutput;
+/**
+ * Check if a factory is a streaming generator.
+ */
+export declare function isStreamingFactory<TData>(factory: AnyComponentFactory<TData>): factory is StreamingComponentFactory<TData>;
+//# sourceMappingURL=types.d.ts.map

package/dist/components/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":"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"}

package/dist/components/types.js

@@ -0,0 +1,46 @@
+/**
+ * Component Types
+ *
+ * Components are procedures that return serializable UI descriptors.
+ * This enables SSR, caching, and transport over wire.
+ *
+ * Components integrate with splay's rendering model where a renderer
+ * produces output based on data, size, and path context.
+ */
+// =============================================================================
+// Output Helpers
+// =============================================================================
+/**
+ * Create a null output (render nothing).
+ */
+export function nullOutput() {
+    return { type: "__null__" };
+}
+/**
+ * Create a fragment output (multiple children without wrapper).
+ */
+export function fragment(...children) {
+    return { type: "__fragment__", children };
+}
+/**
+ * Check if output is a fragment.
+ */
+export function isFragment(output) {
+    return output.type === "__fragment__";
+}
+/**
+ * Check if output is null.
+ */
+export function isNullOutput(output) {
+    return output.type === "__null__";
+}
+/**
+ * Check if a factory is a streaming generator.
+ */
+export function isStreamingFactory(factory) {
+    // The tag of the prototype, not `constructor.name`: an own `constructor` property, or a
+    // bundler that renames classes, does not change it. A plain function that returns a
+    // generator is not detected here: the handler of a component streams its result anyway.
+    return Object.prototype.toString.call(factory) === "[object AsyncGeneratorFunction]";
+}
+//# sourceMappingURL=types.js.map

package/dist/components/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/components/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAkTH,gFAAgF;AAChF,iBAAiB;AACjB,gFAAgF;AAEhF;;GAEG;AACH,MAAM,UAAU,UAAU;IACxB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,GAAG,QAA2B;IACrD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,CAAC;AAC5C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAA0B;IACnD,OAAO,MAAM,CAAC,IAAI,KAAK,cAAc,CAAC;AACxC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,MAA0B;IACrD,OAAO,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,OAAmC;IAEnC,wFAAwF;IACxF,oFAAoF;IACpF,wFAAwF;IACxF,OAAO,MAAM,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,iCAAiC,CAAC;AACvF,CAAC"}

package/dist/events/bus.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Event Bus Implementation
+ *
+ * Central pub/sub system for streaming coordination.
+ */
+import type { EventBus, TypedEventBus, ChannelMap, EventHandler, Unsubscribe, EventBusOptions, EventWaitOptions } from "./types.js";
+/**
+ * Default event bus implementation.
+ * Supports pub/sub messaging with async iteration.
+ */
+export declare class DefaultEventBus implements EventBus {
+    private readonly subscribers;
+    private readonly buffer;
+    /** For each channel, a function per open stream that ends it (for `clear()`). */
+    private readonly streamEnders;
+    private readonly options;
+    constructor(options?: EventBusOptions);
+    /**
+     * Emit an event on a channel.
+     */
+    emit<T>(channel: string, data: T): void;
+    /**
+     * Subscribe to events on a channel.
+     */
+    on<T>(channel: string, handler: EventHandler<T>): Unsubscribe;
+    /**
+     * Subscribe to a single event on a channel. On a buffered channel, the first buffered event
+     * resolves the promise. When the signal aborts first, the promise rejects with an `AbortError`.
+     */
+    once<T>(channel: string, options?: EventWaitOptions): Promise<T>;
+    /**
+     * Create an async iterable for a channel. The stream ends when the reader stops, when the
+     * signal of the options aborts, or when `clear()` removes the channel.
+     */
+    stream<T>(channel: string, options?: EventWaitOptions): AsyncIterable<T>;
+    /**
+     * Get the number of subscribers on a channel.
+     */
+    subscriberCount(channel: string): number;
+    /**
+     * Check if a channel has any subscribers.
+     */
+    hasSubscribers(channel: string): boolean;
+    /**
+     * Get all active channel names.
+     */
+    channels(): string[];
+    /**
+     * Remove all subscribers from a channel.
+     */
+    clear(channel: string): void;
+    /**
+     * Remove all subscribers from all channels.
+     */
+    clearAll(): void;
+}
+/**
+ * Create a new event bus instance.
+ *
+ * @param options - Event bus options
+ * @returns EventBus instance
+ *
+ * @example
+ * ```typescript
+ * const bus = createEventBus();
+ *
+ * bus.on("updates", (data) => console.log(data));
+ * bus.emit("updates", { message: "Hello" });
+ * ```
+ */
+export declare function createEventBus(options?: EventBusOptions): EventBus;
+/**
+ * Create a typed event bus with predefined channels.
+ *
+ * @param options - Event bus options
+ * @returns TypedEventBus instance
+ *
+ * @example
+ * ```typescript
+ * interface MyChannels {
+ *   "user:created": { id: string; name: string };
+ *   "user:updated": User;
+ * }
+ *
+ * const bus = createTypedEventBus<MyChannels>();
+ *
+ * // Type-safe
+ * bus.emit("user:created", { id: "1", name: "John" });
+ * bus.on("user:created", (user) => console.log(user.name));
+ * ```
+ */
+export declare function createTypedEventBus<TChannels extends ChannelMap>(options?: EventBusOptions): TypedEventBus<TChannels>;
+/**
+ * Get or create the global event bus.
+ *
+ * @param options - Options for creating the bus (only used on first call)
+ * @returns Global EventBus instance
+ */
+export declare function getGlobalEventBus(options?: EventBusOptions): EventBus;
+/**
+ * Reset the global event bus.
+ * Useful for testing.
+ */
+export declare function resetGlobalEventBus(): void;
+/**
+ * A view of a bus whose `stream()` and `once()` use a signal when the caller gives none. The
+ * context of a procedure gets this view: when the invocation aborts, the handler's waits on
+ * the bus end, and the handler can finish (deep dive CORE-15).
+ *
+ * @param bus - The event bus
+ * @param signal - The signal of the invocation
+ * @returns An EventBus that shares the subscribers of `bus`
+ */
+export declare function withEventBusSignal(bus: EventBus, signal: AbortSignal): EventBus;
+/**
+ * Create a channel prefix helper for namespaced events.
+ *
+ * @param prefix - Prefix for all channels
+ * @returns Object with prefixed emit/on/stream methods
+ *
+ * @example
+ * ```typescript
+ * const userEvents = createChannelPrefix(bus, "user");
+ *
+ * userEvents.emit("created", { id: "1" }); // Emits "user:created"
+ * userEvents.on("updated", handler);       // Subscribes to "user:updated"
+ * ```
+ */
+export declare function createChannelPrefix(bus: EventBus, prefix: string): {
+    emit<T>(channel: string, data: T): void;
+    on<T>(channel: string, handler: EventHandler<T>): Unsubscribe;
+    once<T>(channel: string, options?: EventWaitOptions): Promise<T>;
+    stream<T>(channel: string, options?: EventWaitOptions): AsyncIterable<T>;
+};
+/**
+ * Forward events from one channel to another.
+ *
+ * @param bus - Event bus
+ * @param from - Source channel
+ * @param to - Destination channel
+ * @returns Unsubscribe function
+ */
+export declare function forwardChannel(bus: EventBus, from: string, to: string): Unsubscribe;
+/**
+ * Merge multiple channels into one.
+ *
+ * @param bus - Event bus
+ * @param sources - Source channels
+ * @param target - Target channel
+ * @returns Unsubscribe function for all sources
+ */
+export declare function mergeChannels(bus: EventBus, sources: string[], target: string): Unsubscribe;
+/**
+ * Filter events on a channel.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param predicate - Filter function
+ * @returns Unsubscribe function
+ */
+export declare function filterChannel<T>(bus: EventBus, source: string, target: string, predicate: (data: T) => boolean): Unsubscribe;
+/**
+ * Transform events from one channel to another.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param transform - Transform function
+ * @returns Unsubscribe function
+ */
+export declare function mapChannel<TIn, TOut>(bus: EventBus, source: string, target: string, transform: (data: TIn) => TOut): Unsubscribe;
+/**
+ * Debounce events on a channel.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param delay - Debounce delay in milliseconds
+ * @returns Unsubscribe function
+ */
+export declare function debounceChannel<T>(bus: EventBus, source: string, target: string, delay: number): Unsubscribe;
+/**
+ * Throttle events on a channel.
+ *
+ * @param bus - Event bus
+ * @param source - Source channel
+ * @param target - Target channel
+ * @param interval - Throttle interval in milliseconds
+ * @returns Unsubscribe function
+ */
+export declare function throttleChannel<T>(bus: EventBus, source: string, target: string, interval: number): Unsubscribe;
+//# sourceMappingURL=bus.d.ts.map

package/dist/events/bus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bus.d.ts","sourceRoot":"","sources":["../../src/events/bus.ts"],"names":[],"mappings":"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"}