create-relkit 0.7.2 → 0.7.6

package/dist/project-discovery-artifacts.js

@@ -0,0 +1,107 @@
+/**
+ * Projects compiler-recognized descriptor syntax into scaffold artifact records.
+ * Shared layout paths supply service names; database/auth keep native capability
+ * metadata and ordinary modules remain excluded from descriptor registration.
+ */
+import { prefilterSources } from "@relkit/compiler";
+import { serviceSource, normalizeSourcePath } from "@relkit/contracts";
+import { readFactoryStringProperty } from "./source-edit.js";
+import { discoverDatabaseDetails } from "./project-discovery-database.js";
+import { serviceMembers } from "./project-discovery-members.js";
+/**
+ * Collects source-only artifacts after compiler layout validation.
+ * @param root - Canonical application root.
+ * @param modules - Complete unevaluated authored module inventory.
+ * @returns Static artifact/service records with accurate flat or grouped paths.
+ */
+export function collectProjectArtifacts(root, modules) {
+    const normalized = modules.map((module) => ({
+        ...module,
+        fileName: normalizeSourcePath(module.fileName, root),
+    }));
+    const candidates = prefilterSources(normalized, { projectRoot: root }).candidates;
+    const sourceByPath = new Map(normalized.map((module) => [module.fileName, module.text]));
+    const services = [];
+    const artifacts = [];
+    for (const candidate of candidates) {
+        const source = sourceByPath.get(candidate.fileName);
+        if (source === undefined)
+            throw new Error("Compiler returned an uninventoried source module.");
+        const domain = serviceSource(candidate.fileName)?.name;
+        for (const factory of candidate.facts.factoryBindings) {
+            const context = {
+                modules: normalized,
+                candidate,
+                factory,
+                source,
+                binding: factory.binding ?? fileBinding(candidate.fileName),
+                ...(domain === undefined ? {} : { domain }),
+            };
+            artifacts.push(artifactFor(context));
+            const service = serviceFor(context);
+            if (service)
+                services.push(service);
+        }
+    }
+    return { services, artifacts };
+}
+/**
+ * Projects one known factory without interpreting its runtime options.
+ * @param context - Compiler syntax, physical source and normalized binding evidence.
+ * @returns Artifact metadata used for identity/collision and renderer selection.
+ */
+function artifactFor(context) {
+    const { candidate, factory, source, binding, domain } = context;
+    const exported = [...candidate.facts.exports.entries()].find(([, entry]) => entry.binding === factory.binding || entry.factory === factory);
+    const id = factory.id === "explicit"
+        ? readFactoryStringProperty(source, candidate.fileName, factory.factory, "id", factory.factory === "definePrompt" || factory.factory === "defineConstants" ? 1 : 0)
+        : undefined;
+    return {
+        kind: factory.kind,
+        path: candidate.fileName,
+        binding,
+        ...(domain === undefined ? {} : { domain }),
+        ...(id === undefined ? {} : { id }),
+        factory: factory.factory,
+        exported: exported !== undefined,
+        ...(exported === undefined
+            ? {}
+            : { exportKind: exported[0] === "default" ? "default" : "named" }),
+        options: factory.options,
+    };
+}
+/**
+ * Preserves generic versus native database/auth service contracts.
+ * @param context - One statically recognized declaration and its owning service path.
+ * @returns Service metadata, or absence for nonservice declarations.
+ */
+function serviceFor(context) {
+    const { candidate, factory, source, modules, binding, domain } = context;
+    if (factory.kind !== "service" || domain === undefined)
+        return undefined;
+    let capability = "generic";
+    if (factory.factory === "defineDrizzleService")
+        capability = "database";
+    else if (factory.factory === "defineBetterAuthService")
+        capability = "auth";
+    const database = capability === "database"
+        ? discoverDatabaseDetails(modules, candidate.fileName, source)
+        : undefined;
+    return {
+        domain,
+        path: candidate.fileName,
+        binding,
+        capability,
+        ...(database ?? {}),
+        members: serviceMembers(candidate.facts.serviceMembers.filter((member) => member.service === factory.binding), source, candidate.fileName, factory.factory),
+    };
+}
+/**
+ * Preserves the conventional fallback binding for unnamed factory declarations.
+ * @param path - Physical module whose filename supplies a kebab-case stem.
+ * @returns Its camel-case stem or artifact when no filename was available.
+ */
+function fileBinding(path) {
+    return (path.split("/").at(-1)?.split(".")[0] ?? "artifact").replace(/-([a-z0-9])/g, (_, value) => value.toUpperCase());
+}
+//# sourceMappingURL=project-discovery-artifacts.js.map

package/dist/project-discovery-artifacts.js.map

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

package/dist/project-discovery-artifacts.types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Describes declaration-only scaffold artifact inputs and collected outputs.
+ * Compiler syntax facts provide factory identity; scaffold discovery retains
+ * exact physical source paths and does not import application modules.
+ */
+import type { AstPrefilterCandidate, AstSourceModule } from "@relkit/compiler";
+import type { DiscoveredArtifact, DiscoveredService } from "./project-discovery-types.js";
+/** One statically recognized descriptor factory and its source provenance. */
+export interface FactoryContext {
+    readonly modules: readonly AstSourceModule[];
+    readonly candidate: AstPrefilterCandidate;
+    readonly factory: AstPrefilterCandidate["facts"]["factoryBindings"][number];
+    readonly source: string;
+    readonly binding: string;
+    readonly domain?: string;
+}
+/** Static service and artifact records used by add planning. */
+export interface DiscoveredCollections {
+    readonly services: readonly DiscoveredService[];
+    readonly artifacts: readonly DiscoveredArtifact[];
+}
+//# sourceMappingURL=project-discovery-artifacts.types.d.ts.map

package/dist/project-discovery-artifacts.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery-artifacts.types.d.ts","sourceRoot":"","sources":["../src/project-discovery-artifacts.types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,qBAAqB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAE1F,8EAA8E;AAC9E,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,eAAe,EAAE,CAAC;IAC7C,QAAQ,CAAC,SAAS,EAAE,qBAAqB,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,qBAAqB,CAAC,OAAO,CAAC,CAAC,iBAAiB,CAAC,CAAC,MAAM,CAAC,CAAC;IAC5E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,gEAAgE;AAChE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;CACnD"}

package/dist/project-discovery-artifacts.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=project-discovery-artifacts.types.js.map

package/dist/project-discovery-artifacts.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery-artifacts.types.js","sourceRoot":"","sources":["../src/project-discovery-artifacts.types.ts"],"names":[],"mappings":""}

package/dist/project-discovery-facts.d.ts

@@ -1,13 +1,12 @@
+import { type AstSourceModule } from "@relkit/compiler";
 import type { ProjectDiscovery } from "./project-discovery-types.js";
 /**
- * Converts immutable source facts into discovery data without importing application modules.
- * @param root - Absolute project root.
- * @param appSource - Configuration source bytes.
- * @param modules - Sorted TypeScript source modules.
- * @returns Canonical service, artifact, profile and deployment facts.
+ * Converts authored syntax into layout-aware scaffold discovery records.
+ * @param root - Absolute application root.
+ * @param appSource - Unevaluated configuration source.
+ * @param modules - Complete sorted authored TypeScript source collection.
+ * @returns Immutable service, artifact, provider and layout interpretation.
+ * @throws AddScaffoldError when mixed/invalid service roots make mutation unsafe.
  */
-export declare function discoveryFacts(root: string, appSource: string, modules: readonly {
-    readonly fileName: string;
-    readonly text: string;
-}[]): ProjectDiscovery;
+export declare function discoveryFacts(root: string, appSource: string, modules: readonly AstSourceModule[]): ProjectDiscovery;
 //# sourceMappingURL=project-discovery-facts.d.ts.map

package/dist/project-discovery-facts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-discovery-facts.d.ts","sourceRoot":"","sources":["../src/project-discovery-facts.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAGV,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAKtC;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS;IAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,GACvE,gBAAgB,CAmFlB"}
+{"version":3,"file":"project-discovery-facts.d.ts","sourceRoot":"","sources":["../src/project-discovery-facts.ts"],"names":[],"mappings":"AAMA,OAAO,EAA6B,KAAK,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAEnF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAKrE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,gBAAgB,CA0BlB"}

package/dist/project-discovery-facts.js

@@ -1,147 +1,49 @@
+/**
+ * Assembles declaration-only application discovery after compiler layout validation.
+ * The result keeps native specialized service metadata, actual boundaries and
+ * provider declarations; no user module or live client is imported.
+ */
 import { join } from "node:path";
-import { prefilterSources } from "@relkit/compiler";
+import { discoverApplicationLayout } from "@relkit/compiler";
 import * as ts from "typescript";
 import { readAppDiscovery } from "./project-discovery-app.js";
-import { discoverDatabaseDetails } from "./project-discovery-database.js";
-import { readFactoryObject, readFactoryStringProperty, staticPropertyName } from "./source-edit.js";
+import { collectProjectArtifacts } from "./project-discovery-artifacts.js";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
 /**
- * Converts immutable source facts into discovery data without importing application modules.
- * @param root - Absolute project root.
- * @param appSource - Configuration source bytes.
- * @param modules - Sorted TypeScript source modules.
- * @returns Canonical service, artifact, profile and deployment facts.
+ * Converts authored syntax into layout-aware scaffold discovery records.
+ * @param root - Absolute application root.
+ * @param appSource - Unevaluated configuration source.
+ * @param modules - Complete sorted authored TypeScript source collection.
+ * @returns Immutable service, artifact, provider and layout interpretation.
+ * @throws AddScaffoldError when mixed/invalid service roots make mutation unsafe.
  */
 export function discoveryFacts(root, appSource, modules) {
+    const layout = discoverApplicationLayout(modules, root);
+    if (layout.issues.length)
+        throw new AddScaffoldError(ADD_FAILURE_CODES.invalidProject, layout.issues.map((issue) => `${issue.file}: ${issue.message}`).join("\n"));
     const appPath = join(root, "relkit.config.ts");
-    const candidates = prefilterSources(modules, { projectRoot: root }).candidates;
-    const sourceByPath = new Map(modules.map((module) => [module.fileName, module.text]));
-    const services = [];
-    const artifacts = [];
-    for (const candidate of candidates) {
-        const domain = sourceDomain(candidate.fileName);
-        const source = sourceByPath.get(candidate.fileName);
-        // Compiler candidates are drawn only from the exact source module collection above.
-        if (source === undefined)
-            throw new Error("Compiler returned an unknown source module.");
-        for (const factory of candidate.facts.factoryBindings) {
-            const binding = factory.binding ?? fileBinding(candidate.fileName);
-            const exportedEntry = [...candidate.facts.exports.entries()].find(([, entry]) => entry.binding === factory.binding || entry.factory === factory);
-            const id = factory.id === "explicit"
-                ? readFactoryStringProperty(source, candidate.fileName, factory.factory, "id", factory.factory === "definePrompt" || factory.factory === "defineConstants" ? 1 : 0)
-                : undefined;
-            artifacts.push({
-                kind: factory.kind,
-                path: candidate.fileName,
-                binding,
-                ...(domain === undefined ? {} : { domain }),
-                ...(id === undefined ? {} : { id }),
-                factory: factory.factory,
-                exported: exportedEntry !== undefined,
-                ...(exportedEntry === undefined
-                    ? {}
-                    : {
-                        exportKind: exportedEntry[0] === "default" ? "default" : "named",
-                    }),
-                options: factory.options,
-            });
-            if (factory.kind !== "service" || domain === undefined)
-                continue;
-            const database = factory.factory === "defineDrizzleService"
-                ? discoverDatabaseDetails(modules, candidate.fileName, source)
-                : undefined;
-            services.push({
-                domain,
-                path: candidate.fileName,
-                binding,
-                capability: factory.factory === "defineDrizzleService"
-                    ? "database"
-                    : factory.factory === "defineBetterAuthService"
-                        ? "auth"
-                        : "generic",
-                ...(database ?? {}),
-                members: serviceMembers(candidate.facts.serviceMembers.filter((member) => member.service === factory.binding), source, candidate.fileName, factory.factory),
-            });
-        }
-    }
+    const { services, artifacts } = collectProjectArtifacts(root, modules);
     const app = readAppDiscovery(appSource, appPath, root);
     return Object.freeze({
         projectRoot: root,
+        layout,
         packagePath: join(root, "package.json"),
         appPath,
         appFactory: app.factory,
         ...(app.envPath === undefined ? {} : { envPath: app.envPath }),
         services: Object.freeze([...new Map(services.map((service) => [service.path, service])).values()].sort(byPath)),
-        artifacts: Object.freeze(artifacts.sort(byPath)),
+        artifacts: Object.freeze([...artifacts].sort(byPath)),
         profiles: Object.freeze(app.profiles),
         awsPulumiDeployment: importsPackage(appSource, appPath, "@relkit/aws") &&
             importsPackage(appSource, appPath, "@relkit/pulumi"),
     });
 }
 /**
- * Reads public service members from compiler facts or the supported AST fallback.
- * @param facts - Compiler member facts.
- * @param source - Owning module source.
- * @param path - Source module path.
- * @param factory - Service factory identifier.
- * @returns Declared public member bindings.
- */
-function serviceMembers(facts, source, path, factory) {
-    if (facts.length > 0)
-        return facts.map((member) => ({
-            name: member.member,
-            ...(member.targetBinding === undefined ? {} : { targetBinding: member.targetBinding }),
-        }));
-    const root = readFactoryObject(source, path, [factory]);
-    return ["functions", "events", "tasks", "jobs"].flatMap((category) => {
-        const item = root.properties.find((item) => staticPropertyName(item.name) === category);
-        if (!item || !ts.isPropertyAssignment(item))
-            return [];
-        const value = unwrap(item.initializer);
-        if (!value || !ts.isObjectLiteralExpression(value))
-            return [];
-        return value.properties.flatMap((member) => {
-            const name = staticPropertyName(member.name);
-            if (name === undefined)
-                return [];
-            const targetBinding = ts.isShorthandPropertyAssignment(member)
-                ? member.name.text
-                : ts.isPropertyAssignment(member) && ts.isIdentifier(member.initializer)
-                    ? member.initializer.text
-                    : undefined;
-            return [{ name, ...(targetBinding === undefined ? {} : { targetBinding }) }];
-        });
-    });
-}
-/**
- * Removes parentheses and TypeScript assertions from a source expression.
- * @param value - AST expression whose static wrapper nodes are ignored.
- * @returns The underlying expression, or undefined when no expression was supplied.
- */
-function unwrap(value) {
-    return value &&
-        (ts.isAsExpression(value) ||
-            ts.isSatisfiesExpression(value) ||
-            ts.isParenthesizedExpression(value))
-        ? unwrap(value.expression)
-        : value;
-}
-/**
- * Extracts a canonical domain from a source-relative path.
- * @param path - Path inside the current project or owned resource.
- * @returns The owning src domain, excluding routes/platform, or undefined outside a domain.
- */
-function sourceDomain(path) {
-    const [src, domain] = path.replaceAll("\\", "/").split("/");
-    return src === "src" && domain && domain !== "routes" && domain !== "platform"
-        ? domain
-        : undefined;
-}
-/**
- * Checks declaration-only imports for deployment ownership.
- * @param source - Authored source text inspected or transformed without execution.
- * @param path - Path inside the current project or owned resource.
- * @param packageName - Dependency name matched in static source imports.
- * @returns Whether source contains a static import for the named package.
+ * Checks explicit declaration imports used to recognize configured deployment roles.
+ * @param source - Unevaluated configuration module.
+ * @param path - Physical source filename used by TypeScript syntax parsing.
+ * @param packageName - Exact supported integration package to detect.
+ * @returns Whether the module contains its explicit static import.
  */
 function importsPackage(source, path, packageName) {
     return ts
@@ -151,18 +53,10 @@ function importsPackage(source, path, packageName) {
         statement.moduleSpecifier.text === packageName);
 }
 /**
- * Derives the existing fallback binding from a module filename.
- * @param path - Path inside the current project or owned resource.
- * @returns The camel-case source stem, with artifact as the missing-filename fallback.
- */
-function fileBinding(path) {
-    return (path.split("/").at(-1)?.split(".")[0] ?? "artifact").replace(/-([a-z0-9])/g, (_, value) => value.toUpperCase());
-}
-/**
- * Orders pure discovery facts by canonical source path.
- * @param left - First value in deterministic comparison.
- * @param right - Second value in deterministic comparison.
- * @returns Negative, zero or positive ordering of source paths.
+ * Orders static records by their real portable source filenames.
+ * @param left - First record.
+ * @param right - Second record.
+ * @returns Stable path ordering without changing logical IDs.
  */
 function byPath(left, right) {
     return left.path.localeCompare(right.path);

package/dist/project-discovery-facts.js.map

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

package/dist/project-discovery-members.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Extracts callable/event/task/job member names from a service declaration.
+ * @param facts - Compiler-recognized member bindings, when available.
+ * @param source - Complete owning module source text.
+ * @param path - Physical module path supplying source coordinates.
+ * @param factory - Recognized service factory name.
+ * @returns Static member names and their optional identifiable target bindings.
+ */
+export declare function serviceMembers(facts: readonly {
+    readonly member: string;
+    readonly targetBinding?: string;
+}[], source: string, path: string, factory: string): {
+    targetBinding?: string;
+    name: string;
+}[];
+//# sourceMappingURL=project-discovery-members.d.ts.map

package/dist/project-discovery-members.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery-members.d.ts","sourceRoot":"","sources":["../src/project-discovery-members.ts"],"names":[],"mappings":"AAQA;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,SAAS;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,EAC9E,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM;;;IAuBhB"}

package/dist/project-discovery-members.js

@@ -0,0 +1,57 @@
+/**
+ * Reads public service member bindings from compiler facts or a compatible
+ * TypeScript object declaration. This pure syntax adapter never evaluates member
+ * expressions or creates a runtime service; ownership is resolved separately.
+ */
+import * as ts from "typescript";
+import { readFactoryObject, staticPropertyName } from "./source-edit.js";
+/**
+ * Extracts callable/event/task/job member names from a service declaration.
+ * @param facts - Compiler-recognized member bindings, when available.
+ * @param source - Complete owning module source text.
+ * @param path - Physical module path supplying source coordinates.
+ * @param factory - Recognized service factory name.
+ * @returns Static member names and their optional identifiable target bindings.
+ */
+export function serviceMembers(facts, source, path, factory) {
+    if (facts.length > 0)
+        return facts.map((member) => ({
+            name: member.member,
+            ...(member.targetBinding === undefined ? {} : { targetBinding: member.targetBinding }),
+        }));
+    const root = readFactoryObject(source, path, [factory]);
+    return ["functions", "events", "tasks", "jobs"].flatMap((category) => {
+        const item = root.properties.find((item) => staticPropertyName(item.name) === category);
+        if (!item || !ts.isPropertyAssignment(item))
+            return [];
+        const value = unwrap(item.initializer);
+        if (!value || !ts.isObjectLiteralExpression(value))
+            return [];
+        return value.properties.flatMap((member) => {
+            const name = staticPropertyName(member.name);
+            if (name === undefined)
+                return [];
+            let targetBinding;
+            if (ts.isShorthandPropertyAssignment(member))
+                targetBinding = member.name.text;
+            else if (ts.isPropertyAssignment(member) && ts.isIdentifier(member.initializer))
+                targetBinding = member.initializer.text;
+            return [{ name, ...(targetBinding === undefined ? {} : { targetBinding }) }];
+        });
+    });
+}
+/**
+ * Removes syntax-only wrappers while leaving expressions unevaluated.
+ * @param value - Optional source expression wrapped by assertions or parentheses.
+ * @returns Underlying expression, or absence when no expression was supplied.
+ */
+function unwrap(value) {
+    if (!value)
+        return undefined;
+    if (ts.isAsExpression(value) ||
+        ts.isSatisfiesExpression(value) ||
+        ts.isParenthesizedExpression(value))
+        return unwrap(value.expression);
+    return value;
+}
+//# sourceMappingURL=project-discovery-members.js.map

package/dist/project-discovery-members.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-discovery-members.js","sourceRoot":"","sources":["../src/project-discovery-members.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,MAAM,YAAY,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AAEzE;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,KAA8E,EAC9E,MAAc,EACd,IAAY,EACZ,OAAe;IAEf,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAClB,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;YAC5B,IAAI,EAAE,MAAM,CAAC,MAAM;YACnB,GAAG,CAAC,MAAM,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC;SACvF,CAAC,CAAC,CAAC;IACN,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACnE,MAAM,IAAI,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC,CAAC;QACxF,IAAI,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC;YAAE,OAAO,EAAE,CAAC;QACvD,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,IAAI,CAAC,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QAC9D,OAAO,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACzC,MAAM,IAAI,GAAG,kBAAkB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC7C,IAAI,IAAI,KAAK,SAAS;gBAAE,OAAO,EAAE,CAAC;YAClC,IAAI,aAAiC,CAAC;YACtC,IAAI,EAAE,CAAC,6BAA6B,CAAC,MAAM,CAAC;gBAAE,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBAC1E,IAAI,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,YAAY,CAAC,MAAM,CAAC,WAAW,CAAC;gBAC7E,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC;YAC1C,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC,CAAC;QAC/E,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,MAAM,CAAC,KAAgC;IAC9C,IAAI,CAAC,KAAK;QAAE,OAAO,SAAS,CAAC;IAC7B,IACE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC;QACxB,EAAE,CAAC,qBAAqB,CAAC,KAAK,CAAC;QAC/B,EAAE,CAAC,yBAAyB,CAAC,KAAK,CAAC;QAEnC,OAAO,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IAClC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/project-discovery-types.d.ts

@@ -1,4 +1,10 @@
+/**
+ * Defines immutable declaration-only scaffold discovery records. Compiler syntax
+ * supplies layout/ownership; renderers preserve logical identities and provider
+ * declarations while creating sources at their selected physical boundaries.
+ */
 import type { SourceFactoryKind } from "@relkit/compiler";
+import type { ApplicationLayout } from "@relkit/contracts";
 import type { DatabaseDialect } from "./add-types.js";
 /**
  * Statically discovered service member name and referenced binding.
@@ -47,6 +53,8 @@ export interface DiscoveredProfile {
  * Deterministic source-only app, provider, service and artifact facts for one project.
  */
 export interface ProjectDiscovery {
+    /** Present on compiler-backed discovery; older supplied planning fixtures may omit it. */
+    readonly layout?: ApplicationLayout;
     readonly projectRoot: string;
     readonly packagePath: string;
     readonly appPath: string;

package/dist/project-discovery-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-discovery-types.d.ts","sourceRoot":"","sources":["../src/project-discovery-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,cAAc,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC"}
+{"version":3,"file":"project-discovery-types.d.ts","sourceRoot":"","sources":["../src/project-discovery-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAEtD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;IACnC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,uBAAuB,EAAE,CAAC;CACtD;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,GAAG,OAAO,CAAC;IAC1C,QAAQ,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;CACrC;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,OAAO,GAAG,KAAK,GAAG,OAAO,GAAG,OAAO,CAAC;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IACpC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,cAAc,CAAC;IAClD,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAChD,QAAQ,CAAC,mBAAmB,EAAE,OAAO,CAAC;CACvC"}

package/dist/render-auth-database.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Validates an existing native database and adds Better Auth schema declarations
+ * without changing its owner or dialect. Generator filesystem authority inspects
+ * collisions; no client activation, migration, seed or credential edit occurs here.
+ */
+import { Effect } from "effect";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import type { PlanBuilder } from "./plan-builder.js";
+import type { DiscoveredService } from "./project-discovery-types.js";
+import type { RenderedDatabase } from "./render-database.types.js";
+/**
+ * Plans native auth tables and their export after checking existing schema collisions.
+ * @param builder - Per-request transaction planning owner.
+ * @param database - Existing native database's matching dialect and schema paths.
+ * @returns Lazy planned schema edits with typed filesystem/scaffold failures.
+ */
+export declare const addAuthSchemaEffect: (builder: PlanBuilder, database: RenderedDatabase) => Effect.Effect<void, import("./generator-errors.js").GeneratorIoError | import("./generator-errors.js").GeneratorDomainError, GeneratorFileSystem>;
+/**
+ * Checks discovered schema/dialect compatibility before planning native auth tables.
+ * @param service - Sole discovered native Drizzle service.
+ * @param requested - Supported dialect requested by the auth scaffold.
+ * @returns The existing service and schema paths with their validated dialect.
+ * @throws AddScaffoldError for ambiguous schema metadata or a different native dialect.
+ */
+export declare function existingDatabase(service: DiscoveredService, requested: RenderedDatabase["dialect"]): RenderedDatabase;
+/**
+ * Requires a supported non-root static URL for the sole native auth mount.
+ * @param value - Requested auth base URL path.
+ * @returns Nothing when the mount can be represented by the existing route API.
+ * @throws AddScaffoldError when path parameters or a root mount make it unsupported.
+ */
+export declare function validateAuthBasePath(value: string): void;
+//# sourceMappingURL=render-auth-database.d.ts.map

package/dist/render-auth-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-auth-database.d.ts","sourceRoot":"","sources":["../src/render-auth-database.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGhC,OAAO,EAAE,mBAAmB,EAAE,MAAM,2BAA2B,CAAC;AAKhE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4BAA4B,CAAC;AAInE;;;;;GAKG;AACH,eAAO,MAAM,mBAAmB,yMAU/B,CAAC;AA4BF;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,SAAS,EAAE,gBAAgB,CAAC,SAAS,CAAC,GACrC,gBAAgB,CAYlB;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAIxD"}

package/dist/render-auth-database.js

@@ -0,0 +1,69 @@
+/**
+ * Validates an existing native database and adds Better Auth schema declarations
+ * without changing its owner or dialect. Generator filesystem authority inspects
+ * collisions; no client activation, migration, seed or credential edit occurs here.
+ */
+import { Effect } from "effect";
+import { dirname, posix } from "node:path";
+import { observeExecution } from "@relkit/contracts/operation";
+import { GeneratorFileSystem } from "./generator-filesystem.js";
+import { scaffoldErrors, domainError } from "./generator-errors.js";
+import { ADD_FAILURE_CODES, AddScaffoldError } from "./add-types.js";
+import { authSchemaSource } from "./render-auth-schema.js";
+import { addSourceExport } from "./source-edit.js";
+const AUTH_TABLES = ["user", "session", "account", "verification"];
+/**
+ * Plans native auth tables and their export after checking existing schema collisions.
+ * @param builder - Per-request transaction planning owner.
+ * @param database - Existing native database's matching dialect and schema paths.
+ * @returns Lazy planned schema edits with typed filesystem/scaffold failures.
+ */
+export const addAuthSchemaEffect = Effect.fn("Scaffold.addAuthSchema")(function* (builder, database) {
+    const directory = dirname(database.schemaPath).replaceAll("\\", "/");
+    yield* assertNoAuthTablesEffect(builder.discovery.projectRoot, directory);
+    yield* builder.createEffect(`${directory}/auth.ts`, authSchemaSource(database.dialect));
+    yield* builder.updateEffect(database.schemaPath, (source) => addSourceExport(source, database.schemaPath, 'export * from "./auth.js";'));
+}, (effect) => observeExecution("generator", "planning.addAuthSchema", scaffoldErrors(effect)));
+/**
+ * Stops at the first deterministic schema collision before planning any auth edits.
+ * @param root - Canonical application root.
+ * @param directory - Existing database's physical schema directory.
+ * @returns Lazy validation with GeneratorFileSystem required and typed collision failures.
+ */
+const assertNoAuthTablesEffect = Effect.fn("Scaffold.assertNoAuthTables")(function* (root, directory) {
+    const fs = yield* GeneratorFileSystem;
+    const files = yield* fs.glob(posix.join(root, directory), "**/*.ts");
+    // Preserve first-collision order and avoid reading later modules after a rejection.
+    for (const file of files) {
+        const source = yield* fs.readText(posix.join(root, directory, file));
+        if (AUTH_TABLES.some((name) => new RegExp(`\\bexport\\s+const\\s+${name}\\b`).test(source))) {
+            return yield* domainError(new AddScaffoldError(ADD_FAILURE_CODES.collision, `The database schema already exports Better Auth table names (${file}).`));
+        }
+    }
+}, (effect) => observeExecution("generator", "planning.assertNoAuthTables", scaffoldErrors(effect)));
+/**
+ * Checks discovered schema/dialect compatibility before planning native auth tables.
+ * @param service - Sole discovered native Drizzle service.
+ * @param requested - Supported dialect requested by the auth scaffold.
+ * @returns The existing service and schema paths with their validated dialect.
+ * @throws AddScaffoldError for ambiguous schema metadata or a different native dialect.
+ */
+export function existingDatabase(service, requested) {
+    if (!service.dialect || !service.schemaPath)
+        throw new AddScaffoldError(ADD_FAILURE_CODES.unsupportedSourceShape, "The existing database service has no statically discoverable dialect or schema import.");
+    if (service.dialect !== requested)
+        throw new AddScaffoldError(ADD_FAILURE_CODES.collision, `The existing database uses ${service.dialect}, not ${requested}.`);
+    return { dialect: service.dialect, servicePath: service.path, schemaPath: service.schemaPath };
+}
+/**
+ * Requires a supported non-root static URL for the sole native auth mount.
+ * @param value - Requested auth base URL path.
+ * @returns Nothing when the mount can be represented by the existing route API.
+ * @throws AddScaffoldError when path parameters or a root mount make it unsupported.
+ */
+export function validateAuthBasePath(value) {
+    if (!/^\/(?:[A-Za-z0-9._~-]+(?:\/[A-Za-z0-9._~-]+)*)?$/.test(value) || value === "/") {
+        throw new AddScaffoldError(ADD_FAILURE_CODES.usage, `Invalid auth base path: ${value}`);
+    }
+}
+//# sourceMappingURL=render-auth-database.js.map