@justscale/typescript 0.1.1

package/dist/compiler/hmr-change-detector.js

@@ -0,0 +1,395 @@
+/**
+ * HMR Change Detector
+ *
+ * Analyzes two versions of TypeScript source code to determine:
+ * 1. Which services changed
+ * 2. What kind of changes occurred (method-only vs structural)
+ * 3. Which specific methods changed (for method patching)
+ *
+ * This enables the dev server to choose between:
+ * - method-patch: Only method bodies changed, can do in-place patching
+ * - full-reload: Structural changes, need full service reload with state migration
+ */
+import ts from 'typescript';
+/**
+ * Detect changes between two versions of a source file.
+ *
+ * @param oldSource - Previous version of the source code
+ * @param newSource - New version of the source code
+ * @param fileName - File path (for service ID generation)
+ * @param baseDir - Base directory for relative paths
+ */
+export function detectChanges(oldSource, newSource, fileName, baseDir = process.cwd()) {
+    const oldServices = extractServiceSignatures(oldSource, fileName, baseDir);
+    const newServices = extractServiceSignatures(newSource, fileName, baseDir);
+    const result = {
+        hasChanges: false,
+        services: [],
+        added: [],
+        removed: [],
+    };
+    // Find added services
+    for (const [id] of newServices) {
+        if (!oldServices.has(id)) {
+            result.added.push(id);
+            result.hasChanges = true;
+        }
+    }
+    // Find removed services
+    for (const [id] of oldServices) {
+        if (!newServices.has(id)) {
+            result.removed.push(id);
+            result.hasChanges = true;
+        }
+    }
+    // Compare existing services
+    for (const [id, newSig] of newServices) {
+        const oldSig = oldServices.get(id);
+        if (!oldSig)
+            continue; // Already handled as added
+        const change = compareServiceSignatures(oldSig, newSig);
+        if (change) {
+            result.services.push(change);
+            result.hasChanges = true;
+        }
+    }
+    return result;
+}
+/**
+ * Extract service signatures from source code.
+ */
+function extractServiceSignatures(source, fileName, baseDir) {
+    const sourceFile = ts.createSourceFile(fileName, source, ts.ScriptTarget.Latest, true, ts.ScriptKind.TS);
+    const services = new Map();
+    const relativePath = getRelativePath(fileName, baseDir);
+    const visitor = (node) => {
+        if (ts.isClassDeclaration(node) && node.name) {
+            const className = node.name.text;
+            // Check if this class extends defineService
+            const extendsDefineService = node.heritageClauses?.some((clause) => clause.types.some((type) => {
+                if (ts.isCallExpression(type.expression)) {
+                    const expr = type.expression.expression;
+                    return ts.isIdentifier(expr) && expr.text === 'defineService';
+                }
+                return false;
+            }));
+            if (extendsDefineService) {
+                const sig = extractSingleServiceSignature(node, className, relativePath);
+                if (sig) {
+                    services.set(sig.id, sig);
+                }
+            }
+        }
+        ts.forEachChild(node, visitor);
+    };
+    ts.forEachChild(sourceFile, visitor);
+    return services;
+}
+/**
+ * Extract signature for a single service class.
+ */
+function extractSingleServiceSignature(classNode, className, relativePath) {
+    const id = `${relativePath}#${className}`;
+    // Find the defineService call in heritage clause
+    const heritageClause = classNode.heritageClauses?.find((clause) => clause.types.some((type) => {
+        if (ts.isCallExpression(type.expression)) {
+            const expr = type.expression.expression;
+            return ts.isIdentifier(expr) && expr.text === 'defineService';
+        }
+        return false;
+    }));
+    if (!heritageClause)
+        return null;
+    const defineServiceType = heritageClause.types.find((type) => {
+        if (ts.isCallExpression(type.expression)) {
+            const expr = type.expression.expression;
+            return ts.isIdentifier(expr) && expr.text === 'defineService';
+        }
+        return false;
+    });
+    if (!defineServiceType || !ts.isCallExpression(defineServiceType.expression)) {
+        return null;
+    }
+    const callExpr = defineServiceType.expression;
+    const configArg = callExpr.arguments[0];
+    if (!configArg || !ts.isObjectLiteralExpression(configArg)) {
+        return null;
+    }
+    // Extract inject signature
+    let injectSignature = '';
+    let factoryNode = null;
+    let hasHotReload = false;
+    for (const prop of configArg.properties) {
+        if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
+            if (prop.name.text === 'inject') {
+                injectSignature = normalizeNode(prop.initializer);
+            }
+            else if (prop.name.text === 'factory') {
+                if (ts.isArrowFunction(prop.initializer) ||
+                    ts.isFunctionExpression(prop.initializer)) {
+                    factoryNode = prop.initializer;
+                    // Check for hotReload registration
+                    hasHotReload = containsHotReloadRegistration(factoryNode.body);
+                }
+            }
+        }
+    }
+    if (!factoryNode) {
+        return null;
+    }
+    // Extract method signatures and bodies from factory return
+    const { methods, methodBodies } = extractMethodsFromFactory(factoryNode);
+    return {
+        id,
+        className,
+        injectSignature,
+        methods,
+        methodBodies,
+        hasHotReload,
+    };
+}
+/**
+ * Extract method signatures and bodies from factory function.
+ */
+function extractMethodsFromFactory(factory) {
+    const methods = new Map();
+    const methodBodies = new Map();
+    // Find return statement in factory
+    const returnedObject = findReturnedObject(factory.body);
+    if (!returnedObject) {
+        return { methods, methodBodies };
+    }
+    for (const prop of returnedObject.properties) {
+        if (ts.isMethodDeclaration(prop) && ts.isIdentifier(prop.name)) {
+            const name = prop.name.text;
+            methods.set(name, getMethodSignature(prop));
+            methodBodies.set(name, normalizeNode(prop.body ?? prop));
+        }
+        else if (ts.isPropertyAssignment(prop) && ts.isIdentifier(prop.name)) {
+            const name = prop.name.text;
+            if (ts.isArrowFunction(prop.initializer) ||
+                ts.isFunctionExpression(prop.initializer)) {
+                methods.set(name, getPropertyFunctionSignature(prop.initializer));
+                methodBodies.set(name, normalizeNode(prop.initializer.body));
+            }
+        }
+        else if (ts.isShorthandPropertyAssignment(prop) &&
+            ts.isIdentifier(prop.name)) {
+            // Shorthand like { myFunc } - we can't compare bodies easily
+            const name = prop.name.text;
+            methods.set(name, 'shorthand');
+            methodBodies.set(name, 'shorthand');
+        }
+    }
+    return { methods, methodBodies };
+}
+/**
+ * Find the returned object literal in a factory body.
+ */
+function findReturnedObject(body) {
+    // Direct object return: () => ({ ... })
+    if (ts.isParenthesizedExpression(body)) {
+        const inner = body.expression;
+        if (ts.isObjectLiteralExpression(inner)) {
+            return inner;
+        }
+    }
+    if (ts.isObjectLiteralExpression(body)) {
+        return body;
+    }
+    // Block with return statement
+    if (ts.isBlock(body)) {
+        for (const stmt of body.statements) {
+            if (ts.isReturnStatement(stmt) && stmt.expression) {
+                if (ts.isObjectLiteralExpression(stmt.expression)) {
+                    return stmt.expression;
+                }
+            }
+        }
+    }
+    return null;
+}
+/**
+ * Get signature of a method declaration (params + return type).
+ */
+function getMethodSignature(method) {
+    const params = method.parameters
+        .map((p) => {
+        const name = ts.isIdentifier(p.name) ? p.name.text : '?';
+        const type = p.type ? normalizeNode(p.type) : 'any';
+        return `${name}:${type}`;
+    })
+        .join(',');
+    const returnType = method.type ? normalizeNode(method.type) : 'any';
+    return `(${params})=>${returnType}`;
+}
+/**
+ * Get signature of a function property (arrow/function expression).
+ */
+function getPropertyFunctionSignature(fn) {
+    const params = fn.parameters
+        .map((p) => {
+        const name = ts.isIdentifier(p.name) ? p.name.text : '?';
+        const type = p.type ? normalizeNode(p.type) : 'any';
+        return `${name}:${type}`;
+    })
+        .join(',');
+    const returnType = fn.type ? normalizeNode(fn.type) : 'any';
+    return `(${params})=>${returnType}`;
+}
+/**
+ * Check if a function body contains a hotReload registration.
+ */
+function containsHotReloadRegistration(body) {
+    let found = false;
+    const visitor = (node) => {
+        if (found)
+            return;
+        if (ts.isCallExpression(node)) {
+            const expr = node.expression;
+            if (ts.isPropertyAccessExpression(expr) &&
+                expr.name.text === 'register' &&
+                node.arguments.length >= 1) {
+                const hookArg = node.arguments[0];
+                if (ts.isStringLiteral(hookArg) && hookArg.text === 'hotReload') {
+                    found = true;
+                    return;
+                }
+            }
+        }
+        ts.forEachChild(node, visitor);
+    };
+    if (ts.isBlock(body)) {
+        ts.forEachChild(body, visitor);
+    }
+    return found;
+}
+/**
+ * Compare two service signatures and determine what changed.
+ */
+function compareServiceSignatures(oldSig, newSig) {
+    // Check for structural changes that require full reload
+    if (oldSig.injectSignature !== newSig.injectSignature) {
+        return {
+            serviceId: newSig.id,
+            changeType: 'structural',
+            changedMethods: [],
+            reason: 'inject dependencies changed',
+        };
+    }
+    // Check if methods were added or removed
+    const oldMethods = new Set(oldSig.methods.keys());
+    const newMethods = new Set(newSig.methods.keys());
+    for (const name of newMethods) {
+        if (!oldMethods.has(name)) {
+            return {
+                serviceId: newSig.id,
+                changeType: 'structural',
+                changedMethods: [],
+                reason: `method added: ${name}`,
+            };
+        }
+    }
+    for (const name of oldMethods) {
+        if (!newMethods.has(name)) {
+            return {
+                serviceId: newSig.id,
+                changeType: 'structural',
+                changedMethods: [],
+                reason: `method removed: ${name}`,
+            };
+        }
+    }
+    // Check if method signatures changed.
+    //
+    // This comparison includes TypeScript type annotations because normalizeNode
+    // uses getText() which preserves the original source text. This means a
+    // type-only change like (x: string) => void -> (x: number) => void IS
+    // detected as a structural change and triggers a full reload. This is
+    // intentionally conservative: while types are erased at runtime, a type
+    // change in a parameter often accompanies a semantic change in the method
+    // body or its callers. If this causes excessive full reloads in practice,
+    // the signature comparison could be relaxed to strip type annotations.
+    for (const [name, oldSigStr] of oldSig.methods) {
+        const newSigStr = newSig.methods.get(name);
+        if (oldSigStr !== newSigStr) {
+            return {
+                serviceId: newSig.id,
+                changeType: 'structural',
+                changedMethods: [],
+                reason: `method signature changed: ${name}`,
+            };
+        }
+    }
+    // Check for method body changes (can use method-patch)
+    const changedMethods = [];
+    for (const [name, oldBody] of oldSig.methodBodies) {
+        const newBody = newSig.methodBodies.get(name);
+        if (oldBody !== newBody) {
+            changedMethods.push(name);
+        }
+    }
+    if (changedMethods.length > 0) {
+        // If service doesn't have hotReload hook, we need full reload
+        if (!newSig.hasHotReload) {
+            return {
+                serviceId: newSig.id,
+                changeType: 'structural',
+                changedMethods: [],
+                reason: 'method body changed but no hotReload hook',
+            };
+        }
+        return {
+            serviceId: newSig.id,
+            changeType: 'method-only',
+            changedMethods,
+            reason: `method bodies changed: ${changedMethods.join(', ')}`,
+        };
+    }
+    // No changes
+    return null;
+}
+/**
+ * Normalize a node to a string for comparison.
+ * Strips whitespace and formatting differences.
+ */
+function normalizeNode(node) {
+    // Get the source file from the node itself
+    const sourceFile = node.getSourceFile();
+    if (sourceFile) {
+        // Use getText() which extracts from the original source
+        try {
+            return node.getText(sourceFile).replace(/\s+/g, ' ').trim();
+        }
+        catch {
+            // Fall through to printer approach
+        }
+    }
+    // Fallback: use printer for synthesized nodes
+    const printer = ts.createPrinter({
+        newLine: ts.NewLineKind.LineFeed,
+        removeComments: true,
+    });
+    const dummySourceFile = ts.createSourceFile('temp.ts', '', ts.ScriptTarget.Latest, false, ts.ScriptKind.TS);
+    return printer
+        .printNode(ts.EmitHint.Unspecified, node, dummySourceFile)
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+/**
+ * Get relative path for service ID.
+ */
+function getRelativePath(fileName, baseDir) {
+    if (fileName.startsWith(baseDir)) {
+        return fileName.slice(baseDir.length).replace(/^\//, '');
+    }
+    return fileName;
+}
+/**
+ * Quick check if a file might contain services.
+ * Use this for early filtering in file watchers.
+ */
+export function mightContainServices(source) {
+    return source.includes('defineService');
+}
+//# sourceMappingURL=hmr-change-detector.js.map

package/dist/compiler/hmr-change-detector.js.map

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

package/dist/compiler/hmr-transformer.d.ts

@@ -0,0 +1,54 @@
+/**
+ * HMR (Hot Module Replacement) Transformer
+ *
+ * TypeScript transformer that enables hot reload for JustScale services.
+ *
+ * Transforms:
+ * 1. Injects stable service IDs into defineService() calls
+ * 2. Wraps factory functions with HMR state injection
+ * 3. Rewrites variable initializers to use HMR state
+ *
+ * Example transformation:
+ *
+ * ```typescript
+ * // Input
+ * class CacheService extends defineService({
+ *   inject: { lifecycle: Lifecycle },
+ *   factory: ({ lifecycle }) => {
+ *     const cache = new Map()
+ *     lifecycle.register('hotReload', () => ({ cache }))
+ *     return { get: (k) => cache.get(k) }
+ *   }
+ * }) {}
+ *
+ * // Output
+ * class CacheService extends defineService({
+ *   __serviceId: 'src/services/cache.ts#CacheService',
+ *   inject: { lifecycle: Lifecycle },
+ *   factory: ((__hmr) =>
+ *     ({ lifecycle }) => {
+ *       const cache = __hmr?.cache ?? new Map()
+ *       lifecycle.register('hotReload', () => ({ cache }))
+ *       return { get: (k) => cache.get(k) }
+ *     }
+ *   )(__getHmrState('src/services/cache.ts#CacheService'))
+ * }) {}
+ * ```
+ */
+import ts from 'typescript';
+export interface HmrTransformerOptions {
+    /** Enable verbose logging */
+    verbose?: boolean;
+    /** Base directory for relative paths (defaults to cwd) */
+    baseDir?: string;
+    /** Whether to enable HMR transforms (default: true in dev mode) */
+    enabled?: boolean;
+}
+/**
+ * Creates a TypeScript transformer for HMR support.
+ *
+ * This should be used in dev mode only. In production builds,
+ * set enabled: false to skip all HMR transforms.
+ */
+export declare function createHmrTransformer(program: ts.Program, options?: HmrTransformerOptions): ts.TransformerFactory<ts.SourceFile>;
+//# sourceMappingURL=hmr-transformer.d.ts.map

package/dist/compiler/hmr-transformer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hmr-transformer.d.ts","sourceRoot":"","sources":["../../src/compiler/hmr-transformer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAEH,OAAO,EAAE,MAAM,YAAY,CAAC;AAoE5B,MAAM,WAAW,qBAAqB;IACpC,6BAA6B;IAC7B,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,0DAA0D;IAC1D,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,mEAAmE;IACnE,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,EAAE,CAAC,OAAO,EACnB,OAAO,GAAE,qBAA0B,GAClC,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,UAAU,CAAC,CA0EtC"}