joist-codegen 2.3.0-next.9 → 2.3.0-next.91

package/build/docs/parsing.d.mts

@@ -0,0 +1,48 @@
+import { ASTNode } from "jscodeshift";
+import { namedTypes } from "ast-types";
+//#region src/docs/parsing.d.ts
+type CommentKind = (namedTypes.CommentBlock | namedTypes.CommentLine | namedTypes.Block | namedTypes.Line) & {
+  start?: number;
+  end?: number;
+};
+type Commented = ASTNode & {
+  comments?: CommentKind[] | null;
+  start?: number;
+  end?: number;
+  loc?: namedTypes.SourceLocation | null;
+};
+type MemberKind = "property" | "getter" | "setter" | "method";
+interface MemberInfo {
+  kind: MemberKind;
+  name: string;
+  doc: string | undefined;
+  node: Commented;
+}
+interface SourceEdit {
+  start: number;
+  end: number;
+  text: string;
+}
+/** Parse an entity .ts file and extract class + member JSDoc. */
+declare function parseEntityJSDocs(source: string): {
+  classDoc: string | undefined;
+  classNode: Commented | undefined;
+  members: MemberInfo[];
+  fieldDocs: Record<string, string>;
+};
+/**
+ * Build a source edit that sets the JSDoc on a node (replacing existing or inserting new).
+ *
+ * (This is bizarre, but this `SourceEdit` + `applyEdits` leaves all existing formatting
+ * alone better than doing a `node.toSource()` or other AST-based updates. :grimmacing:)
+ */
+declare function buildJSDocEdit(node: Commented, text: string): SourceEdit;
+/** Apply edits to source by splicing in reverse order. */
+declare function applyEdits(source: string, edits: SourceEdit[]): string;
+/** Build a JSDoc block comment string from plain text. */
+declare function buildJSDocBlock(text: string, indent: number): string;
+/** The `@generated Entity.md` marker, i.e. so readers know a JSDoc is sourced from (and edited in) the `.md`. */
+declare function generatedTag(entityName: string): string;
+//#endregion
+export { MemberInfo, MemberKind, SourceEdit, applyEdits, buildJSDocBlock, buildJSDocEdit, generatedTag, parseEntityJSDocs };
+//# sourceMappingURL=parsing.d.mts.map

package/build/docs/parsing.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsing.d.mts","names":[],"sources":["../../src/docs/parsing.ts"],"mappings":";;;KAKK,eAAe,WAAW,eAAe,WAAW,cAAc,WAAW,QAAQ,WAAW;EACnG;EACA;;KAGG,YAAY;EACf,WAAW;EACX;EACA;EACA,MAAM,WAAW;;KAGP;UAEK;EACf,MAAM;EACN;EACA;EACA,MAAM;;UAGS;EACf;EACA;EACA;;;iBAIc,kBAAkB;;;;;;;;;;;;iBAuDlB,eAAe,MAAM,WAAW,eAAe;;iBAW/C,WAAW,gBAAgB,OAAO;;iBAUlC,gBAAgB,cAAc;;iBAQ9B,aAAa"}

package/build/docs/parsing.js

@@ -1,109 +1,110 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseEntityJSDocs = parseEntityJSDocs;
-exports.buildJSDocEdit = buildJSDocEdit;
-exports.applyEdits = applyEdits;
-const jscodeshift_1 = __importDefault(require("jscodeshift"));
-const j = jscodeshift_1.default.withParser("ts");
-j;
+import jscodeshift from "jscodeshift";
+//#region src/docs/parsing.ts
+const j = jscodeshift.withParser("ts");
 /** Parse an entity .ts file and extract class + member JSDoc. */
 function parseEntityJSDocs(source) {
-    const root = j(source);
-    let classDoc;
-    let classNode;
-    const members = [];
-    root.find(j.ExportNamedDeclaration).forEach((p) => {
-        if (p.node.declaration?.type === "ClassDeclaration") {
-            classDoc = extractJSDoc(p.node);
-            classNode = p.node;
-        }
-    });
-    root.find(j.ClassProperty).forEach((p) => {
-        const name = p.node.key?.name;
-        if (name) {
-            members.push({ name, kind: "property", doc: extractJSDoc(p.node), node: p.node });
-        }
-    });
-    root.find(j.ClassMethod).forEach((p) => {
-        const name = p.node.key?.name;
-        if (name) {
-            members.push({
-                name,
-                kind: classMethodKind(p.node),
-                doc: extractJSDoc(p.node),
-                node: p.node,
-            });
-        }
-    });
-    return { classDoc, classNode, members, fieldDocs: collectFieldDocs(members) };
+	const root = j(source);
+	let classDoc;
+	let classNode;
+	const members = [];
+	root.find(j.ExportNamedDeclaration).forEach((p) => {
+		if (p.node.declaration?.type === "ClassDeclaration") {
+			classDoc = extractJSDoc(p.node);
+			classNode = p.node;
+		}
+	});
+	root.find(j.ClassProperty).forEach((p) => {
+		const name = p.node.key?.name;
+		if (name) members.push({
+			name,
+			kind: "property",
+			doc: extractJSDoc(p.node),
+			node: p.node
+		});
+	});
+	root.find(j.ClassMethod).forEach((p) => {
+		const name = p.node.key?.name;
+		if (name) members.push({
+			name,
+			kind: classMethodKind(p.node),
+			doc: extractJSDoc(p.node),
+			node: p.node
+		});
+	});
+	return {
+		classDoc,
+		classNode,
+		members,
+		fieldDocs: collectFieldDocs(members)
+	};
 }
 /**
- * Collect field docs from members for backfill.
- * When a getter and setter share the same name, prefer the getter's doc.
- */
+* Collect field docs from members for backfill.
+* When a getter and setter share the same name, prefer the getter's doc.
+*/
 function collectFieldDocs(members) {
-    const result = {};
-    for (const m of members) {
-        if (!m.doc || m.kind === "method")
-            continue;
-        if (result[m.name] && m.kind === "setter")
-            continue;
-        result[m.name] = m.doc;
-    }
-    return result;
+	const result = {};
+	for (const m of members) {
+		if (!m.doc || m.kind === "method") continue;
+		if (result[m.name] && m.kind === "setter") continue;
+		result[m.name] = m.doc;
+	}
+	return result;
 }
 /**
- * Build a source edit that sets the JSDoc on a node (replacing existing or inserting new).
- *
- * (This is bizarre, but this `SourceEdit` + `applyEdits` leaves all existing formatting
- * alone better than doing a `node.toSource()` or other AST-based updates. :grimmacing:)
- */
+* Build a source edit that sets the JSDoc on a node (replacing existing or inserting new).
+*
+* (This is bizarre, but this `SourceEdit` + `applyEdits` leaves all existing formatting
+* alone better than doing a `node.toSource()` or other AST-based updates. :grimmacing:)
+*/
 function buildJSDocEdit(node, text) {
-    const column = node.loc.start.column;
-    const existingComment = node.comments?.find((c) => c.leading && "value" in c && c.value.startsWith("*"));
-    if (existingComment) {
-        return { start: existingComment.start, end: existingComment.end, text: buildJSDocBlock(text, column) };
-    }
-    const indent = " ".repeat(column);
-    return { start: node.start, end: node.start, text: buildJSDocBlock(text, column) + "\n" + indent };
+	const column = node.loc.start.column;
+	const existingComment = node.comments?.find((c) => c.leading && "value" in c && c.value.startsWith("*"));
+	if (existingComment) return {
+		start: existingComment.start,
+		end: existingComment.end,
+		text: buildJSDocBlock(text, column)
+	};
+	const indent = " ".repeat(column);
+	return {
+		start: node.start,
+		end: node.start,
+		text: buildJSDocBlock(text, column) + "\n" + indent
+	};
 }
 /** Apply edits to source by splicing in reverse order. */
 function applyEdits(source, edits) {
-    const sorted = [...edits].sort((a, b) => b.start - a.start);
-    let result = source;
-    for (const edit of sorted) {
-        result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
-    }
-    return result;
+	const sorted = [...edits].sort((a, b) => b.start - a.start);
+	let result = source;
+	for (const edit of sorted) result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);
+	return result;
 }
 /** Build a JSDoc block comment string from plain text. */
 function buildJSDocBlock(text, indent) {
-    const pad = " ".repeat(indent);
-    const lines = text.split("\n");
-    if (lines.length === 1)
-        return `/** ${lines[0]} */`;
-    return `/**\n` + lines.map((l) => (l ? `${pad} * ${l}` : `${pad} *`)).join("\n") + `\n${pad} */`;
+	const pad = " ".repeat(indent);
+	const lines = text.split("\n");
+	if (lines.length === 1) return `/** ${lines[0]} */`;
+	return `/**\n` + lines.map((l) => l ? `${pad} * ${l}` : `${pad} *`).join("\n") + `\n${pad} */`;
+}
+/** The `@generated Entity.md` marker, i.e. so readers know a JSDoc is sourced from (and edited in) the `.md`. */
+function generatedTag(entityName) {
+	return `@generated ${entityName}.md`;
 }
 /** Extract text from a JSDoc-style leading block comment (i.e. one starting with `*`). */
 function extractJSDoc(node) {
-    const block = node.comments?.find((c) => c.leading && "value" in c && c.value.startsWith("*"));
-    if (!block || !("value" in block))
-        return undefined;
-    const lines = block.value.split("\n").map((l) => l.replace(/^\s*\*\s?/, "").trimEnd());
-    while (lines.length > 0 && lines[0].trim() === "")
-        lines.shift();
-    while (lines.length > 0 && lines[lines.length - 1].trim() === "")
-        lines.pop();
-    return lines.join("\n") || undefined;
+	const block = node.comments?.find((c) => c.leading && "value" in c && c.value.startsWith("*"));
+	if (!block || !("value" in block)) return void 0;
+	const lines = block.value.split("\n").map((l) => l.replace(/^\s*\*\s?/, "").trimEnd());
+	while (lines.length > 0 && lines[0].trim() === "") lines.shift();
+	while (lines.length > 0 && lines[lines.length - 1].trim() === "") lines.pop();
+	return lines.join("\n") || void 0;
 }
 function classMethodKind(node) {
-    if (node.kind === "get")
-        return "getter";
-    if (node.kind === "set")
-        return "setter";
-    return "method";
+	if (node.kind === "get") return "getter";
+	if (node.kind === "set") return "setter";
+	return "method";
 }
+//#endregion
+export { applyEdits, buildJSDocBlock, buildJSDocEdit, generatedTag, parseEntityJSDocs };
+
 //# sourceMappingURL=parsing.js.map

package/build/docs/parsing.js.map

@@ -1 +1 @@
-{"version":3,"file":"parsing.js","sourceRoot":"","sources":["../../src/docs/parsing.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"parsing.js","names":[],"sources":["../../src/docs/parsing.ts"],"sourcesContent":["import type { namedTypes } from \"ast-types\";\nimport jscodeshift, { type ASTNode } from \"jscodeshift\";\n\nconst j = jscodeshift.withParser(\"ts\");\n\ntype CommentKind = (namedTypes.CommentBlock | namedTypes.CommentLine | namedTypes.Block | namedTypes.Line) & {\n  start?: number;\n  end?: number;\n};\nj;\ntype Commented = ASTNode & {\n  comments?: CommentKind[] | null;\n  start?: number;\n  end?: number;\n  loc?: namedTypes.SourceLocation | null;\n};\n\nexport type MemberKind = \"property\" | \"getter\" | \"setter\" | \"method\";\n\nexport interface MemberInfo {\n  kind: MemberKind;\n  name: string;\n  doc: string | undefined;\n  node: Commented;\n}\n\nexport interface SourceEdit {\n  start: number;\n  end: number;\n  text: string;\n}\n\n/** Parse an entity .ts file and extract class + member JSDoc. */\nexport function parseEntityJSDocs(source: string) {\n  const root = j(source);\n  let classDoc: string | undefined;\n  let classNode: Commented | undefined;\n  const members: MemberInfo[] = [];\n\n  root.find(j.ExportNamedDeclaration).forEach((p) => {\n    if (p.node.declaration?.type === \"ClassDeclaration\") {\n      classDoc = extractJSDoc(p.node as Commented);\n      classNode = p.node as Commented;\n    }\n  });\n\n  root.find(j.ClassProperty).forEach((p) => {\n    const name = (p.node.key as namedTypes.Identifier)?.name;\n    if (name) {\n      members.push({ name, kind: \"property\", doc: extractJSDoc(p.node as Commented), node: p.node as Commented });\n    }\n  });\n\n  root.find(j.ClassMethod).forEach((p) => {\n    const name = (p.node.key as namedTypes.Identifier)?.name;\n    if (name) {\n      members.push({\n        name,\n        kind: classMethodKind(p.node),\n        doc: extractJSDoc(p.node as Commented),\n        node: p.node as Commented,\n      });\n    }\n  });\n\n  return { classDoc, classNode, members, fieldDocs: collectFieldDocs(members) };\n}\n\n/**\n * Collect field docs from members for backfill.\n * When a getter and setter share the same name, prefer the getter's doc.\n */\nfunction collectFieldDocs(members: MemberInfo[]): Record<string, string> {\n  const result: Record<string, string> = {};\n  for (const m of members) {\n    if (!m.doc || m.kind === \"method\") continue;\n    if (result[m.name] && m.kind === \"setter\") continue;\n    result[m.name] = m.doc;\n  }\n  return result;\n}\n\n/**\n * Build a source edit that sets the JSDoc on a node (replacing existing or inserting new).\n *\n * (This is bizarre, but this `SourceEdit` + `applyEdits` leaves all existing formatting\n * alone better than doing a `node.toSource()` or other AST-based updates. :grimmacing:)\n */\nexport function buildJSDocEdit(node: Commented, text: string): SourceEdit {\n  const column = node.loc!.start.column;\n  const existingComment = node.comments?.find((c) => c.leading && \"value\" in c && c.value.startsWith(\"*\"));\n  if (existingComment) {\n    return { start: existingComment.start!, end: existingComment.end!, text: buildJSDocBlock(text, column) };\n  }\n  const indent = \" \".repeat(column);\n  return { start: node.start!, end: node.start!, text: buildJSDocBlock(text, column) + \"\\n\" + indent };\n}\n\n/** Apply edits to source by splicing in reverse order. */\nexport function applyEdits(source: string, edits: SourceEdit[]): string {\n  const sorted = [...edits].sort((a, b) => b.start - a.start);\n  let result = source;\n  for (const edit of sorted) {\n    result = result.slice(0, edit.start) + edit.text + result.slice(edit.end);\n  }\n  return result;\n}\n\n/** Build a JSDoc block comment string from plain text. */\nexport function buildJSDocBlock(text: string, indent: number): string {\n  const pad = \" \".repeat(indent);\n  const lines = text.split(\"\\n\");\n  if (lines.length === 1) return `/** ${lines[0]} */`;\n  return `/**\\n` + lines.map((l) => (l ? `${pad} * ${l}` : `${pad} *`)).join(\"\\n\") + `\\n${pad} */`;\n}\n\n/** The `@generated Entity.md` marker, i.e. so readers know a JSDoc is sourced from (and edited in) the `.md`. */\nexport function generatedTag(entityName: string): string {\n  return `@generated ${entityName}.md`;\n}\n\n/** Extract text from a JSDoc-style leading block comment (i.e. one starting with `*`). */\nfunction extractJSDoc(node: Commented): string | undefined {\n  const block = node.comments?.find((c) => c.leading && \"value\" in c && c.value.startsWith(\"*\"));\n  if (!block || !(\"value\" in block)) return undefined;\n  const lines = block.value.split(\"\\n\").map((l) => l.replace(/^\\s*\\*\\s?/, \"\").trimEnd());\n  while (lines.length > 0 && lines[0].trim() === \"\") lines.shift();\n  while (lines.length > 0 && lines[lines.length - 1].trim() === \"\") lines.pop();\n  return lines.join(\"\\n\") || undefined;\n}\n\nfunction classMethodKind(node: namedTypes.ClassMethod): MemberKind {\n  if (node.kind === \"get\") return \"getter\";\n  if (node.kind === \"set\") return \"setter\";\n  return \"method\";\n}\n"],"mappings":"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"}

package/build/findEntityScopes.cjs

@@ -0,0 +1,119 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_runtime = require("./_virtual/_rolldown/runtime.cjs");
+require("./config.cjs");
+require("./EntityDbMetadata.cjs");
+let change_case = require("change-case");
+let path = require("path");
+let jscodeshift = require("jscodeshift");
+jscodeshift = require_runtime.__toESM(jscodeshift, 1);
+let fs_promises = require("fs/promises");
+require("ast-types");
+//#region src/findEntityScopes.ts
+const j = jscodeshift.default.withParser("ts");
+/** Finds static scope declarations for all entity files. */
+async function findAllEntityScopes(config, entities) {
+	return Object.fromEntries(await Promise.all(entities.map((entity) => findEntityScopes(config, entity))));
+}
+/** Finds static scope declarations a given entity file. */
+async function findEntityScopes(config, entity) {
+	const { name: entityName, scopeName: scopeTypeName } = entity;
+	const scopeFnName = `${(0, change_case.camelCase)(entityName)}Scope`;
+	const contents = await readEntityFile((0, path.join)(config.entitiesDirectory, `${entityName}.ts`));
+	if (contents === void 0) return [entityName, []];
+	if (contents.indexOf(scopeFnName) === -1) return [entityName, []];
+	const program = j(contents).find(j.Program).nodes()[0];
+	for (const statement of program.body) {
+		const declaration = j.ExportNamedDeclaration.check(statement) || j.ExportDefaultDeclaration.check(statement) ? statement.declaration : statement;
+		if (declaration && j.ClassDeclaration.check(declaration) && declaration.id?.name === entityName) return [entityName, declaration.body.body.flatMap((member) => maybeScopeMember(member, entityName, scopeTypeName))];
+	}
+	return [entityName, []];
+}
+/** Reads an entity file if it already exists. */
+async function readEntityFile(fileName) {
+	try {
+		return await (0, fs_promises.readFile)(fileName, "utf8");
+	} catch (e) {
+		if (isNoSuchFileError(e)) return void 0;
+		throw e;
+	}
+}
+/** Returns true for a missing user-owned entity file. */
+function isNoSuchFileError(e) {
+	return typeof e === "object" && e !== null && "code" in e && e.code === "ENOENT";
+}
+/** Converts a static property declaration into a generated scope member. */
+function maybeScopeMember(member, entityName, scopeTypeName) {
+	if (!j.ClassProperty.check(member) || !member.static) return [];
+	if (!member.value || !j.Identifier.check(member.key)) return [];
+	if (!isScopeInitializer(member.value, entityName)) return [];
+	if (member.typeAnnotation) {
+		if (!j.TSTypeAnnotation.check(member.typeAnnotation)) return [];
+		const type = member.typeAnnotation.typeAnnotation;
+		if (!isScopeType(type, scopeTypeName)) return [];
+		return [{
+			name: member.key.name,
+			type: j(type).toSource()
+		}];
+	}
+	const type = inferScopeType(member.value, scopeTypeName);
+	return type ? [{
+		name: member.key.name,
+		type
+	}] : [];
+}
+/** Infers a generated scope member type from an untyped static scope initializer. */
+function inferScopeType(initializer, scopeTypeName) {
+	return isParameterizedScopeInitializer(initializer) ? maybeParameterizedScope(initializer, scopeTypeName) : scopeTypeName;
+}
+/** Returns true for `scope.fn(...)` initializers. */
+function isParameterizedScopeInitializer(initializer) {
+	return j.CallExpression.check(initializer) && j.MemberExpression.check(initializer.callee) && !initializer.callee.computed && j.Identifier.check(initializer.callee.property) && initializer.callee.property.name === "fn";
+}
+/** Returns a function type for `scope.fn((prefix: string) => ...)` initializers. */
+function maybeParameterizedScope(initializer, scopeTypeName) {
+	if (!j.CallExpression.check(initializer)) return void 0;
+	if (!j.MemberExpression.check(initializer.callee)) return void 0;
+	if (initializer.callee.computed || !j.Identifier.check(initializer.callee.property)) return void 0;
+	if (initializer.callee.property.name !== "fn") return void 0;
+	const fn = initializer.arguments[0];
+	if (!fn || !j.ArrowFunctionExpression.check(fn) && !j.FunctionExpression.check(fn)) return void 0;
+	const params = fn.params.map(parameterType);
+	if (params.some((param) => param === void 0)) return void 0;
+	return `(${params.join(", ")}) => ${scopeTypeName}`;
+}
+/** Returns a function-type parameter, i.e. `prefix: string`, when syntax-only inference is safe. */
+function parameterType(param) {
+	if (j.Identifier.check(param)) {
+		if (!param.typeAnnotation || !j.TSTypeAnnotation.check(param.typeAnnotation)) return void 0;
+		const optional = param.optional ? "?" : "";
+		return `${param.name}${optional}: ${j(param.typeAnnotation.typeAnnotation).toSource()}`;
+	}
+	if (j.RestElement.check(param) && j.Identifier.check(param.argument)) {
+		const typeAnnotation = param.typeAnnotation ?? param.argument.typeAnnotation;
+		if (!typeAnnotation || !j.TSTypeAnnotation.check(typeAnnotation)) return void 0;
+		return `...${param.argument.name}: ${j(typeAnnotation.typeAnnotation).toSource()}`;
+	}
+}
+/** Returns true for `EntityScope` and function types returning `EntityScope`. */
+function isScopeType(type, scopeTypeName) {
+	if (j.TSTypeReference.check(type) && j.Identifier.check(type.typeName)) return type.typeName.name === scopeTypeName;
+	if (j.TSFunctionType.check(type) && type.typeAnnotation && j.TSTypeAnnotation.check(type.typeAnnotation)) return isScopeType(type.typeAnnotation.typeAnnotation, scopeTypeName);
+	if (j.TSParenthesizedType.check(type)) return isScopeType(type.typeAnnotation, scopeTypeName);
+	return false;
+}
+/** Returns true for scope initializers, I.e. `scope(...)`, `scope(...).orderBy(...)`, or `Author.adult...`. */
+function isScopeInitializer(initializer, entityName) {
+	if (!j.CallExpression.check(initializer) && !j.MemberExpression.check(initializer)) return false;
+	return isScopeRootedExpression(initializer, entityName);
+}
+/** Returns true for a call/property expression chain rooted at `scope` or the current entity. */
+function isScopeRootedExpression(expression, entityName) {
+	if (j.Identifier.check(expression)) return expression.name === "scope" || expression.name === entityName;
+	if (j.CallExpression.check(expression)) return isScopeRootedExpression(expression.callee, entityName);
+	if (j.MemberExpression.check(expression) && !expression.computed) return isScopeRootedExpression(expression.object, entityName);
+	return false;
+}
+//#endregion
+exports.findAllEntityScopes = findAllEntityScopes;
+
+//# sourceMappingURL=findEntityScopes.cjs.map

package/build/findEntityScopes.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"findEntityScopes.cjs","names":["camelCase","join","readFile"],"sources":["../src/findEntityScopes.ts"],"sourcesContent":["import { readFile } from \"fs/promises\";\nimport { join } from \"path\";\n\nimport { type namedTypes } from \"ast-types\";\nimport { camelCase } from \"change-case\";\nimport jscodeshift from \"jscodeshift\";\n\nimport { type Config } from \"./config.ts\";\nimport { type Entity } from \"./EntityDbMetadata.ts\";\n\nconst j = jscodeshift.withParser(\"ts\");\n\ntype Expression = NonNullable<namedTypes.ClassProperty[\"value\"]>;\ntype Parameter = namedTypes.ArrowFunctionExpression[\"params\"][number];\ntype TypeNode = namedTypes.TSTypeAnnotation[\"typeAnnotation\"];\n\n/** Each `static active = ...` scope in an entity. */\nexport interface ScopeMember {\n  // I.e. \"adult\" from `static adult: AuthorScope = scope(...)`.\n  name: string;\n  // I.e. \"AuthorScope\" or \"(prefix: string) => AuthorScope\".\n  type: string;\n}\n\nexport type ScopeMembersByEntity = Record<string, ScopeMember[]>;\n\n/** Finds static scope declarations for all entity files. */\nexport async function findAllEntityScopes(config: Config, entities: Entity[]): Promise<ScopeMembersByEntity> {\n  return Object.fromEntries(await Promise.all(entities.map((entity) => findEntityScopes(config, entity))));\n}\n\n/** Finds static scope declarations a given entity file. */\nasync function findEntityScopes(config: Config, entity: Entity): Promise<[string, ScopeMember[]]> {\n  const { name: entityName, scopeName: scopeTypeName } = entity;\n  // i.e. `authorScope`, the conventional renamed-to-`scope` import users put in their entity files.\n  const scopeFnName = `${camelCase(entityName)}Scope`;\n\n  // i.e. `packages/tests/integration/src/entities/Author.ts` when `entityName` is \"Author\".\n  const fileName = join(config.entitiesDirectory, `${entityName}.ts`);\n  const contents = await readEntityFile(fileName);\n  if (contents === undefined) return [entityName, []];\n  if (contents.indexOf(scopeFnName) === -1) return [entityName, []];\n\n  const program = j(contents).find(j.Program).nodes()[0];\n  for (const statement of program.body) {\n    const declaration =\n      j.ExportNamedDeclaration.check(statement) || j.ExportDefaultDeclaration.check(statement)\n        ? statement.declaration\n        : statement;\n    // i.e. `export class Author extends AuthorCodegen { ... }`.\n    if (declaration && j.ClassDeclaration.check(declaration) && declaration.id?.name === entityName) {\n      return [\n        entityName,\n        declaration.body.body.flatMap((member) => maybeScopeMember(member, entityName, scopeTypeName)),\n      ];\n    }\n  }\n  return [entityName, []];\n}\n\n/** Reads an entity file if it already exists. */\nasync function readEntityFile(fileName: string): Promise<string | undefined> {\n  try {\n    return await readFile(fileName, \"utf8\");\n  } catch (e) {\n    if (isNoSuchFileError(e)) return undefined;\n    throw e;\n  }\n}\n\n/** Returns true for a missing user-owned entity file. */\nfunction isNoSuchFileError(e: unknown): boolean {\n  return typeof e === \"object\" && e !== null && \"code\" in e && e.code === \"ENOENT\";\n}\n\n/** Converts a static property declaration into a generated scope member. */\nfunction maybeScopeMember(member: namedTypes.Node, entityName: string, scopeTypeName: string): ScopeMember[] {\n  if (!j.ClassProperty.check(member) || !member.static) return [];\n  // i.e. accept `static adult = scope(...)`, but skip methods/getters/unsupported fields.\n  if (!member.value || !j.Identifier.check(member.key)) return [];\n  if (!isScopeInitializer(member.value, entityName)) return [];\n  if (member.typeAnnotation) {\n    if (!j.TSTypeAnnotation.check(member.typeAnnotation)) return [];\n    const type = member.typeAnnotation.typeAnnotation;\n    if (!isScopeType(type, scopeTypeName)) return [];\n    return [{ name: member.key.name, type: j(type).toSource() }];\n  }\n  const type = inferScopeType(member.value, scopeTypeName);\n  return type ? [{ name: member.key.name, type }] : [];\n}\n\n/** Infers a generated scope member type from an untyped static scope initializer. */\nfunction inferScopeType(initializer: Expression, scopeTypeName: string): string | undefined {\n  return isParameterizedScopeInitializer(initializer)\n    ? maybeParameterizedScope(initializer, scopeTypeName)\n    : scopeTypeName;\n}\n\n/** Returns true for `scope.fn(...)` initializers. */\nfunction isParameterizedScopeInitializer(initializer: Expression): boolean {\n  return (\n    j.CallExpression.check(initializer) &&\n    j.MemberExpression.check(initializer.callee) &&\n    !initializer.callee.computed &&\n    j.Identifier.check(initializer.callee.property) &&\n    initializer.callee.property.name === \"fn\"\n  );\n}\n\n/** Returns a function type for `scope.fn((prefix: string) => ...)` initializers. */\nfunction maybeParameterizedScope(initializer: Expression, scopeTypeName: string): string | undefined {\n  if (!j.CallExpression.check(initializer)) return undefined;\n  if (!j.MemberExpression.check(initializer.callee)) return undefined;\n  if (initializer.callee.computed || !j.Identifier.check(initializer.callee.property)) return undefined;\n  if (initializer.callee.property.name !== \"fn\") return undefined;\n  const fn = initializer.arguments[0];\n  if (!fn || (!j.ArrowFunctionExpression.check(fn) && !j.FunctionExpression.check(fn))) return undefined;\n  const params = fn.params.map(parameterType);\n  if (params.some((param) => param === undefined)) return undefined;\n  return `(${params.join(\", \")}) => ${scopeTypeName}`;\n}\n\n/** Returns a function-type parameter, i.e. `prefix: string`, when syntax-only inference is safe. */\nfunction parameterType(param: Parameter): string | undefined {\n  if (j.Identifier.check(param)) {\n    if (!param.typeAnnotation || !j.TSTypeAnnotation.check(param.typeAnnotation)) return undefined;\n    const optional = param.optional ? \"?\" : \"\";\n    return `${param.name}${optional}: ${j(param.typeAnnotation.typeAnnotation).toSource()}`;\n  }\n  if (j.RestElement.check(param) && j.Identifier.check(param.argument)) {\n    const typeAnnotation = param.typeAnnotation ?? param.argument.typeAnnotation;\n    if (!typeAnnotation || !j.TSTypeAnnotation.check(typeAnnotation)) return undefined;\n    return `...${param.argument.name}: ${j(typeAnnotation.typeAnnotation).toSource()}`;\n  }\n  return undefined;\n}\n\n/** Returns true for `EntityScope` and function types returning `EntityScope`. */\nfunction isScopeType(type: TypeNode, scopeTypeName: string): boolean {\n  // i.e. `AuthorScope`.\n  if (j.TSTypeReference.check(type) && j.Identifier.check(type.typeName)) return type.typeName.name === scopeTypeName;\n  // i.e. `(prefix: string) => AuthorScope`.\n  if (j.TSFunctionType.check(type) && type.typeAnnotation && j.TSTypeAnnotation.check(type.typeAnnotation)) {\n    return isScopeType(type.typeAnnotation.typeAnnotation, scopeTypeName);\n  }\n  if (j.TSParenthesizedType.check(type)) return isScopeType(type.typeAnnotation, scopeTypeName);\n  return false;\n}\n\n/** Returns true for scope initializers, I.e. `scope(...)`, `scope(...).orderBy(...)`, or `Author.adult...`. */\nfunction isScopeInitializer(initializer: Expression, entityName: string): boolean {\n  if (!j.CallExpression.check(initializer) && !j.MemberExpression.check(initializer)) return false;\n  return isScopeRootedExpression(initializer, entityName);\n}\n\n/** Returns true for a call/property expression chain rooted at `scope` or the current entity. */\nfunction isScopeRootedExpression(expression: Expression, entityName: string): boolean {\n  // i.e. `scope({ age: { gte: 18 } })`.\n  if (j.Identifier.check(expression)) return expression.name === \"scope\" || expression.name === entityName;\n  if (j.CallExpression.check(expression)) return isScopeRootedExpression(expression.callee, entityName);\n  // i.e. `scope.fn((prefix) => (a) => a.firstName.like(`${prefix}%`))` or `Author.adult.orderBy(...)`.\n  if (j.MemberExpression.check(expression) && !expression.computed) {\n    return isScopeRootedExpression(expression.object, entityName);\n  }\n  return false;\n}\n"],"mappings":"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"}

package/build/findEntityScopes.d.cts

@@ -0,0 +1,14 @@
+import { Config } from "./config.cjs";
+import { Entity } from "./EntityDbMetadata.cjs";
+//#region src/findEntityScopes.d.ts
+/** Each `static active = ...` scope in an entity. */
+interface ScopeMember {
+  name: string;
+  type: string;
+}
+type ScopeMembersByEntity = Record<string, ScopeMember[]>;
+/** Finds static scope declarations for all entity files. */
+declare function findAllEntityScopes(config: Config, entities: Entity[]): Promise<ScopeMembersByEntity>;
+//#endregion
+export { ScopeMember, ScopeMembersByEntity, findAllEntityScopes };
+//# sourceMappingURL=findEntityScopes.d.cts.map

package/build/findEntityScopes.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findEntityScopes.d.cts","names":[],"sources":["../src/findEntityScopes.ts"],"mappings":";;;;UAiBiB;EAEf;EAEA;;KAGU,uBAAuB,eAAe;;iBAG5B,oBAAoB,QAAQ,QAAQ,UAAU,WAAW,QAAQ"}

package/build/findEntityScopes.d.mts

@@ -0,0 +1,14 @@
+import { Config } from "./config.mjs";
+import { Entity } from "./EntityDbMetadata.mjs";
+//#region src/findEntityScopes.d.ts
+/** Each `static active = ...` scope in an entity. */
+interface ScopeMember {
+  name: string;
+  type: string;
+}
+type ScopeMembersByEntity = Record<string, ScopeMember[]>;
+/** Finds static scope declarations for all entity files. */
+declare function findAllEntityScopes(config: Config, entities: Entity[]): Promise<ScopeMembersByEntity>;
+//#endregion
+export { ScopeMember, ScopeMembersByEntity, findAllEntityScopes };
+//# sourceMappingURL=findEntityScopes.d.mts.map

package/build/findEntityScopes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"findEntityScopes.d.mts","names":[],"sources":["../src/findEntityScopes.ts"],"mappings":";;;;UAiBiB;EAEf;EAEA;;KAGU,uBAAuB,eAAe;;iBAG5B,oBAAoB,QAAQ,QAAQ,UAAU,WAAW,QAAQ"}