@justscale/core 0.1.0

package/dist/core/controller.js

@@ -0,0 +1,411 @@
+/**
+ * Controller Factory
+ *
+ * A controller is a service that exposes routes.
+ * Transport-agnostic - transports (HTTP, gRPC, etc.) augment the types.
+ */
+import { createRouteFactories, } from './plugin.js';
+import { isMiddlewareDef, isGuardDef, } from './middleware.js';
+import { compilePath, joinPaths } from './internal/routes.js';
+// Registry of builtin providers
+const builtinProviders = [];
+/**
+ * Register a provider that adds values to the builtin context.
+ * Providers are called in registration order for each request.
+ *
+ * Use module augmentation to add type declarations for new builtins:
+ * @example
+ * ```typescript
+ * // In your package
+ * declare module "@justscale/core" {
+ *   interface BuiltinContext {
+ *     myService: MyService;
+ *   }
+ * }
+ *
+ * registerBuiltinProvider(() => ({
+ *   myService: new MyService(),
+ * }));
+ * ```
+ */
+export function registerBuiltinProvider(provider) {
+    builtinProviders.push(provider);
+}
+/**
+ * Collect all builtin context values from registered providers.
+ * @internal Used by app.execute()
+ */
+export function collectBuiltins(ctx) {
+    return builtinProviders.reduce((acc, provider) => ({
+        ...acc,
+        ...provider(ctx),
+    }), {});
+}
+export { createRouteFactories };
+/**
+ * Create a controller with typed dependencies.
+ *
+ * The routes function receives a `services` object containing resolved dependencies
+ * for use via closure capture in handlers. Route factories (Get, Post, etc.) should
+ * be imported directly from their respective packages (@justscale/http, @justscale/cli, etc.).
+ *
+ * Supports two forms:
+ * - `createController('/prefix', { inject, routes })` - string shorthand for HTTP
+ * - `createController({ prefix: '/prefix', inject, routes })` - full object form
+ *
+ * @example
+ * ```typescript
+ * import { Get, Post } from '@justscale/http';
+ *
+ * // String shorthand (HTTP)
+ * const UsersController = createController('/users', {
+ *   inject: { users: UserRepository },
+ *   routes: (services) => ({
+ *     list: Get('/').handle(async ({ res }) => {
+ *       const all = await services.users.find();
+ *       res.json({ users: all });
+ *     }),
+ *   }),
+ * });
+ *
+ * // Object form
+ * const UsersController = createController({
+ *   prefix: '/users',
+ *   inject: { users: UserRepository },
+ *   routes: (services) => ({ ... }),
+ * });
+ * ```
+ */
+/**
+ * Symbol attached to a resolved guard function carrying its source
+ * GuardDef. Introspection tools (OpenAPI generator, debug UIs, etc.)
+ * read this to recover the original permission/action name that was
+ * lost when the def was resolved into a plain function.
+ */
+export const GUARD_DEF_SOURCE = Symbol('justscale:guardDefSource');
+async function resolveGuard(g, resolve) {
+    if (isGuardDef(g)) {
+        const gDeps = {};
+        for (const [key, depToken] of Object.entries(g.deps)) {
+            gDeps[key] = await resolve(depToken);
+        }
+        const fn = g.factory(gDeps);
+        fn[GUARD_DEF_SOURCE] = g;
+        return fn;
+    }
+    return g;
+}
+/**
+ * Resolve unresolved steps (MiddlewareDef, GuardDef, or arrays) to callable Step[] using DI.
+ * Called by createController and createContextualController factories.
+ */
+async function resolveSteps(steps, resolve) {
+    const resolved = [];
+    for (const step of steps) {
+        if (step.type === 'use') {
+            const mw = step.fn;
+            if (isMiddlewareDef(mw)) {
+                const mwDeps = {};
+                for (const [key, depToken] of Object.entries(mw.deps)) {
+                    mwDeps[key] = await resolve(depToken);
+                }
+                resolved.push({ type: 'use', fn: mw.factory(mwDeps) });
+            }
+            else {
+                resolved.push(step);
+            }
+        }
+        else {
+            // Guard step
+            const g = step.fn;
+            if (Array.isArray(g)) {
+                const guardFns = await Promise.all(g.map((gd) => resolveGuard(gd, resolve)));
+                resolved.push({
+                    type: 'guard',
+                    fn: async (ctx) => {
+                        for (const fn of guardFns) {
+                            if (await fn(ctx))
+                                return true;
+                        }
+                        return false;
+                    },
+                });
+            }
+            else {
+                resolved.push({ type: 'guard', fn: await resolveGuard(g, resolve) });
+            }
+        }
+    }
+    return resolved;
+}
+function _createControllerImpl(settingsOrPrefix, maybeConfig) {
+    // Normalize to settings + config
+    const isStringForm = typeof settingsOrPrefix === 'string';
+    const settings = isStringForm
+        ? { prefix: settingsOrPrefix }
+        : settingsOrPrefix;
+    const config = isStringForm
+        ? maybeConfig
+        : { inject: settingsOrPrefix.inject, routes: settingsOrPrefix.routes };
+    const prefix = settings.prefix ?? '';
+    const factory = async (deps, resolve) => {
+        // Pass deps as services to the routes function
+        const routeDefs = config.routes(deps);
+        const routes = [];
+        const entries = Array.isArray(routeDefs)
+            ? routeDefs.map((r) => [`${r.method} ${r.path}`, r])
+            : Object.entries(routeDefs);
+        for (const [name, routeDef] of entries) {
+            const { path: fullPath, segments } = joinPaths(prefix, routeDef.path);
+            const { pattern, paramNames } = compilePath(fullPath);
+            const rd = routeDef;
+            const compiledRoute = {
+                name,
+                method: rd.method,
+                path: fullPath,
+                segments,
+                pattern,
+                paramNames,
+                schema: undefined,
+                middlewares: [],
+                guards: [],
+                steps: await resolveSteps(rd.steps ?? [], resolve),
+                responseSchemas: rd.responseSchemas ?? new Map(),
+                handler: rd.handler,
+                types: rd.types,
+                permissionReturns: rd.permissionReturns,
+            };
+            // Preserve symbol properties from routeDef (e.g., RESPONSE_SCHEMA for OpenAPI)
+            for (const sym of Object.getOwnPropertySymbols(routeDef)) {
+                compiledRoute[sym] = routeDef[sym];
+            }
+            routes.push(compiledRoute);
+        }
+        return { prefix, settings, routes, deps };
+    };
+    return {
+        deps: config.inject,
+        factory,
+        prefix,
+        settings,
+    };
+}
+// ============================================================================
+// Contextual Controller Builder (withContext)
+// ============================================================================
+import { createContextualControllerInstance, } from './controller.contextual.js';
+import { PROCEDURE_TIMEOUT, createProcedureFactory, } from './controller.procedure.js';
+import { ConsoleLoggerFactory } from './service.js';
+// Registry of additional route factory providers
+const routeFactoryProviders = new Map();
+/**
+ * Register a route factory provider for contextual controllers.
+ * Call this as a side-effect when your package is imported.
+ *
+ * @example
+ * ```typescript
+ * // In @justscale/process
+ * import { registerContextualFactory } from '@justscale/core';
+ * import { createProcessFactory } from './builder.js';
+ *
+ * registerContextualFactory('Process', createProcessFactory);
+ * ```
+ */
+export function registerContextualFactory(name, provider) {
+    routeFactoryProviders.set(name, provider);
+}
+/**
+ * Collect all registered route factories for a session type.
+ * @internal
+ */
+function collectRouteFactories() {
+    const factories = {};
+    for (const [name, provider] of routeFactoryProviders) {
+        factories[name] = provider();
+    }
+    return factories;
+}
+/**
+ * Create a contextual controller builder bound to a session type.
+ * Use this for WebSocket and similar scenarios where controllers are
+ * invoked programmatically with caller-provided context.
+ *
+ * @example
+ * ```typescript
+ * interface GameSession {
+ *   user: User;
+ *   ws: WebSocket;
+ * }
+ *
+ * const RoomProcedures = createController
+ *   .withContext<GameSession>()
+ *   .create({
+ *     inject: { rooms: RoomService },
+ *     routes: (services, { Procedure }) => ({
+ *       //               ^^^^^^^^^^^ bound to GameSession
+ *       join: Procedure('room/:roomId/join')
+ *         .handle(({ session, params }) => {
+ *           // session is typed as GameSession!
+ *           services.rooms.addPlayer(params.roomId, session.user);
+ *           return { joined: params.roomId };
+ *         }),
+ *     })
+ *   });
+ *
+ * // In WebSocket handler
+ * const ctrl = container.resolve(RoomProcedures);
+ * using session = ctrl.createSession({ user, ws });
+ * await session.run();
+ * ```
+ */
+function withContext() {
+    return {
+        create(config) {
+            // Create bound Procedure factory for this session type
+            const BoundProcedure = createProcedureFactory();
+            // Collect all registered factories (from saga, etc.)
+            const additionalFactories = collectRouteFactories();
+            const factory = async (deps, resolve) => {
+                // Build factories object with Procedure and any registered factories
+                const factories = {
+                    Procedure: BoundProcedure,
+                    ...additionalFactories,
+                };
+                // Get routes from config, passing all factories
+                const routeDefs = config.routes(deps, factories);
+                const procedures = [];
+                const entries = Array.isArray(routeDefs)
+                    ? routeDefs.map((r) => [`${r.method ?? 'procedure'} ${r.path}`, r])
+                    : Object.entries(routeDefs);
+                for (const [name, routeDef] of entries) {
+                    // Contextual controllers use new steps-based ProcedureDef format
+                    const procedureDef = routeDef;
+                    // For contextual controllers, we don't join with a prefix
+                    const { pattern, paramNames } = compilePath(procedureDef.path);
+                    // Resolve unresolved steps (MiddlewareDef, GuardDef, arrays) to callable functions
+                    const resolvedSteps = await resolveSteps(procedureDef.steps, resolve);
+                    const procedure = {
+                        name,
+                        path: procedureDef.path,
+                        segments: procedureDef.path.split('/').filter(Boolean),
+                        pattern,
+                        paramNames,
+                        schema: procedureDef.schema,
+                        steps: resolvedSteps,
+                        handler: procedureDef.handler,
+                        timeout: procedureDef[PROCEDURE_TIMEOUT],
+                    };
+                    procedures.push(procedure);
+                }
+                const routesProxy = (Array.isArray(routeDefs) ? Object.fromEntries(entries) : routeDefs);
+                for (const procedure of procedures) {
+                    procedure.__routesProxy = routesProxy;
+                }
+                const loggerFactory = new ConsoleLoggerFactory();
+                const createLogger = (context) => loggerFactory.create(context);
+                return createContextualControllerInstance(procedures, createLogger, routesProxy);
+            };
+            return {
+                deps: config.inject,
+                factory,
+            };
+        },
+    };
+}
+import { getContractMetadata, } from '../features/contract/contract.js';
+/** Symbol to mark contract controllers. Cross-realm: tests forge via Symbol.for(). */
+export const CONTRACT_CONTROLLER = Symbol.for('justscale:contractController');
+/**
+ * Create a controller that implements a contract (RPC service).
+ * The contract defines the methods, inputs, and outputs.
+ * The controller provides the implementations.
+ *
+ * @example
+ * ```typescript
+ * // Given a contract generated from .proto or defined manually:
+ * abstract class GreeterService extends defineContract({
+ *   protocol: 'grpc',
+ *   serviceName: 'helloworld.Greeter',
+ *   methods: {
+ *     sayHello: rpc(HelloRequestSchema, HelloReplySchema),
+ *   },
+ * }) {}
+ *
+ * // Implement it:
+ * const GreeterController = createController
+ *   .implements(GreeterService)
+ *   .create({
+ *     inject: { db: Database },
+ *     methods: ({ db }) => ({
+ *       sayHello: async ({ body }) => ({
+ *         message: `Hello, ${body.name}!`,
+ *       }),
+ *     }),
+ *   })
+ * ```
+ */
+function implementsContract(contract) {
+    return {
+        create(config) {
+            // Get contract metadata (throws if missing)
+            const metadata = getContractMetadata(contract);
+            const factory = (deps, _resolve) => {
+                // Get method implementations from config
+                const implementations = config.methods(deps);
+                // Compile methods
+                const methods = new Map();
+                for (const [methodName, methodDef] of Object.entries(metadata.methods)) {
+                    const handler = implementations[methodName];
+                    if (!handler) {
+                        throw new Error(`Contract method '${methodName}' not implemented in controller for '${metadata.serviceName}'`);
+                    }
+                    const compiled = {
+                        name: methodName,
+                        inputSchema: methodDef.input,
+                        outputSchema: methodDef.output,
+                        streaming: methodDef.streaming,
+                        handler,
+                        steps: [],
+                        middlewares: [],
+                        guards: [],
+                    };
+                    methods.set(methodName, compiled);
+                }
+                return {
+                    contract,
+                    metadata,
+                    methods,
+                    deps,
+                };
+            };
+            return {
+                deps: config.inject,
+                factory,
+                contract,
+                [CONTRACT_CONTROLLER]: true,
+            };
+        },
+    };
+}
+/**
+ * Create a controller with dependency injection and route definitions.
+ *
+ * Supports multiple patterns:
+ * - `createController('/prefix', { inject, routes })` - HTTP route controller
+ * - `createController.withContext<T>().create({ ... })` - contextual controller
+ * - `createController.implements(Contract).create({ ... })` - contract controller
+ */
+const createController = Object.assign(_createControllerImpl, {
+    /** Create a contextual controller bound to a session type */
+    withContext,
+    /** Create a controller that implements a contract (RPC service) */
+    implements: implementsContract,
+});
+/**
+ * Create a contextual controller bound to a session type.
+ * Use this for WebSocket and similar scenarios where controllers
+ * are invoked programmatically with caller-provided context.
+ */
+const createContextualController = withContext;
+export { createController, createContextualController };
+//# sourceMappingURL=controller.js.map

package/dist/core/controller.js.map

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

package/dist/core/controller.procedure.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Procedure Route Builder
+ *
+ * Route builder for contextual controllers. Similar to HTTP's Get/Post builders
+ * but for programmatic invocation with session context.
+ *
+ * @example
+ * ```typescript
+ * Procedure('room/:roomId/bet')
+ *   .body(z.object({ amount: z.number() }))
+ *   .use(fetchRoom)
+ *   .guard(hasPermission)
+ *   .timeout(30000)
+ *   .handle(({ session, params, body, room }) => {
+ *     // session.user, session.ws from context
+ *     // params.roomId from path
+ *     // body.amount from payload
+ *     // room from middleware
+ *     return { accepted: true }
+ *   })
+ * ```
+ */
+import type { z } from 'zod';
+import type { ExtractParams, Prettify } from './plugin.js';
+import type { Middleware, Guard, MiddlewareDef, GuardDef, UnresolvedMiddleware, UnresolvedGuard } from './middleware.js';
+import type { BuiltinContext } from './controller.js';
+declare module '@justscale/core' {
+    interface SupportedMethods {
+        PROCEDURE: {
+            transport: 'procedure';
+            hasBody: true;
+            idempotent: false;
+        };
+    }
+}
+export declare const PROCEDURE_TIMEOUT: unique symbol;
+export declare const PROCEDURE_THROWS: unique symbol;
+export declare const PROCEDURE_BODY_SCHEMA: unique symbol;
+export declare const PROCEDURE_RESPONSE_SCHEMA: unique symbol;
+/**
+ * Base procedure context before middleware.
+ * TSession is the session context type from createContextualController<T>().
+ */
+export interface ProcedureContext<TSession = unknown, TParams = Record<string, string>, TBody = unknown> extends BuiltinContext {
+    /** Session context (user, ws, etc.) */
+    session: TSession;
+    /** Path parameters */
+    params: Prettify<TParams>;
+    /** Request body (validated if schema provided) */
+    body: TBody;
+    /** AbortSignal for cancellation */
+    signal: AbortSignal;
+}
+/**
+ * Extract middleware added type.
+ */
+type ExtractMiddlewareAdded<T> = T extends {
+    factory: (deps: any) => Middleware<any, infer A>;
+} ? A : T extends Middleware<any, infer A> ? A : Record<string, unknown>;
+/** Procedure route definition. */
+export interface ProcedureDef<TPath extends string = string, TBody = unknown, TResponse = unknown> {
+    /** Route method - always 'PROCEDURE' for procedures */
+    method: 'PROCEDURE';
+    /** Route path with optional params */
+    path: TPath;
+    /** Body schema for validation */
+    schema?: z.ZodType;
+    /** Unresolved steps - middleware and guards that may need DI resolution */
+    steps: UnresolvedStep[];
+    /** Handler function */
+    handler: (ctx: any) => TResponse | Promise<TResponse>;
+    /** Timeout in milliseconds */
+    [PROCEDURE_TIMEOUT]?: number;
+    /** Error types that can be thrown */
+    [PROCEDURE_THROWS]?: Array<new (...args: any[]) => Error>;
+}
+/**
+ * Procedure route builder interface.
+ * Accumulates middleware context and configuration through the chain.
+ */
+export interface ProcedureBuilder<TSession, TParams, TContext, TBody = unknown, TResponse = unknown, TPath extends string = string> {
+    /**
+     * Specify the body/payload schema.
+     * Validates incoming payload and types the body in the handler context.
+     */
+    body<T>(schema: z.ZodType<T>): ProcedureBuilder<TSession, TParams, Prettify<Omit<TContext, 'body'> & {
+        body: T;
+    }>, T, TResponse, TPath>;
+    /**
+     * Add middleware that extends the context.
+     */
+    use<TAdded extends object>(middleware: (ctx: TContext) => TAdded | Promise<TAdded>): ProcedureBuilder<TSession, TParams, Prettify<TContext & TAdded>, TBody, TResponse, TPath>;
+    /**
+     * Add a middleware definition (with DI support).
+     */
+    use<TMiddleware extends MiddlewareDef<any, any>>(middleware: TMiddleware): ProcedureBuilder<TSession, TParams, Prettify<TContext & ExtractMiddlewareAdded<TMiddleware>>, TBody, TResponse, TPath>;
+    /**
+     * Add a guard that gates access to the procedure.
+     */
+    guard(check: Guard<TContext> | GuardDef<any>): ProcedureBuilder<TSession, TParams, TContext, TBody, TResponse, TPath>;
+    /**
+     * Set a timeout for this procedure.
+     * If the handler doesn't complete within the timeout, the request is cancelled.
+     */
+    timeout(ms: number): ProcedureBuilder<TSession, TParams, TContext, TBody, TResponse, TPath>;
+    /**
+     * Declare error types that this procedure can throw.
+     * Useful for documentation and typed error handling.
+     */
+    throws<TErrors extends Array<new (...args: any[]) => Error>>(...errors: TErrors): ProcedureBuilder<TSession, TParams, TContext, TBody, TResponse, TPath>;
+    /**
+     * Specify the response schema for documentation.
+     */
+    returns<T>(schema: z.ZodType<T>): ProcedureBuilder<TSession, TParams, TContext, TBody, T, TPath>;
+    /**
+     * Set the handler for this procedure.
+     * Can return a value (single response) or be an async generator (streaming).
+     */
+    handle(handler: (ctx: TContext) => TResponse | Promise<TResponse>): ProcedureDef<TPath, TBody, TResponse>;
+    /**
+     * Set an async generator handler for streaming responses.
+     */
+    handle(handler: (ctx: TContext) => AsyncGenerator<TResponse>): ProcedureDef<TPath, TBody, TResponse>;
+}
+/**
+ * An unresolved step - middleware or guard that may need DI resolution.
+ */
+export interface UnresolvedStep {
+    type: 'use' | 'guard';
+    fn: UnresolvedMiddleware | UnresolvedGuard;
+}
+/**
+ * Create a procedure route.
+ *
+ * @example
+ * ```typescript
+ * Procedure('room/:roomId/join')
+ *   .handle(({ session, params }) => {
+ *     return { joined: params.roomId }
+ *   })
+ * ```
+ */
+export declare function Procedure<TPath extends string>(path: TPath): ProcedureBuilder<unknown, ExtractParams<TPath>, ProcedureContext<unknown, ExtractParams<TPath>>, unknown, unknown, TPath>;
+/** @internal Used by createContextualController(). */
+export declare function createProcedureFactory<TSession>(): <TPath extends string>(path: TPath) => ProcedureBuilder<TSession, ExtractParams<TPath>, ProcedureContext<TSession, ExtractParams<TPath>>, unknown, unknown, TPath>;
+export {};
+//# sourceMappingURL=controller.procedure.d.ts.map

package/dist/core/controller.procedure.d.ts.map

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