durable-actors 0.2.4

package/dist/compiler/features/persistence.js

@@ -0,0 +1,102 @@
+import ts from "typescript";
+import { definitionDiagnostic } from "../actor-compiler.js";
+import { AnnotationKind, Persistence } from "../types.js";
+function validatePersistence(actor) {
+    const fields = [];
+    const diagnostics = [];
+    for (const member of actor.members) {
+        const node = member.node;
+        if (ts.isConstructorDeclaration(node)) {
+            for (const parameter of node.parameters) {
+                if (ts.isParameterPropertyDeclaration(parameter, node))
+                    diagnostics.push(definitionDiagnostic(parameter, "actor parameter properties must become explicitly decorated class fields"));
+            }
+        }
+        if (!ts.isPropertyDeclaration(node) || hasModifier(node, ts.SyntaxKind.StaticKeyword))
+            continue;
+        const result = validateField(actor.name, member);
+        diagnostics.push(...result.diagnostics);
+        if (result.field !== undefined)
+            fields.push(result.field);
+    }
+    return { fields, diagnostics };
+}
+function readPersistence(use, mode) {
+    const name = mode === Persistence.Persisted ? "Persisted" : "Ephemeral";
+    const node = use.target;
+    if (!ts.isPropertyDeclaration(node) ||
+        hasModifier(node, ts.SyntaxKind.StaticKeyword) ||
+        hasModifier(node, ts.SyntaxKind.AccessorKeyword))
+        return invalid(use, `@${name} requires an instance field`);
+    if (use.called)
+        return invalid(use, `use @${name} without parentheses or arguments`);
+    if (hasModifier(node, ts.SyntaxKind.DeclareKeyword))
+        return invalid(use, `@${name} requires a runtime field, not a declare field`);
+    if (fieldName(node.name) === undefined)
+        return invalid(use, `@${name} requires a field with a literal string name`);
+    if (mode === Persistence.Persisted && ts.isPrivateIdentifier(node.name))
+        return invalid(use, "@Persisted cannot decorate a JavaScript private field; use @Ephemeral");
+    return { annotations: [{ kind: AnnotationKind.Persistence, mode, node: use.node }], diagnostics: [] };
+}
+function readEmission(use) {
+    const node = use.target;
+    if (!ts.isPropertyDeclaration(node) ||
+        hasModifier(node, ts.SyntaxKind.StaticKeyword) ||
+        hasModifier(node, ts.SyntaxKind.AccessorKeyword))
+        return invalid(use, "@Emittable requires an instance field");
+    if (use.called)
+        return invalid(use, "use @Emittable without parentheses or arguments");
+    if (ts.isPrivateIdentifier(node.name) ||
+        hasModifier(node, ts.SyntaxKind.PrivateKeyword) ||
+        hasModifier(node, ts.SyntaxKind.ProtectedKeyword))
+        return invalid(use, "@Emittable requires a public persisted field");
+    return { annotations: [{ kind: AnnotationKind.Emission, node: use.node }], diagnostics: [] };
+}
+function validateField(actorName, member) {
+    const node = member.node;
+    if (member.diagnostics.length > 0)
+        return { diagnostics: [] };
+    const annotations = member.annotations.filter(annotation => annotation.kind === AnnotationKind.Persistence);
+    const emission = member.annotations.filter(annotation => annotation.kind === AnnotationKind.Emission);
+    if (annotations.length !== 1)
+        return {
+            diagnostics: [
+                definitionDiagnostic(node.name, `actor field ${actorName}.${node.name.getText()} must declare exactly one of @Persisted or @Ephemeral`, annotations.map(annotation => annotation.node))
+            ]
+        };
+    if (emission.length > 1 || (emission.length === 1 && annotations[0].mode !== Persistence.Persisted))
+        return {
+            diagnostics: [
+                definitionDiagnostic(node, "@Emittable requires a public @Persisted field and cannot be repeated")
+            ]
+        };
+    return {
+        field: {
+            name: fieldName(node.name),
+            persistence: annotations[0].mode,
+            ...(ts.isPrivateIdentifier(node.name) ? { private: true } : {}),
+            ...(hasModifier(node, ts.SyntaxKind.PrivateKeyword)
+                ? { visibility: "private" }
+                : hasModifier(node, ts.SyntaxKind.ProtectedKeyword)
+                    ? { visibility: "protected" }
+                    : {}),
+            ...(emission.length === 1 ? { emittable: true } : {})
+        },
+        diagnostics: []
+    };
+}
+function fieldName(name) {
+    if (ts.isIdentifier(name) || ts.isPrivateIdentifier(name) || ts.isStringLiteral(name) || ts.isNumericLiteral(name))
+        return name.text;
+    if (ts.isComputedPropertyName(name) &&
+        (ts.isStringLiteral(name.expression) || ts.isNumericLiteral(name.expression)))
+        return name.expression.text;
+}
+function hasModifier(node, kind) {
+    return ts.canHaveModifiers(node) && (ts.getModifiers(node)?.some(modifier => modifier.kind === kind) ?? false);
+}
+function invalid(use, message) {
+    return { annotations: [], diagnostics: [definitionDiagnostic(use.node, message)] };
+}
+export { readEmission, readPersistence, validatePersistence };
+//# sourceMappingURL=persistence.js.map

package/dist/compiler/features/persistence.js.map

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

package/dist/compiler/features/reentrancy.d.ts

@@ -0,0 +1,9 @@
+import ts from "typescript";
+import type { DecoratorResult, DecoratorUse, ParsedActor } from "../types.js";
+declare function readReentrancy(use: DecoratorUse): DecoratorResult;
+declare function validateReentrancy(actor: ParsedActor): {
+    methods: string[];
+    diagnostics: ts.Diagnostic[];
+};
+export { readReentrancy, validateReentrancy };
+//# sourceMappingURL=reentrancy.d.ts.map

package/dist/compiler/features/reentrancy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reentrancy.d.ts","sourceRoot":"","sources":["../../../src/compiler/features/reentrancy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAI3B,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAA;AAE7E,iBAAS,cAAc,CAAC,GAAG,EAAE,YAAY,GAAG,eAAe,CAW1D;AAED,iBAAS,kBAAkB,CAAC,KAAK,EAAE,WAAW;;;EAS7C;AAkBD,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/compiler/features/reentrancy.js

@@ -0,0 +1,44 @@
+import ts from "typescript";
+import { definitionDiagnostic } from "../actor-compiler.js";
+import { AnnotationKind } from "../types.js";
+function readReentrancy(use) {
+    const node = use.target;
+    if (use.called)
+        return invalidReentrancy(use);
+    if (!ts.isMethodDeclaration(node) || !node.body)
+        return invalidReentrancy(use);
+    if (!hasModifier(node, ts.SyntaxKind.AsyncKeyword))
+        return invalidReentrancy(use);
+    if (hasModifier(node, ts.SyntaxKind.StaticKeyword))
+        return invalidReentrancy(use);
+    if (hasModifier(node, ts.SyntaxKind.PrivateKeyword) || hasModifier(node, ts.SyntaxKind.ProtectedKeyword))
+        return invalidReentrancy(use);
+    if (!ts.isIdentifier(node.name) && !ts.isStringLiteral(node.name))
+        return invalidReentrancy(use);
+    return { annotations: [{ kind: AnnotationKind.Reentrancy, node: use.node }], diagnostics: [] };
+}
+function validateReentrancy(actor) {
+    const methods = [];
+    const diagnostics = [];
+    for (const member of actor.members) {
+        const annotations = member.annotations.filter(annotation => annotation.kind === AnnotationKind.Reentrancy);
+        if (annotations.length > 1)
+            diagnostics.push(definitionDiagnostic(member.node, "@Reentrant cannot be repeated"));
+        if (annotations.length === 1)
+            methods.push(member.node.name.text);
+    }
+    return { methods, diagnostics };
+}
+function hasModifier(node, kind) {
+    return ts.getModifiers(node)?.some(modifier => modifier.kind === kind) ?? false;
+}
+function invalidReentrancy(use) {
+    return {
+        annotations: [],
+        diagnostics: [
+            definitionDiagnostic(use.target, "@Reentrant requires a public instance async method; use it without parentheses")
+        ]
+    };
+}
+export { readReentrancy, validateReentrancy };
+//# sourceMappingURL=reentrancy.js.map

package/dist/compiler/features/reentrancy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reentrancy.js","sourceRoot":"","sources":["../../../src/compiler/features/reentrancy.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAG5C,SAAS,cAAc,CAAC,GAAiB;IACrC,MAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAA;IACvB,IAAI,GAAG,CAAC,MAAM;QAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC7C,IAAI,CAAC,EAAE,CAAC,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAC9E,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,YAAY,CAAC;QAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IACjF,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,aAAa,CAAC;QAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IACjF,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,gBAAgB,CAAC;QACpG,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IACjC,IAAI,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,iBAAiB,CAAC,GAAG,CAAC,CAAA;IAEhG,OAAO,EAAE,WAAW,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,EAAE,EAAE,CAAA;AAClG,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAkB;IAC1C,MAAM,OAAO,GAAa,EAAE,CAAA;IAC5B,MAAM,WAAW,GAAoB,EAAE,CAAA;IACvC,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,KAAK,cAAc,CAAC,UAAU,CAAC,CAAA;QAC1G,IAAI,WAAW,CAAC,MAAM,GAAG,CAAC;YAAE,WAAW,CAAC,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,+BAA+B,CAAC,CAAC,CAAA;QAChH,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,IAAI,CAAE,MAAM,CAAC,IAAI,CAAC,IAAyC,CAAC,IAAI,CAAC,CAAA;IAC3G,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,CAAA;AACnC,CAAC;AAED,SAAS,WAAW,CAAC,IAA0B,EAAE,IAAmB;IAChE,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,QAAQ,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,CAAA;AACnF,CAAC;AAED,SAAS,iBAAiB,CAAC,GAAiB;IACxC,OAAO;QACH,WAAW,EAAE,EAAE;QACf,WAAW,EAAE;YACT,oBAAoB,CAChB,GAAG,CAAC,MAAM,EACV,gFAAgF,CACnF;SACJ;KACJ,CAAA;AACL,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAA"}

package/dist/compiler/generators/backend-generator.d.ts

@@ -0,0 +1,5 @@
+import type { SocketContract } from "../../wire/contract.js";
+import type { ActorApi } from "../../wire/public-contract.js";
+declare function backendSource(actors: readonly ActorApi[], contracts: readonly SocketContract[], wireNames: ReadonlyMap<string, readonly string[]>): Promise<string>;
+export { backendSource };
+//# sourceMappingURL=backend-generator.d.ts.map

package/dist/compiler/generators/backend-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"backend-generator.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/backend-generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,QAAQ,EAAyC,MAAM,+BAA+B,CAAA;AAIpG,iBAAe,aAAa,CACxB,MAAM,EAAE,SAAS,QAAQ,EAAE,EAC3B,SAAS,EAAE,SAAS,cAAc,EAAE,EACpC,SAAS,EAAE,WAAW,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC,GAClD,OAAO,CAAC,MAAM,CAAC,CAsBjB;AAwLD,OAAO,EAAE,aAAa,EAAE,CAAA"}

package/dist/compiler/generators/backend-generator.js

@@ -0,0 +1,181 @@
+import { compile } from "json-schema-to-typescript";
+import ts from "typescript";
+import { usageComment } from "./usage-comment.js";
+async function backendSource(actors, contracts, wireNames) {
+    const sources = [];
+    for (const { actorName } of contracts) {
+        const actor = actors.find(actor => actor.actorName === actorName);
+        sources.push(actor
+            ? await actorSource(actor, wireNames.get(actorName) ?? [])
+            : { declarations: "", descriptor: actorDescriptor(actorName) });
+    }
+    const exampleType = contracts[0]?.actorName;
+    const exampleActor = actors[0]?.actorName;
+    return `${usageComment("Types for actor state and methods.", exampleType && `type State = actors.${exampleType}.State`)}
+export declare namespace actors {
+${sources.map(source => source.declarations).join("\n")}
+}
+
+${usageComment("Call actor methods from your backend.", exampleActor && `const actor = actors.${exampleActor}.get("actor-id")`)}
+export const actors = {
+${sources.map(source => source.descriptor).join(",\n")}
+}
+`;
+}
+async function actorSource(actor, wireNames) {
+    const { declarations, types, stubName, methodsName } = await rpcDeclarations(actor.rpc, wireNames);
+    const methods = actor.rpc.methods.map((method, index) => methodDeclaration(method, index, types)).join("\n");
+    const descriptors = actor.rpc.methods.map(method => ({ name: method.name, result: method.result.kind }));
+    const stub = `actors.${actor.actorName}.${stubName}`;
+    return {
+        declarations: `export namespace ${actor.actorName} {
+${declarations}
+export interface ${stubName} {
+${methods}
+}
+${methodTypes(actor.actorName, actor.rpc.methods, stubName, methodsName)}
+}`,
+        descriptor: actorDescriptor(actor.actorName, `get(actorId: string, transport?: import("durable-actors/backend").ActorRpcTransport): ${stub} {
+        return $createActorStub<${stub}>(${JSON.stringify(actor.actorName)}, actorId, ${JSON.stringify(descriptors)}, transport)
+    }`)
+    };
+}
+function actorDescriptor(actorName, rpc) {
+    return `[${JSON.stringify(actorName)}]: {
+    ${rpc ? `${rpc},` : ""}
+    ${usageComment("Allow a frontend connection after your backend checks the user's access.", `const grant = await actors.${actorName}.prepareWebsocket({ actorId: "actor-id", metadata })`)}
+    prepareWebsocket(
+        authorization: Omit<actors.${actorName}.Authorization, "actorName">,
+        options: import("durable-actors/proxy").SocketProxyOptions = {},
+        dependencies: import("durable-actors/proxy").SocketProxyDependencies = {}
+    ): Promise<import("durable-actors/proxy").SocketGrant> {
+        return new ActorProxy(options, dependencies).handle({ ...authorization, actorName: ${JSON.stringify(actorName)} })
+    }
+}`;
+}
+function methodTypes(actorName, methods, stubName, methodsName) {
+    const entries = methods.map(({ name }) => `[${JSON.stringify(name)}]: {
+    Args: Parameters<${stubName}[${JSON.stringify(name)}]>
+    Result: Awaited<ReturnType<${stubName}[${JSON.stringify(name)}]>>
+}`);
+    const namespaces = methods
+        .filter(method => isIdentifier(method.name))
+        .map(({ name }) => `export namespace ${name} {
+    export type Args = ${methodsName}[${JSON.stringify(name)}]["Args"]
+    export type Result = ${methodsName}[${JSON.stringify(name)}]["Result"]
+}`);
+    return `interface ${methodsName} {
+${entries.join("\n")}
+}
+export interface Methods extends ${methodsName} {}
+${usageComment("Types for a method's arguments and return value.", methods[0] && `type Args = actors.${actorName}.Methods[${JSON.stringify(methods[0].name)}]["Args"]\ntype Result = actors.${actorName}.Methods[${JSON.stringify(methods[0].name)}]["Result"]`)}
+export namespace Methods {
+${namespaces.join("\n")}
+}`;
+}
+async function rpcDeclarations(rpc, wireNames) {
+    const { properties, definitions } = rpcSchemaTypes(rpc);
+    const code = await compile({
+        ...rpc.schema,
+        definitions,
+        type: "object",
+        properties,
+        required: Object.keys(properties),
+        additionalProperties: false
+    }, "RpcTypes", {
+        $refOptions: { resolve: { file: false, http: false } },
+        bannerComment: "",
+        unknownAny: true,
+        additionalProperties: false,
+        customName: (schema, key) => {
+            const name = schema.title || schema.$id || key;
+            const reserved = [
+                ...wireNames,
+                "State",
+                "Metadata",
+                "Incoming",
+                "Outgoing",
+                "Connection",
+                "Authorization",
+                "Methods",
+                "Parameters",
+                "ReturnType",
+                "Awaited"
+            ];
+            let available = name;
+            while (reserved.includes(available))
+                available += "Data";
+            return available === name ? undefined : available;
+        }
+    });
+    return readRpcDeclarations(code, wireNames);
+}
+function rpcSchemaTypes(rpc) {
+    const properties = Object.create(null);
+    const definitions = { ...rpc.schema.definitions };
+    const add = (name, type, displayName) => {
+        const key = type.$ref.slice("#/definitions/".length);
+        const definition = definitions[key];
+        properties[name] = typeof definition === "boolean" ? definition : type;
+        if (definition && typeof definition === "object" && !definition.title && !definition.$ref)
+            definitions[key] = { ...definition, title: displayName };
+    };
+    rpc.methods.forEach((method, methodIndex) => {
+        method.parameters.forEach((parameter, index) => add(`m${methodIndex}p${index}`, parameter.type, `${method.name} ${parameter.name}`));
+        if (method.result.kind === "value")
+            add(`m${methodIndex}result`, method.result.type, `${method.name} result`);
+    });
+    return { properties, definitions };
+}
+function readRpcDeclarations(code, wireNames) {
+    const source = ts.createSourceFile("types.ts", code, ts.ScriptTarget.Latest, true);
+    const root = source.statements.find(statement => ts.isInterfaceDeclaration(statement) && statement.name.text === "RpcTypes");
+    const types = new Map(root.members
+        .filter(ts.isPropertySignature)
+        .map(property => [property.name.text, property.type.getText(source)]));
+    const statements = source.statements.filter(statement => statement !== root);
+    const declarations = statements.map(statement => statement.getText(source)).join("\n\n");
+    return {
+        declarations,
+        types,
+        stubName: availableTypeName(statements, "Stub", wireNames),
+        methodsName: availableTypeName(statements, "$MethodTypes", wireNames)
+    };
+}
+function availableTypeName(statements, proposed, reserved) {
+    const declarationNames = new Set(statements.flatMap(statement => ts.isInterfaceDeclaration(statement) ||
+        ts.isTypeAliasDeclaration(statement) ||
+        ts.isEnumDeclaration(statement)
+        ? [statement.name.text]
+        : []));
+    let name = proposed;
+    while (declarationNames.has(name) || reserved.includes(name))
+        name += "_";
+    return name;
+}
+function methodDeclaration(method, index, types) {
+    const used = new Set();
+    const parameters = method.parameters
+        .map((parameter, parameterIndex) => {
+        const name = parameterName(parameter.name, parameterIndex, used);
+        const prefix = parameter.rest ? "..." : "";
+        const optional = parameter.optional ? "?" : "";
+        return `${prefix}${name}${optional}: ${types.get(`m${index}p${parameterIndex}`)}`;
+    })
+        .join(", ");
+    const result = method.result.kind === "void" ? "void" : types.get(`m${index}result`);
+    return `    ${JSON.stringify(method.name)}(${parameters}): Promise<${result}>`;
+}
+function parameterName(proposed, index, used) {
+    let name = isIdentifier(proposed) ? proposed : `arg${index}`;
+    while (used.has(name))
+        name += "_";
+    used.add(name);
+    return name;
+}
+function isIdentifier(name) {
+    const scanner = ts.createScanner(ts.ScriptTarget.Latest, false, ts.LanguageVariant.Standard, name);
+    return scanner.scan() === ts.SyntaxKind.Identifier && scanner.scan() === ts.SyntaxKind.EndOfFileToken;
+}
+export { backendSource };
+//# sourceMappingURL=backend-generator.js.map

package/dist/compiler/generators/backend-generator.js.map

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

package/dist/compiler/generators/client-generator.d.ts

@@ -0,0 +1,5 @@
+import type { SocketContract } from "../../wire/contract.js";
+import type { PublicActorContract } from "../../wire/public-contract.js";
+declare function generateClient(input: readonly SocketContract[] | PublicActorContract, directory: string): Promise<void>;
+export { generateClient };
+//# sourceMappingURL=client-generator.d.ts.map

package/dist/compiler/generators/client-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-generator.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/client-generator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAIxE,iBAAe,cAAc,CACzB,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,mBAAmB,EACtD,SAAS,EAAE,MAAM,GAClB,OAAO,CAAC,IAAI,CAAC,CAqBf;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/compiler/generators/client-generator.js

@@ -0,0 +1,28 @@
+import { mkdir, rm, writeFile } from "node:fs/promises";
+import path from "node:path";
+import { generateTypeScript } from "./typescript-generator.js";
+async function generateClient(input, directory) {
+    const artifacts = await generateTypeScript(input);
+    const contracts = "actors" in input ? input.actors.map(actor => actor.socket) : input;
+    await mkdir(directory, { recursive: true });
+    for (const [file, contents] of artifacts)
+        await writeFile(path.join(directory, file), contents);
+    for (const file of ["frontend.ts", "backend.ts", "proxy.ts", "socket.ts", "rpc.ts"])
+        await rm(path.join(directory, file), { force: true });
+    for (const { actorName } of contracts)
+        for (const suffix of [
+            "actor.ts",
+            "frontend.ts",
+            "backend.ts",
+            "proxy.ts",
+            "socket.ts",
+            "rpc.ts",
+            "validators.js",
+            "validators.d.ts",
+            "proxy-validators.js",
+            "proxy-validators.d.ts"
+        ])
+            await rm(path.join(directory, `${actorName}.${suffix}`), { force: true });
+}
+export { generateClient };
+//# sourceMappingURL=client-generator.js.map

package/dist/compiler/generators/client-generator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client-generator.js","sourceRoot":"","sources":["../../../src/compiler/generators/client-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AACvD,OAAO,IAAI,MAAM,WAAW,CAAA;AAK5B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAA;AAE9D,KAAK,UAAU,cAAc,CACzB,KAAsD,EACtD,SAAiB;IAEjB,MAAM,SAAS,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,CAAA;IACjD,MAAM,SAAS,GAAG,QAAQ,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAA;IACrF,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,SAAS;QAAE,MAAM,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,QAAQ,CAAC,CAAA;IAC/F,KAAK,MAAM,IAAI,IAAI,CAAC,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,QAAQ,CAAC;QAC/E,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACzD,KAAK,MAAM,EAAE,SAAS,EAAE,IAAI,SAAS;QACjC,KAAK,MAAM,MAAM,IAAI;YACjB,UAAU;YACV,aAAa;YACb,YAAY;YACZ,UAAU;YACV,WAAW;YACX,QAAQ;YACR,eAAe;YACf,iBAAiB;YACjB,qBAAqB;YACrB,uBAAuB;SAC1B;YACG,MAAM,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,SAAS,IAAI,MAAM,EAAE,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;AACrF,CAAC;AAED,OAAO,EAAE,cAAc,EAAE,CAAA"}

package/dist/compiler/generators/typescript-generator.d.ts

@@ -0,0 +1,8 @@
+import type { SocketContract } from "../../wire/contract.js";
+import type { PublicActorContract } from "../../wire/public-contract.js";
+/** Returns generated filenames and TypeScript source without writing files or executing actor code. */
+declare function generateTypeScript(input: readonly SocketContract[] | PublicActorContract): Promise<ReadonlyMap<string, string>>;
+export { generateTypeScript };
+export type { SocketContract };
+export type { PublicActorContract };
+//# sourceMappingURL=typescript-generator.d.ts.map

package/dist/compiler/generators/typescript-generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typescript-generator.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/typescript-generator.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAA;AAC5D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAA;AAMxE,uGAAuG;AACvG,iBAAe,kBAAkB,CAC7B,KAAK,EAAE,SAAS,cAAc,EAAE,GAAG,mBAAmB,GACvD,OAAO,CAAC,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAmCtC;AA6ID,OAAO,EAAE,kBAAkB,EAAE,CAAA;AAC7B,YAAY,EAAE,cAAc,EAAE,CAAA;AAC9B,YAAY,EAAE,mBAAmB,EAAE,CAAA"}

package/dist/compiler/generators/typescript-generator.js

@@ -0,0 +1,154 @@
+import { compile } from "json-schema-to-typescript";
+import { format } from "prettier";
+import ts from "typescript";
+import { parsePublicContract } from "../validate-public-contract.js";
+import { backendSource } from "./backend-generator.js";
+import { usageComment } from "./usage-comment.js";
+/** Returns generated filenames and TypeScript source without writing files or executing actor code. */
+async function generateTypeScript(input) {
+    const document = "actors" in input ? input : undefined;
+    if (document && document.version !== 1)
+        throw new Error(`unsupported public actor contract version ${document.version}`);
+    if (document)
+        parsePublicContract(document);
+    const contracts = "actors" in input ? input.actors.map(actor => actor.socket) : input;
+    const declarations = [];
+    const wireNames = new Map();
+    for (const contract of contracts) {
+        if (!/^[A-Za-z_$][\w$]*$/u.test(contract.actorName))
+            throw new Error(`actor name ${contract.actorName} cannot be emitted as a TypeScript identifier`);
+        const wire = await wireDeclarations(contract);
+        wireNames.set(contract.actorName, [...wire.names, "Authorization"]);
+        declarations.push(actorDeclarations(contract, wire.code));
+    }
+    const exampleActor = contracts[0]?.actorName;
+    const source = `// Generated by durable-actors; regenerate instead of editing.
+${usageComment("Use this file to call actors and prepare WebSocket access from your backend.", 'import { actors, ActorProxy, type ActorAuthorization } from "./generated/index.js"')}
+import { createActorStub as $createActorStub, SocketProxy as $SocketProxy } from "durable-actors/generated"
+
+${usageComment("Types for actor state and socket messages.", exampleActor && `type State = actors.${exampleActor}.State`)}
+export declare namespace actors {
+${declarations.join("\n")}
+}
+
+${await backendSource(document?.actors ?? [], contracts, wireNames)}
+${proxySource(contracts)}`;
+    const formatted = await format(source, {
+        parser: "typescript",
+        tabWidth: 4,
+        printWidth: 120,
+        semi: false,
+        trailingComma: "none"
+    });
+    return new Map([["index.ts", formatted]]);
+}
+function actorDeclarations(contract, declarations) {
+    return `export namespace ${contract.actorName} {
+${declarations}
+export interface Authorization {
+    actorName: ${JSON.stringify(contract.actorName)}
+    actorId: string
+    metadata: Metadata
+    clientLocation?: { latitude: number; longitude: number }
+    authorizationLifetimeMs?: number
+}
+}`;
+}
+async function wireDeclarations(contract) {
+    const kinds = ["Metadata", "Incoming", "Outgoing", "State"];
+    const properties = Object.fromEntries(kinds.map(kind => [
+        kind.toLowerCase(),
+        typeof contract.schema.definitions?.[kind] === "boolean"
+            ? contract.schema.definitions[kind]
+            : { $ref: `#/definitions/${kind}` }
+    ]));
+    const code = await compile(inlineAnonymousReferences({
+        ...contract.schema,
+        type: "object",
+        additionalProperties: false,
+        properties,
+        required: Object.keys(properties)
+    }, contract.schema.definitions ?? {}), "ActorTypes", {
+        $refOptions: { resolve: { file: false, http: false } },
+        bannerComment: "",
+        unknownAny: true,
+        additionalProperties: false,
+        customName: (schema, key) => {
+            const name = schema.title || schema.$id || key;
+            return (schema.title && kinds.includes(name)) ||
+                ["Connection", "Authorization", "Methods", "Parameters", "ReturnType", "Awaited"].includes(name)
+                ? `${name}Data`
+                : undefined;
+        }
+    });
+    const source = ts.createSourceFile("types.ts", code, ts.ScriptTarget.Latest, true);
+    const root = source.statements.find(statement => ts.isInterfaceDeclaration(statement) && statement.name.text === "ActorTypes");
+    const declarations = source.statements.filter(statement => statement !== root);
+    const named = new Map(declarations
+        .filter((statement) => ts.isInterfaceDeclaration(statement) || ts.isTypeAliasDeclaration(statement))
+        .map(statement => [statement.name.text, statement]));
+    const main = kinds.map(kind => {
+        const declaration = named.get(kind);
+        if (declaration)
+            return declaration.getText(source);
+        const property = root.members.find(member => ts.isPropertySignature(member) && member.name.getText(source) === kind.toLowerCase());
+        return `export type ${kind} = ${property.type.getText(source)}`;
+    });
+    const helpers = declarations.filter(statement => !kinds.some(kind => named.get(kind) === statement));
+    return {
+        code: [...main, ...helpers.map(statement => statement.getText(source))].join("\n\n") + "\n",
+        names: [...new Set([...kinds, ...named.keys()])]
+    };
+}
+function inlineAnonymousReferences(value, definitions, visiting = new Set()) {
+    if (Array.isArray(value))
+        return value.map(item => inlineAnonymousReferences(item, definitions, visiting));
+    if (!value || typeof value !== "object")
+        return value;
+    const node = value;
+    const key = typeof node.$ref === "string" && node.$ref.startsWith("#/definitions/")
+        ? decodeURIComponent(node.$ref.slice("#/definitions/".length)).replaceAll("~1", "/").replaceAll("~0", "~")
+        : undefined;
+    const definition = key === undefined ? undefined : definitions[key];
+    if (key !== undefined &&
+        definition &&
+        typeof definition === "object" &&
+        !definition.title &&
+        !visiting.has(key) &&
+        (/^(Type\d+|Field_.*)$/.test(key) ||
+            (typeof definition.type === "string" &&
+                ["string", "number", "integer", "boolean", "null"].includes(definition.type)))) {
+        const { $ref, ...rest } = node;
+        return inlineAnonymousReferences({ ...definition, ...rest }, definitions, new Set([...visiting, key]));
+    }
+    return Object.fromEntries(Object.entries(node).map(([key, child]) => [key, inlineAnonymousReferences(child, definitions, visiting)]));
+}
+function proxySource(contracts) {
+    const actors = contracts
+        .map(({ actorName }) => `[${JSON.stringify(actorName)}]: {} as import("durable-actors/proxy").ProxyActor<actors.${actorName}.Metadata>`)
+        .join(", ");
+    const authorization = contracts.map(({ actorName }) => `actors.${actorName}.Authorization`).join(" | ") || "never";
+    const exampleActor = contracts[0]?.actorName;
+    return `${usageComment("The actor and connection details approved by your backend.", exampleActor && `const authorization: ActorAuthorization = { actorName: ${JSON.stringify(exampleActor)}, actorId: "actor-id", metadata }`)}
+export type ActorAuthorization = ${authorization}
+
+${usageComment("Allow a frontend connection after your backend checks the user's access.", exampleActor && `const grant = await ActorProxy.handle({ actorName: ${JSON.stringify(exampleActor)}, actorId: "actor-id", metadata })`)}
+export class ActorProxy extends $SocketProxy<{
+${contracts.map(({ actorName }) => `[${JSON.stringify(actorName)}]: import("durable-actors/proxy").ProxyActor<actors.${actorName}.Metadata>`).join("\n")}
+}> {
+    constructor(options: import("durable-actors/proxy").SocketProxyOptions = {}, dependencies: import("durable-actors/proxy").SocketProxyDependencies = {}) {
+        super({ ${actors} }, options, dependencies)
+    }
+
+    handle(authorization: ActorAuthorization): Promise<import("durable-actors/proxy").SocketGrant> {
+        return super.handle(authorization)
+    }
+
+    static handle(authorization: ActorAuthorization, options: import("durable-actors/proxy").SocketProxyOptions = {}): Promise<import("durable-actors/proxy").SocketGrant> {
+        return new ActorProxy(options).handle(authorization)
+    }
+}
+`;
+}
+export { generateTypeScript };
+//# sourceMappingURL=typescript-generator.js.map

package/dist/compiler/generators/typescript-generator.js.map

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

package/dist/compiler/generators/usage-comment.d.ts

@@ -0,0 +1,3 @@
+declare function usageComment(description: string, example?: string): string;
+export { usageComment };
+//# sourceMappingURL=usage-comment.d.ts.map

package/dist/compiler/generators/usage-comment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage-comment.d.ts","sourceRoot":"","sources":["../../../src/compiler/generators/usage-comment.ts"],"names":[],"mappings":"AAAA,iBAAS,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,CAGnE;AAED,OAAO,EAAE,YAAY,EAAE,CAAA"}

package/dist/compiler/generators/usage-comment.js

@@ -0,0 +1,6 @@
+function usageComment(description, example) {
+    const lines = [description, ...(example ? ["@example", ...example.split("\n")] : [])];
+    return `/**\n${lines.map(line => ` * ${line.replaceAll("*/", "*\\/")}`).join("\n")}\n */`;
+}
+export { usageComment };
+//# sourceMappingURL=usage-comment.js.map