@justscale/core 0.1.0

package/dist/core/controller.procedure.js

@@ -0,0 +1,115 @@
+/**
+ * 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 }
+ *   })
+ * ```
+ */
+// ============================================================================
+// Symbols for metadata storage
+// ============================================================================
+export const PROCEDURE_TIMEOUT = Symbol('@justscale/procedure-timeout');
+export const PROCEDURE_THROWS = Symbol('@justscale/procedure-throws');
+export const PROCEDURE_BODY_SCHEMA = Symbol('@justscale/procedure-body-schema');
+export const PROCEDURE_RESPONSE_SCHEMA = Symbol('@justscale/procedure-response-schema');
+/**
+ * Create a procedure builder.
+ */
+function createProcedureBuilder(path, state) {
+    const builder = {
+        body(schema) {
+            return createProcedureBuilder(path, { ...state, bodySchema: schema });
+        },
+        use(middleware) {
+            return createProcedureBuilder(path, {
+                ...state,
+                steps: [...state.steps, { type: 'use', fn: middleware }],
+            });
+        },
+        guard(check) {
+            return createProcedureBuilder(path, {
+                ...state,
+                steps: [...state.steps, { type: 'guard', fn: check }],
+            });
+        },
+        timeout(ms) {
+            return createProcedureBuilder(path, { ...state, timeoutMs: ms });
+        },
+        throws(...errors) {
+            return createProcedureBuilder(path, {
+                ...state,
+                errorTypes: [...state.errorTypes, ...errors],
+            });
+        },
+        returns(schema) {
+            return createProcedureBuilder(path, { ...state, responseSchema: schema });
+        },
+        handle(handler) {
+            const def = {
+                method: 'PROCEDURE',
+                path,
+                schema: state.bodySchema,
+                steps: [...state.steps],
+                handler,
+            };
+            if (state.timeoutMs !== undefined) {
+                def[PROCEDURE_TIMEOUT] = state.timeoutMs;
+            }
+            if (state.errorTypes.length > 0) {
+                def[PROCEDURE_THROWS] = state.errorTypes;
+            }
+            if (state.bodySchema) {
+                def[PROCEDURE_BODY_SCHEMA] = state.bodySchema;
+            }
+            if (state.responseSchema) {
+                def[PROCEDURE_RESPONSE_SCHEMA] = state.responseSchema;
+            }
+            return def;
+        },
+    };
+    return builder;
+}
+/**
+ * Create a procedure route.
+ *
+ * @example
+ * ```typescript
+ * Procedure('room/:roomId/join')
+ *   .handle(({ session, params }) => {
+ *     return { joined: params.roomId }
+ *   })
+ * ```
+ */
+export function Procedure(path) {
+    return createProcedureBuilder(path, {
+        path,
+        steps: [],
+        errorTypes: [],
+    });
+}
+/** @internal Used by createContextualController(). */
+export function createProcedureFactory() {
+    return function BoundProcedure(path) {
+        return createProcedureBuilder(path, {
+            path,
+            steps: [],
+            errorTypes: [],
+        });
+    };
+}
+//# sourceMappingURL=controller.procedure.js.map

package/dist/core/controller.procedure.js.map

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

package/dist/core/disposable.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Disposable utilities for resource management.
+ *
+ * Provides helpers that return Disposable objects for use with the `using` keyword,
+ * enabling cleaner cleanup code without try/finally blocks.
+ *
+ * @example Stack management
+ * ```typescript
+ * const stack: string[] = [];
+ * {
+ *   using _ = pushScope(stack, "request-123");
+ *   // stack now contains "request-123"
+ *   doWork();
+ * }
+ * // stack is now empty - automatically popped
+ * ```
+ *
+ * @example Set membership
+ * ```typescript
+ * const activeClients = new Set<Client>();
+ * {
+ *   using _ = addToSet(activeClients, client);
+ *   // client is now in the set
+ *   await handleConnection();
+ * }
+ * // client automatically removed from set
+ * ```
+ *
+ * @example Map entries
+ * ```typescript
+ * const cache = new Map<string, Data>();
+ * {
+ *   using _ = setInMap(cache, key, value);
+ *   // cache[key] = value
+ *   await useCache();
+ * }
+ * // cache entry automatically deleted
+ * ```
+ */
+/**
+ * Push a value onto a stack (array), returning a Disposable that pops it on dispose.
+ *
+ * @example
+ * ```typescript
+ * const resolutionStack: string[] = [];
+ * {
+ *   using _ = pushScope(resolutionStack, "ServiceA");
+ *   // resolutionStack is now ["ServiceA"]
+ *   resolve(dependency);
+ * }
+ * // resolutionStack is now [] - automatically popped
+ * ```
+ */
+export declare function pushScope<T>(stack: T[], value: T): Disposable;
+/**
+ * Add an item to a Set, returning a Disposable that removes it on dispose.
+ *
+ * @example
+ * ```typescript
+ * const clients = new Set<Client>();
+ * {
+ *   using _ = addToSet(clients, client);
+ *   await handleMessages();
+ * }
+ * // client removed from set
+ * ```
+ */
+export declare function addToSet<T>(set: Set<T>, value: T): Disposable;
+/**
+ * Set a key in a Map, returning a Disposable that deletes it on dispose.
+ *
+ * @example
+ * ```typescript
+ * const pending = new Map<string, Promise<void>>();
+ * {
+ *   using _ = setInMap(pending, requestId, promise);
+ *   await promise;
+ * }
+ * // requestId removed from pending
+ * ```
+ */
+export declare function setInMap<K, V>(map: Map<K, V>, key: K, value: V): Disposable;
+/**
+ * Create a disposable from a cleanup function.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   using _ = disposable(() => connection.close());
+ *   await connection.query(...);
+ * }
+ * // connection.close() called automatically
+ * ```
+ */
+export declare function disposable(cleanup: () => void): Disposable;
+/**
+ * Create an async disposable from a cleanup function.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   await using _ = asyncDisposable(async () => await connection.close());
+ *   await connection.query(...);
+ * }
+ * // await connection.close() called automatically
+ * ```
+ */
+export declare function asyncDisposable(cleanup: () => Promise<void>): AsyncDisposable;
+/**
+ * Combine multiple disposables into one.
+ * Disposes in reverse order (LIFO).
+ *
+ * @example
+ * ```typescript
+ * {
+ *   using _ = combineDisposables(
+ *     pushScope(stack, "a"),
+ *     addToSet(set, item),
+ *   );
+ *   // both active
+ * }
+ * // both disposed in reverse order
+ * ```
+ */
+export declare function combineDisposables(...disposables: Disposable[]): Disposable;
+//# sourceMappingURL=disposable.d.ts.map

package/dist/core/disposable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.d.ts","sourceRoot":"","sources":["../../src/core/disposable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;;;;;GAaG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAO7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAO7D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,UAAU,CAO3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,IAAI,GAAG,UAAU,CAI1D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,eAAe,CAI7E;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,WAAW,EAAE,UAAU,EAAE,GAAG,UAAU,CAyB3E"}

package/dist/core/disposable.js

@@ -0,0 +1,179 @@
+/**
+ * Disposable utilities for resource management.
+ *
+ * Provides helpers that return Disposable objects for use with the `using` keyword,
+ * enabling cleaner cleanup code without try/finally blocks.
+ *
+ * @example Stack management
+ * ```typescript
+ * const stack: string[] = [];
+ * {
+ *   using _ = pushScope(stack, "request-123");
+ *   // stack now contains "request-123"
+ *   doWork();
+ * }
+ * // stack is now empty - automatically popped
+ * ```
+ *
+ * @example Set membership
+ * ```typescript
+ * const activeClients = new Set<Client>();
+ * {
+ *   using _ = addToSet(activeClients, client);
+ *   // client is now in the set
+ *   await handleConnection();
+ * }
+ * // client automatically removed from set
+ * ```
+ *
+ * @example Map entries
+ * ```typescript
+ * const cache = new Map<string, Data>();
+ * {
+ *   using _ = setInMap(cache, key, value);
+ *   // cache[key] = value
+ *   await useCache();
+ * }
+ * // cache entry automatically deleted
+ * ```
+ */
+/**
+ * Push a value onto a stack (array), returning a Disposable that pops it on dispose.
+ *
+ * @example
+ * ```typescript
+ * const resolutionStack: string[] = [];
+ * {
+ *   using _ = pushScope(resolutionStack, "ServiceA");
+ *   // resolutionStack is now ["ServiceA"]
+ *   resolve(dependency);
+ * }
+ * // resolutionStack is now [] - automatically popped
+ * ```
+ */
+export function pushScope(stack, value) {
+    stack.push(value);
+    return {
+        [Symbol.dispose]() {
+            stack.pop();
+        },
+    };
+}
+/**
+ * Add an item to a Set, returning a Disposable that removes it on dispose.
+ *
+ * @example
+ * ```typescript
+ * const clients = new Set<Client>();
+ * {
+ *   using _ = addToSet(clients, client);
+ *   await handleMessages();
+ * }
+ * // client removed from set
+ * ```
+ */
+export function addToSet(set, value) {
+    set.add(value);
+    return {
+        [Symbol.dispose]() {
+            set.delete(value);
+        },
+    };
+}
+/**
+ * Set a key in a Map, returning a Disposable that deletes it on dispose.
+ *
+ * @example
+ * ```typescript
+ * const pending = new Map<string, Promise<void>>();
+ * {
+ *   using _ = setInMap(pending, requestId, promise);
+ *   await promise;
+ * }
+ * // requestId removed from pending
+ * ```
+ */
+export function setInMap(map, key, value) {
+    map.set(key, value);
+    return {
+        [Symbol.dispose]() {
+            map.delete(key);
+        },
+    };
+}
+/**
+ * Create a disposable from a cleanup function.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   using _ = disposable(() => connection.close());
+ *   await connection.query(...);
+ * }
+ * // connection.close() called automatically
+ * ```
+ */
+export function disposable(cleanup) {
+    return {
+        [Symbol.dispose]: cleanup,
+    };
+}
+/**
+ * Create an async disposable from a cleanup function.
+ *
+ * @example
+ * ```typescript
+ * {
+ *   await using _ = asyncDisposable(async () => await connection.close());
+ *   await connection.query(...);
+ * }
+ * // await connection.close() called automatically
+ * ```
+ */
+export function asyncDisposable(cleanup) {
+    return {
+        [Symbol.asyncDispose]: cleanup,
+    };
+}
+/**
+ * Combine multiple disposables into one.
+ * Disposes in reverse order (LIFO).
+ *
+ * @example
+ * ```typescript
+ * {
+ *   using _ = combineDisposables(
+ *     pushScope(stack, "a"),
+ *     addToSet(set, item),
+ *   );
+ *   // both active
+ * }
+ * // both disposed in reverse order
+ * ```
+ */
+export function combineDisposables(...disposables) {
+    return {
+        [Symbol.dispose]() {
+            // Dispose in reverse order. Catch any throw so subsequent disposals
+            // still run — without this, one buggy dispose would leak every
+            // remaining resource (HTTP server, lock connection, file handle…).
+            // Surface ALL errors at the end via AggregateError so the caller
+            // can see what failed instead of silent suppression.
+            const errors = [];
+            for (let i = disposables.length - 1; i >= 0; i--) {
+                try {
+                    disposables[i][Symbol.dispose]();
+                }
+                catch (err) {
+                    errors.push(err);
+                }
+            }
+            if (errors.length === 1)
+                throw errors[0];
+            if (errors.length > 1) {
+                throw new AggregateError(errors, `combineDisposables: ${errors.length} disposals threw`);
+            }
+        },
+    };
+}
+//# sourceMappingURL=disposable.js.map

package/dist/core/disposable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"disposable.js","sourceRoot":"","sources":["../../src/core/disposable.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,SAAS,CAAI,KAAU,EAAE,KAAQ;IAC/C,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAClB,OAAO;QACL,CAAC,MAAM,CAAC,OAAO,CAAC;YACd,KAAK,CAAC,GAAG,EAAE,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAI,GAAW,EAAE,KAAQ;IAC/C,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACf,OAAO;QACL,CAAC,MAAM,CAAC,OAAO,CAAC;YACd,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,QAAQ,CAAO,GAAc,EAAE,GAAM,EAAE,KAAQ;IAC7D,GAAG,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpB,OAAO;QACL,CAAC,MAAM,CAAC,OAAO,CAAC;YACd,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAClB,CAAC;KACF,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,UAAU,CAAC,OAAmB;IAC5C,OAAO;QACL,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,OAAO;KAC1B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC1D,OAAO;QACL,CAAC,MAAM,CAAC,YAAY,CAAC,EAAE,OAAO;KAC/B,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,kBAAkB,CAAC,GAAG,WAAyB;IAC7D,OAAO;QACL,CAAC,MAAM,CAAC,OAAO,CAAC;YACd,oEAAoE;YACpE,+DAA+D;YAC/D,mEAAmE;YACnE,iEAAiE;YACjE,qDAAqD;YACrD,MAAM,MAAM,GAAc,EAAE,CAAC;YAC7B,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;gBACjD,IAAI,CAAC;oBACH,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;gBACnC,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;gBACnB,CAAC;YACH,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;gBAAE,MAAM,MAAM,CAAC,CAAC,CAAC,CAAC;YACzC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,MAAM,IAAI,cAAc,CACtB,MAAM,EACN,uBAAuB,MAAM,CAAC,MAAM,kBAAkB,CACvD,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/core/hmr.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Hot Module Replacement (HMR) Runtime
+ *
+ * Provides runtime functions for the compiler-generated HMR code.
+ * These functions are prefixed with __ to indicate they're compiler-internal.
+ *
+ * @module @justscale/core/hmr
+ */
+import type { Container } from './service.js';
+/**
+ * Set the container for HMR runtime.
+ * Called by the app builder during initialization in dev mode.
+ *
+ * @param container - The app's container instance
+ */
+export declare function setHmrContainer(container: Container): void;
+/**
+ * Wrap user-provided hotReload state with type hashes for later validation.
+ * Called by the container when saving HMR state during full reload.
+ *
+ * @param serviceId - The stable service ID
+ * @param state - The raw state from the user's hotReload callback
+ * @returns Wrapped state with __values and __typeHashes, or the raw state if no hashes registered
+ */
+export declare function __wrapHmrStateForSave(serviceId: string, state: unknown): unknown;
+/**
+ * Get HMR state for a service during factory execution.
+ * Called by compiler-generated factory wrapper:
+ *
+ * ```typescript
+ * factory: ((__hmr) =>
+ *   ({ lifecycle }) => {
+ *     const cache = __hmr?.cache ?? new Map()
+ *     // ...
+ *   }
+ * )(__getHmrState('src/services/cache.ts#CacheService'))
+ * ```
+ *
+ * @param serviceId - The stable service ID
+ * @returns The saved HMR state, or undefined if none
+ */
+export declare function __getHmrState(serviceId: string): unknown;
+/**
+ * Patch methods on a service instance.
+ * Called by compiler-generated HMR update code when only method bodies changed.
+ *
+ * @param serviceId - The stable service ID
+ * @param changedMethods - List of method names that changed
+ */
+export declare function __hmrPatchMethods(serviceId: string, changedMethods: string[]): Promise<void>;
+/**
+ * Trigger a full reload of a service.
+ * Called by compiler-generated HMR update code when structure changed.
+ *
+ * @param serviceId - The stable service ID
+ */
+export declare function __hmrFullReload(serviceId: string): Promise<void>;
+/**
+ * Validate HMR state before injection.
+ *
+ * Performs per-variable type-aware validation. The state is stored as:
+ *   { __values: { cache: ..., counter: ... }, __typeHashes: { cache: 'abc', counter: 'def' } }
+ *
+ * For each expected variable, compares the stored type hash against the current
+ * expected hash. Variables whose types haven't changed are preserved; variables
+ * whose types changed are discarded (returning undefined for that key, so the
+ * ?? fallback in the factory kicks in).
+ *
+ * Also supports legacy format (plain object without __values/__typeHashes) for
+ * backward compatibility - in that case, all keys are preserved if they match
+ * by name (no type validation possible).
+ *
+ * @param state - The raw state from __getHmrState
+ * @param expectedSchema - Map of variable name to type hash (or string[] for legacy)
+ * @param serviceId - The service ID (for warning messages)
+ * @returns The validated state (partial object with only type-compatible keys), or undefined
+ */
+export declare function __validateHmrState(state: unknown, expectedSchema: Record<string, string> | string[], serviceId: string): unknown;
+/**
+ * Check if HMR is available (dev mode with container initialized).
+ */
+export declare function __hmrAvailable(): boolean;
+//# sourceMappingURL=hmr.d.ts.map

package/dist/core/hmr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr.d.ts","sourceRoot":"","sources":["../../src/core/hmr.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAY9C;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAE1D;AA0BD;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,OAAO,CAchF;AAMD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAMxD;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CACrC,SAAS,EAAE,MAAM,EACjB,cAAc,EAAE,MAAM,EAAE,GACvB,OAAO,CAAC,IAAI,CAAC,CAGf;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGtE;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,OAAO,EACd,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,MAAM,EAAE,EACjD,SAAS,EAAE,MAAM,GAChB,OAAO,CAwFT;AAED;;GAEG;AACH,wBAAgB,cAAc,IAAI,OAAO,CAExC"}