@deterministic-code/datasources-cli 0.0.0-stage → 0.1.2

package/node_modules/@deterministic-code/typescript-generators/src/import-generator.ts

@@ -0,0 +1,346 @@
+import { posix } from "node:path";
+import type { IImportGenerator } from "@deterministic-code/generators-common/import-generator";
+import { createCasing, type PackCasing } from "./common/default-casing.ts";
+
+const importSpec = (fromFile: string, toFile: string): string => {
+  const toNoExt = toFile.endsWith(".ts") ? toFile.slice(0, -3) : toFile;
+  const rel = posix.relative(posix.dirname(fromFile), toNoExt);
+  return rel.startsWith(".") ? rel : `./${rel}`;
+};
+
+const modulePathParts = (mod: string): string[] => {
+  const parts = mod.split("/").filter((p) => p !== "" && p !== ".");
+  while (parts.length && parts[0] === "..") parts.shift();
+  return parts;
+};
+
+export class TypeScriptImportGenerator implements IImportGenerator {
+  private readonly organizeByFeature: boolean;
+  private readonly flat: boolean;
+  private readonly basePath: string;
+  private readonly casing: PackCasing;
+
+  constructor(basePath: string, settings: Record<string, string>) {
+    this.basePath = basePath;
+    this.flat = basePath !== "" && basePath !== ".";
+    this.organizeByFeature =
+      !this.flat && settings["other.organize_by_feature"] === "true";
+    this.casing = createCasing(settings);
+  }
+
+  datasource(entity: string): string {
+    const file = this.organizeByFeature
+      ? `${this.casing.fileBase(entity)}.datasource.ts`
+      : this.tsFile(entity);
+    const path = this.organizeByFeature
+      ? this.featurePath(entity, file)
+      : file;
+    return this.underBase(path);
+  }
+
+  datasourceRel(entity: string): string {
+    return this.rel("types/generated/datasource", this.datasource(entity));
+  }
+
+  datasourceQual(entity: string): string {
+    return this.casing.convertTypes(entity);
+  }
+
+  datasourceValidator(entity: string): string {
+    const file = this.organizeByFeature
+      ? `${this.casing.fileBase(entity)}.datasource.validator.ts`
+      : this.tsFile(entity);
+    const path = this.organizeByFeature
+      ? this.featurePath(entity, file)
+      : file;
+    return this.underBase(path);
+  }
+
+  datasourceValidatorRel(entity: string): string {
+    return this.rel(
+      "types/generated/datasource/validators",
+      this.datasourceValidator(entity),
+    );
+  }
+
+  datasourceTestRel(entity: string): string {
+    return this.rel(
+      "types/generated/datasource",
+      this.test(this.datasource(entity), entity),
+    );
+  }
+
+  datasourceValidatorTestRel(entity: string): string {
+    return this.rel(
+      "types/generated/datasource/validators",
+      this.test(this.datasourceValidator(entity), entity),
+    );
+  }
+
+  view(entity: string): string {
+    return this.underBase(this.viewLike(entity, ""));
+  }
+
+  viewRel(entity: string): string {
+    return this.rel("types/generated/views", this.view(entity));
+  }
+
+  viewQual(entity: string): string {
+    return this.casing.convertTypes(entity);
+  }
+
+  viewValidator(entity: string): string {
+    return this.underBase(this.viewLike(entity, ".validator"));
+  }
+
+  viewValidatorRel(entity: string): string {
+    return this.rel(
+      "types/generated/views/validators",
+      this.viewValidator(entity),
+    );
+  }
+
+  viewTestRel(entity: string): string {
+    return this.rel("types/generated/views", this.test(this.view(entity), entity));
+  }
+
+  viewValidatorTestRel(entity: string): string {
+    return this.rel(
+      "types/generated/views/validators",
+      this.test(this.viewValidator(entity), entity),
+    );
+  }
+
+  validatorTestRel(kind: "datasource" | "view", entity: string): string {
+    return kind === "datasource"
+      ? this.datasourceValidatorTestRel(entity)
+      : this.viewValidatorTestRel(entity);
+  }
+
+  service(entity: string): string {
+    const file = `${this.serviceStem(entity)}.ts`;
+    const path = this.organizeByFeature
+      ? this.featurePath(entity, file)
+      : file;
+    return this.underBase(path);
+  }
+
+  serviceRel(entity: string): string {
+    return this.rel("services/generated", this.service(entity));
+  }
+
+  serviceCustom(name: string, module?: string): string {
+    return this.resolveCustom(name, module, "services");
+  }
+
+  serviceCustomRel(entity: string): string {
+    const file = `${this.serviceStem(entity)}.ts`;
+    return this.organizeByFeature
+      ? `features/${this.casing.directory(entity)}/custom/${file}`
+      : `services/custom/${file}`;
+  }
+
+  serviceTest(entity: string): string {
+    const file = `${this.serviceStem(entity)}.test.ts`;
+    const path = this.organizeByFeature
+      ? `features/${this.casing.directory(entity)}/__tests__/${file}`
+      : file;
+    return this.underBase(path);
+  }
+
+  serviceTestRel(entity: string): string {
+    return this.rel("services/generated/__tests__", this.serviceTest(entity));
+  }
+
+  serviceIntegrationTest(entity: string): string {
+    return this.serviceTest(entity).replace(/\.test\.ts$/, ".integration.test.ts");
+  }
+
+  serviceIntegrationTestRel(entity: string): string {
+    return this.rel(
+      "services/generated/__tests__",
+      this.serviceIntegrationTest(entity),
+    );
+  }
+
+  serviceUse(_entity: string, _symbol: string): string {
+    return "";
+  }
+
+  route(entity: string): string {
+    const file = this.organizeByFeature
+      ? `${this.casing.fileBase(entity)}.route.ts`
+      : this.tsFile(entity);
+    const path = this.organizeByFeature
+      ? this.featurePath(entity, file)
+      : file;
+    return this.underBase(path);
+  }
+
+  routeRel(entity: string): string {
+    return this.rel("routes/generated", this.route(entity));
+  }
+
+  routeCustom(name: string, module?: string): string {
+    return this.resolveCustom(name, module, "routes");
+  }
+
+  routeTest(entity: string): string {
+    const file = `${this.casing.fileBase(entity)}.integration.test.ts`;
+    const path = this.organizeByFeature
+      ? `features/${this.casing.directory(entity)}/__tests__/${file}`
+      : file;
+    return this.underBase(path);
+  }
+
+  routeTestRel(entity: string): string {
+    return this.rel("routes/generated/__tests__", this.routeTest(entity));
+  }
+
+  enrichment(_targetTable: string): string {
+    return "";
+  }
+
+  test(srcFile: string, fileBase: string): string {
+    if (this.organizeByFeature) {
+      const stem = posix.basename(srcFile).replace(/\.ts$/, "");
+      return `${posix.dirname(srcFile)}/__tests__/${stem}.test.ts`;
+    }
+    return srcFile.replace(/\.ts$/, ".test.ts");
+  }
+
+  testSpec(srcFile: string, fileBase: string): string {
+    if (!srcFile.includes("/")) return `../${this.casing.fileBase(fileBase)}`;
+    return importSpec(this.test(srcFile, fileBase), srcFile);
+  }
+
+  index(beside: string): string {
+    if (this.organizeByFeature) return "";
+    return posix.join(posix.dirname(beside), "index.ts");
+  }
+
+  spec(fromFile: string, toFile: string): string {
+    return importSpec(fromFile, toFile);
+  }
+
+  routeModule(entity: string): string {
+    return this.casing.fileBase(entity);
+  }
+
+  appWiring(): string {
+    return "";
+  }
+
+  validatorFn(
+    _kind: "datasource" | "view",
+    _entity: string,
+    _fn: string,
+  ): string {
+    return "";
+  }
+
+  apiPath(entity: string): string {
+    return entity.replace(/_/g, "-");
+  }
+
+  frontend(relPath: string): string {
+    return posix.join("frontend", relPath);
+  }
+
+  app(): string {
+    return this.casing.filePath("app");
+  }
+
+  server(): string {
+    return this.casing.filePath("server");
+  }
+
+  appTest(stem: string): string {
+    return `__tests__/${this.casing.fileBase(stem)}.test.ts`;
+  }
+
+  /** Layered types/services/routes globs, or features when by-feature. Empty when flat. */
+  tsconfigIncludes(): string[] {
+    if (this.flat) return [];
+    if (this.organizeByFeature) return ["features/**/*.ts"];
+    return ["types/**/*.ts", "services/**/*.ts", "routes/**/*.ts"];
+  }
+
+  private rel(prefix: string, file: string): string {
+    if (this.organizeByFeature || this.flat) return file;
+    return `${prefix}/${file}`;
+  }
+
+  private tsFile(stem: string): string {
+    return `${this.casing.fileBase(stem)}.ts`;
+  }
+
+  private featurePath(entity: string, file: string): string {
+    return `features/${this.casing.directory(entity)}/${file}`;
+  }
+
+  private serviceStem(entity: string): string {
+    return this.casing.fileBase(`${entity}_service`);
+  }
+
+  private underBase(file: string): string {
+    if (!this.flat) return file;
+    return `${this.basePath}/${file}`;
+  }
+
+  private viewLike(entity: string, featureExt: string): string {
+    const file = `${this.casing.fileBase(entity)}${this.organizeByFeature ? featureExt : ""}.ts`;
+    return this.organizeByFeature
+      ? `features/${this.casing.directory(entity)}/${file}`
+      : file;
+  }
+
+  private resolveCustom(
+    name: string,
+    mod: string | undefined,
+    layer: "services" | "routes",
+  ): string {
+    const kind = layer === "services" ? "service" : "route";
+    const stubFn =
+      layer === "services"
+        ? "generateCustomServiceStub"
+        : "generateCustomRouteStub";
+    const file =
+      layer === "services"
+        ? this.tsFile(name)
+        : `${this.casing.fileBase(`${name}_route`)}.ts`;
+    const defaultStub = this.organizeByFeature
+      ? `features/${this.casing.directory(name)}/custom/${file}`
+      : `../custom/${file}`;
+    if (this.organizeByFeature) {
+      if (
+        typeof mod !== "string" ||
+        !mod.startsWith(".") ||
+        mod.startsWith("./services/") ||
+        mod.startsWith("./routes/")
+      ) {
+        return defaultStub;
+      }
+      const parts = modulePathParts(mod);
+      if (parts[0] !== "features") {
+        throw new Error(
+          `${stubFn}: ${kind} "${name}" has module "${mod}" which is outside ./features/. ` +
+            `When organize=by-feature, custom ${layer} must live under features/<entity>/custom/. ` +
+            `Drop the module: field to use the convention default (${defaultStub.replace(/\.ts$/, "")}), ` +
+            `or point module: into ./features/.`,
+        );
+      }
+      return `${parts.join("/")}.ts`;
+    }
+    if (!mod || !mod.startsWith(".")) return defaultStub;
+    const parts = modulePathParts(mod);
+    if (parts[0] === layer) parts.shift();
+    return `../${parts.join("/")}.ts`;
+  }
+}
+
+export const createImportGenerator = (
+  basePath: string,
+  settings: Record<string, string>,
+): TypeScriptImportGenerator =>
+  new TypeScriptImportGenerator(basePath, settings);

package/node_modules/@deterministic-code/typescript-generators/src/inline-inherited.ts

@@ -0,0 +1,2 @@
+export const referencesBackend = (settings: Record<string, string>): boolean =>
+  settings.reference_backend_type === "true";

package/node_modules/@deterministic-code/typescript-generators/src/resources/backend-app-minimal.ts

@@ -0,0 +1,21 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-backend-app/minimal/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [
+  minimalAppTs,
+  minimalServerTs,
+  minimalPackageJson,
+  minimalTsconfigJson,
+  minimalHealthTestTs,
+] = await Promise.all([
+  resource("app.ts.tmpl"),
+  resource("server.ts.tmpl"),
+  resource("package.json.tmpl"),
+  resource("tsconfig.json.tmpl"),
+  resource("health.test.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/backend-app.ts

@@ -0,0 +1,32 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(new URL(`../templates/create-backend-app/${rel}`, import.meta.url), "utf8");
+
+export const [
+  appTs,
+  serverTs,
+  packageJson,
+  tsconfigJson,
+  dockerfile,
+  entrypointSh,
+  dockerComposeYml,
+  envFile,
+  gitignore,
+  vitestConfigTs,
+  healthTestTs,
+  appBootTestTs,
+] = await Promise.all([
+  resource("typescript/chunks/app.ts"),
+  resource("typescript/chunks/server.ts"),
+  resource("package.json.tmpl"),
+  resource("tsconfig.json.tmpl"),
+  resource("Dockerfile.tmpl"),
+  resource("entrypoint.sh"),
+  resource("docker-compose.yml.tmpl"),
+  resource("env.tmpl"),
+  resource("gitignore.tmpl"),
+  resource("vitest.config.ts.tmpl"),
+  resource("health.test.ts.tmpl"),
+  resource("app-boot.test.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/client-bindings-live-tests.ts

@@ -0,0 +1,15 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-client-bindings-live-tests/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const [httpEntityTmpl, tanstackEntityTmpl] = await Promise.all([
+  resource("http-entity.test.ts.tmpl"),
+  resource("tanstack-entity.test.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/client-bindings-mock-tests.ts

@@ -0,0 +1,15 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-client-bindings-mock-tests/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const [httpEntityTmpl, tanstackEntityTmpl] = await Promise.all([
+  resource("http-entity.test.ts.tmpl"),
+  resource("tanstack-entity.test.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/client-bindings.ts

@@ -0,0 +1,25 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-client-bindings/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [
+  fetchHttpTmpl,
+  axiosHttpTmpl,
+  entityTmpl,
+  transportIndexTmpl,
+  tanstackTmpl,
+  tanstackIndexTmpl,
+  rootIndexTmpl,
+] = await Promise.all([
+  resource("fetch-http.ts.tmpl"),
+  resource("axios-http.ts.tmpl"),
+  resource("entity.ts.tmpl"),
+  resource("transport-index.ts.tmpl"),
+  resource("tanstack.ts.tmpl"),
+  resource("tanstack-index.ts.tmpl"),
+  resource("root-index.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/datasource-type-validators-tests.ts

@@ -0,0 +1,14 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-datasource-type-validators-tests/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const [typeTestTmpl] = await Promise.all([
+  resource("type.test.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/datasource-type-validators.ts

@@ -0,0 +1,15 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-datasource-type-validators/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const [typeTmpl, indexTmpl] = await Promise.all([
+  resource("type.ts.tmpl"),
+  resource("index.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/datasource-types-tests.ts

@@ -0,0 +1,11 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-datasource-types-tests/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [typeTestTmpl] = await Promise.all([
+  resource("type.test.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/frontend-app-angular.ts

@@ -0,0 +1,35 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-frontend-app/angular/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [
+  packageJson,
+  angularJson,
+  tsconfigJson,
+  tsconfigAppJson,
+  indexHtml,
+  mainTs,
+  appConfigTs,
+  appTs,
+  stylesCss,
+  gitignore,
+  dockerComposeServiceYml,
+  dockerfile,
+] = await Promise.all([
+  resource("package.json.tmpl"),
+  resource("angular.json.tmpl"),
+  resource("tsconfig.json.tmpl"),
+  resource("tsconfig.app.json.tmpl"),
+  resource("src/index.html.tmpl"),
+  resource("src/main.ts.tmpl"),
+  resource("src/app/app.config.ts.tmpl"),
+  resource("src/app/app.ts.tmpl"),
+  resource("src/styles.css.tmpl"),
+  resource("gitignore.tmpl"),
+  resource("docker-compose-service.yml.tmpl"),
+  resource("Dockerfile.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/frontend-app-next.ts

@@ -0,0 +1,29 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-frontend-app/next/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [
+  packageJson,
+  tsconfigJson,
+  nextConfigTs,
+  nextEnvDts,
+  layoutTsx,
+  pageTsx,
+  gitignore,
+  dockerComposeServiceYml,
+  dockerfile,
+] = await Promise.all([
+  resource("package.json.tmpl"),
+  resource("tsconfig.json.tmpl"),
+  resource("next.config.ts.tmpl"),
+  resource("next-env.d.ts.tmpl"),
+  resource("app/layout.tsx.tmpl"),
+  resource("app/page.tsx.tmpl"),
+  resource("gitignore.tmpl"),
+  resource("docker-compose-service.yml.tmpl"),
+  resource("Dockerfile.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/frontend-app-svelte.ts

@@ -0,0 +1,33 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-frontend-app/svelte/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [
+  packageJson,
+  viteConfigTs,
+  svelteConfigJs,
+  tsconfigJson,
+  indexHtml,
+  viteEnvDts,
+  mainTs,
+  appSvelte,
+  gitignore,
+  dockerComposeServiceYml,
+  dockerfile,
+] = await Promise.all([
+  resource("package.json.tmpl"),
+  resource("vite.config.ts.tmpl"),
+  resource("svelte.config.js.tmpl"),
+  resource("tsconfig.json.tmpl"),
+  resource("index.html.tmpl"),
+  resource("src/vite-env.d.ts.tmpl"),
+  resource("src/main.ts.tmpl"),
+  resource("src/App.svelte.tmpl"),
+  resource("gitignore.tmpl"),
+  resource("docker-compose-service.yml.tmpl"),
+  resource("Dockerfile.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/frontend-app.ts

@@ -0,0 +1,29 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(`../templates/create-frontend-app/${rel}`, import.meta.url),
+    "utf8",
+  );
+
+export const [
+  indexHtml,
+  viteConfigTs,
+  tsconfigJson,
+  mainTsx,
+  appTsx,
+  packageJson,
+  gitignore,
+  dockerComposeServiceYml,
+  dockerfile,
+] = await Promise.all([
+  resource("index.html.tmpl"),
+  resource("vite.config.ts.tmpl"),
+  resource("tsconfig.json.tmpl"),
+  resource("src/main.tsx.tmpl"),
+  resource("src/App.tsx.tmpl"),
+  resource("package.json.tmpl"),
+  resource("gitignore.tmpl"),
+  resource("docker-compose-service.yml.tmpl"),
+  resource("Dockerfile.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/frontend-validators.ts

@@ -0,0 +1,24 @@
+import { readFile } from "node:fs/promises";
+
+const resource = (rel: string): Promise<string> =>
+  readFile(
+    new URL(
+      `../templates/create-frontend-validators/${rel}`,
+      import.meta.url,
+    ),
+    "utf8",
+  );
+
+export const [
+  typeTmpl,
+  indexTmpl,
+  schemaUnionTmpl,
+  schemaStandaloneTmpl,
+  schemaInheritTmpl,
+] = await Promise.all([
+  resource("type.ts.tmpl"),
+  resource("index.ts.tmpl"),
+  resource("schema-union.ts.tmpl"),
+  resource("schema-standalone.ts.tmpl"),
+  resource("schema-inherit.ts.tmpl"),
+]);

package/node_modules/@deterministic-code/typescript-generators/src/resources/perf-e2e.ts

@@ -0,0 +1,6 @@
+import { readFile } from "node:fs/promises";
+
+export const e2eTmpl = await readFile(
+  new URL("../templates/create-perf-e2e/app.perf.client.test.ts.tmpl", import.meta.url),
+  "utf8",
+);

package/node_modules/@deterministic-code/typescript-generators/src/resources/perf-server.ts

@@ -0,0 +1,15 @@
+import { readFile } from "node:fs/promises";
+
+export const [serverTmpl, vitestPerfTmpl] = await Promise.all([
+  readFile(
+    new URL("../templates/create-perf-server/perf-server.ts.tmpl", import.meta.url),
+    "utf8",
+  ),
+  readFile(
+    new URL(
+      "../templates/create-backend-app/vitest.perf.config.ts.tmpl",
+      import.meta.url,
+    ),
+    "utf8",
+  ),
+]);