shiftapi 0.0.14

package/README.md

@@ -0,0 +1,66 @@
+<p align="center">
+	<picture>
+		<source media="(prefers-color-scheme: dark)" srcset="https://raw.githubusercontent.com/fcjr/shiftapi/main/assets/logo-dark.svg">
+		<img src="https://raw.githubusercontent.com/fcjr/shiftapi/main/assets/logo.svg" alt="ShiftAPI Logo">
+	</picture>
+</p>
+
+# shiftapi
+
+CLI and codegen core for [ShiftAPI](https://github.com/fcjr/shiftapi). Extracts the OpenAPI spec from your Go server and generates a fully-typed TypeScript client — no Vite required.
+
+## Installation
+
+```bash
+npm install -D shiftapi
+# or
+pnpm add -D shiftapi
+```
+
+## Setup
+
+Create a `shiftapi.config.ts` in your project root:
+
+```ts
+import { defineConfig } from "shiftapi";
+
+export default defineConfig({
+  server: "./cmd/server",
+});
+```
+
+## CLI Usage
+
+```bash
+shiftapi prepare
+```
+
+This will:
+
+1. Find your `shiftapi.config.ts` (searching upward from cwd)
+2. Run your Go server to extract the OpenAPI 3.1 spec
+3. Generate TypeScript types via `openapi-typescript`
+4. Write `.shiftapi/client.d.ts` and `.shiftapi/client.js`
+5. Patch `tsconfig.json` with the required path mapping
+
+Typically used in a `postinstall` script:
+
+```json
+{
+  "scripts": {
+    "postinstall": "shiftapi prepare"
+  }
+}
+```
+
+## Config Options
+
+| Option | Type | Default | Description |
+|--------|------|---------|-------------|
+| `server` | `string` | **(required)** | Path to the Go server entry point (e.g. `"./cmd/server"`) |
+| `baseUrl` | `string` | `"/"` | Base URL for the generated API client |
+| `url` | `string` | `"http://localhost:8080"` | Go server address (used by the Vite plugin for dev proxy) |
+
+## License
+
+MIT

package/dist/chunk-32WL5S5C.js

@@ -0,0 +1,231 @@
+// src/config.ts
+import { existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { createRequire } from "module";
+function defineConfig(config) {
+  return config;
+}
+var CONFIG_FILENAMES = [
+  "shiftapi.config.ts",
+  "shiftapi.config.js",
+  "shiftapi.config.mjs"
+];
+async function loadConfig(startDir, configPath) {
+  let resolvedPath;
+  if (configPath) {
+    resolvedPath = resolve(startDir, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`[shiftapi] Config file not found: ${resolvedPath}`);
+    }
+  } else {
+    resolvedPath = findConfigFile(startDir);
+    if (!resolvedPath) {
+      throw new Error(
+        `[shiftapi] Could not find shiftapi.config.ts (searched upward from ${startDir}). Create one with: import { defineConfig } from "shiftapi"`
+      );
+    }
+  }
+  const require2 = createRequire(import.meta.url);
+  const { createJiti } = require2("jiti");
+  const jiti = createJiti(resolvedPath);
+  const mod = await jiti.import(resolvedPath);
+  const config = mod.default ?? mod;
+  if (!config.server) {
+    throw new Error(
+      `[shiftapi] Config at ${resolvedPath} must specify a "server" field (path to Go entry point)`
+    );
+  }
+  return { config, configDir: dirname(resolvedPath) };
+}
+function findConfigFile(startDir) {
+  let dir = resolve(startDir);
+  const root = resolve("/");
+  while (true) {
+    for (const name of CONFIG_FILENAMES) {
+      const candidate = resolve(dir, name);
+      if (existsSync(candidate)) {
+        return candidate;
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir || dir === root) {
+      return void 0;
+    }
+    dir = parent;
+  }
+}
+
+// src/extract.ts
+import { execFileSync } from "child_process";
+import { readFileSync, unlinkSync, rmSync, mkdtempSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+function extractSpec(serverEntry, goRoot) {
+  const tempDir = mkdtempSync(join(tmpdir(), "shiftapi-"));
+  const specPath = join(tempDir, "openapi.json");
+  try {
+    execFileSync("go", ["run", "-tags", "shiftapidev", serverEntry], {
+      cwd: goRoot,
+      env: {
+        ...process.env,
+        SHIFTAPI_EXPORT_SPEC: specPath
+      },
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 3e4
+    });
+  } catch (err) {
+    const stderr = err instanceof Error && "stderr" in err ? String(err.stderr) : "";
+    throw new Error(
+      `shiftapi: Failed to extract OpenAPI spec.
+  Command: go run ${serverEntry}
+  CWD: ${goRoot}
+  Error: ${stderr || String(err)}`
+    );
+  }
+  let raw;
+  try {
+    raw = readFileSync(specPath, "utf-8");
+  } catch {
+    throw new Error(
+      `shiftapi: Spec file was not created at ${specPath}.
+  Make sure your Go server calls shiftapi.ListenAndServe().`
+    );
+  }
+  try {
+    unlinkSync(specPath);
+    rmSync(tempDir, { recursive: true });
+  } catch {
+  }
+  return JSON.parse(raw);
+}
+
+// src/generate.ts
+import openapiTS, { astToString } from "openapi-typescript";
+async function generateTypes(spec) {
+  const ast = await openapiTS(spec);
+  return astToString(ast);
+}
+
+// src/constants.ts
+var MODULE_ID = "@shiftapi/client";
+var RESOLVED_MODULE_ID = "\0" + MODULE_ID;
+var DEV_API_PREFIX = "/__shiftapi";
+
+// src/templates.ts
+function indent(text, spaces = 2) {
+  const prefix = " ".repeat(spaces);
+  return text.split("\n").map((line) => line ? prefix + line : line).join("\n");
+}
+function dtsTemplate(generatedTypes) {
+  return `// Auto-generated by shiftapi. Do not edit.
+declare module "@shiftapi/client" {
+${indent(generatedTypes)}
+
+  import type createClient from "openapi-fetch";
+
+  export const client: ReturnType<typeof createClient<paths>>;
+  export { createClient };
+}
+`;
+}
+function clientJsTemplate(baseUrl) {
+  return `// Auto-generated by shiftapi. Do not edit.
+import createClient from "openapi-fetch";
+
+/** Pre-configured, fully-typed API client. */
+export const client = createClient({
+  baseUrl: ${JSON.stringify(baseUrl)},
+});
+
+export { createClient };
+`;
+}
+function virtualModuleTemplate(baseUrl, devApiPrefix) {
+  const baseUrlExpr = devApiPrefix ? `import.meta.env.VITE_SHIFTAPI_BASE_URL || (import.meta.env.DEV ? ${JSON.stringify(devApiPrefix)} : ${JSON.stringify(baseUrl)})` : `import.meta.env.VITE_SHIFTAPI_BASE_URL || ${JSON.stringify(baseUrl)}`;
+  return `// Auto-generated by @shiftapi/vite-plugin
+import createClient from "openapi-fetch";
+
+/** Pre-configured, fully-typed API client. */
+export const client = createClient({
+  baseUrl: ${baseUrlExpr},
+});
+
+export { createClient };
+`;
+}
+
+// src/codegen.ts
+import { resolve as resolve2, relative } from "path";
+import { writeFileSync, readFileSync as readFileSync2, mkdirSync, existsSync as existsSync2 } from "fs";
+import { parse, stringify } from "comment-json";
+async function regenerateTypes(serverEntry, goRoot, baseUrl, isDev, previousTypes) {
+  const spec = extractSpec(serverEntry, resolve2(goRoot));
+  const types = await generateTypes(spec);
+  const changed = types !== previousTypes;
+  const virtualModuleSource = virtualModuleTemplate(
+    baseUrl,
+    isDev ? DEV_API_PREFIX : void 0
+  );
+  return { types, virtualModuleSource, changed };
+}
+function writeGeneratedFiles(typesRoot, generatedDts, baseUrl) {
+  const outDir = resolve2(typesRoot, ".shiftapi");
+  if (!existsSync2(outDir)) {
+    mkdirSync(outDir, { recursive: true });
+  }
+  writeFileSync(resolve2(outDir, "client.d.ts"), dtsTemplate(generatedDts));
+  writeFileSync(resolve2(outDir, "client.js"), clientJsTemplate(baseUrl));
+  writeFileSync(
+    resolve2(outDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          paths: {
+            [MODULE_ID]: ["./client.d.ts"]
+          }
+        }
+      },
+      null,
+      2
+    ) + "\n"
+  );
+}
+function patchTsConfig(tsconfigDir, typesRoot) {
+  const tsconfigPath = resolve2(tsconfigDir, "tsconfig.json");
+  if (!existsSync2(tsconfigPath)) return;
+  const raw = readFileSync2(tsconfigPath, "utf-8");
+  let tsconfig;
+  try {
+    tsconfig = parse(raw);
+  } catch (err) {
+    console.warn(
+      `[shiftapi] Failed to parse tsconfig.json: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  const rel = relative(tsconfigDir, resolve2(typesRoot, ".shiftapi", "tsconfig.json"));
+  const extendsPath = rel.startsWith("..") ? rel : `./${rel}`;
+  if (tsconfig?.extends === extendsPath) return;
+  tsconfig.extends = extendsPath;
+  const detectedIndent = raw.match(/^[ \t]+/m)?.[0] ?? "  ";
+  writeFileSync(tsconfigPath, stringify(tsconfig, null, detectedIndent) + "\n");
+  console.log(
+    "[shiftapi] Updated tsconfig.json to extend .shiftapi/tsconfig.json"
+  );
+}
+
+export {
+  defineConfig,
+  loadConfig,
+  extractSpec,
+  generateTypes,
+  MODULE_ID,
+  RESOLVED_MODULE_ID,
+  DEV_API_PREFIX,
+  dtsTemplate,
+  clientJsTemplate,
+  virtualModuleTemplate,
+  regenerateTypes,
+  writeGeneratedFiles,
+  patchTsConfig
+};

package/dist/chunk-4ZZ6RIUO.js

@@ -0,0 +1,231 @@
+// src/config.ts
+import { existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { createRequire } from "module";
+function defineConfig(config) {
+  return config;
+}
+var CONFIG_FILENAMES = [
+  "shiftapi.config.ts",
+  "shiftapi.config.js",
+  "shiftapi.config.mjs"
+];
+async function loadConfig(startDir, configPath) {
+  let resolvedPath;
+  if (configPath) {
+    resolvedPath = resolve(startDir, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`[shiftapi] Config file not found: ${resolvedPath}`);
+    }
+  } else {
+    resolvedPath = findConfigFile(startDir);
+    if (!resolvedPath) {
+      throw new Error(
+        `[shiftapi] Could not find shiftapi.config.ts (searched upward from ${startDir}). Create one with: import { defineConfig } from "@shiftapi/cli"`
+      );
+    }
+  }
+  const require2 = createRequire(import.meta.url);
+  const { createJiti } = require2("jiti");
+  const jiti = createJiti(resolvedPath);
+  const mod = await jiti.import(resolvedPath);
+  const config = mod.default ?? mod;
+  if (!config.server) {
+    throw new Error(
+      `[shiftapi] Config at ${resolvedPath} must specify a "server" field (path to Go entry point)`
+    );
+  }
+  return { config, configDir: dirname(resolvedPath) };
+}
+function findConfigFile(startDir) {
+  let dir = resolve(startDir);
+  const root = resolve("/");
+  while (true) {
+    for (const name of CONFIG_FILENAMES) {
+      const candidate = resolve(dir, name);
+      if (existsSync(candidate)) {
+        return candidate;
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir || dir === root) {
+      return void 0;
+    }
+    dir = parent;
+  }
+}
+
+// src/extract.ts
+import { execFileSync } from "child_process";
+import { readFileSync, unlinkSync, rmSync, mkdtempSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+function extractSpec(serverEntry, goRoot) {
+  const tempDir = mkdtempSync(join(tmpdir(), "shiftapi-"));
+  const specPath = join(tempDir, "openapi.json");
+  try {
+    execFileSync("go", ["run", "-tags", "shiftapidev", serverEntry], {
+      cwd: goRoot,
+      env: {
+        ...process.env,
+        SHIFTAPI_EXPORT_SPEC: specPath
+      },
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 3e4
+    });
+  } catch (err) {
+    const stderr = err instanceof Error && "stderr" in err ? String(err.stderr) : "";
+    throw new Error(
+      `@shiftapi/cli: Failed to extract OpenAPI spec.
+  Command: go run ${serverEntry}
+  CWD: ${goRoot}
+  Error: ${stderr || String(err)}`
+    );
+  }
+  let raw;
+  try {
+    raw = readFileSync(specPath, "utf-8");
+  } catch {
+    throw new Error(
+      `@shiftapi/cli: Spec file was not created at ${specPath}.
+  Make sure your Go server calls shiftapi.ListenAndServe().`
+    );
+  }
+  try {
+    unlinkSync(specPath);
+    rmSync(tempDir, { recursive: true });
+  } catch {
+  }
+  return JSON.parse(raw);
+}
+
+// src/generate.ts
+import openapiTS, { astToString } from "openapi-typescript";
+async function generateTypes(spec) {
+  const ast = await openapiTS(spec);
+  return astToString(ast);
+}
+
+// src/constants.ts
+var MODULE_ID = "@shiftapi/client";
+var RESOLVED_MODULE_ID = "\0" + MODULE_ID;
+var DEV_API_PREFIX = "/__shiftapi";
+
+// src/templates.ts
+function indent(text, spaces = 2) {
+  const prefix = " ".repeat(spaces);
+  return text.split("\n").map((line) => line ? prefix + line : line).join("\n");
+}
+function dtsTemplate(generatedTypes) {
+  return `// Auto-generated by @shiftapi/cli. Do not edit.
+declare module "@shiftapi/client" {
+${indent(generatedTypes)}
+
+  import type createClient from "openapi-fetch";
+
+  export const client: ReturnType<typeof createClient<paths>>;
+  export { createClient };
+}
+`;
+}
+function clientJsTemplate(baseUrl) {
+  return `// Auto-generated by @shiftapi/cli. Do not edit.
+import createClient from "openapi-fetch";
+
+/** Pre-configured, fully-typed API client. */
+export const client = createClient({
+  baseUrl: ${JSON.stringify(baseUrl)},
+});
+
+export { createClient };
+`;
+}
+function virtualModuleTemplate(baseUrl, devApiPrefix) {
+  const baseUrlExpr = devApiPrefix ? `import.meta.env.VITE_SHIFTAPI_BASE_URL || (import.meta.env.DEV ? ${JSON.stringify(devApiPrefix)} : ${JSON.stringify(baseUrl)})` : `import.meta.env.VITE_SHIFTAPI_BASE_URL || ${JSON.stringify(baseUrl)}`;
+  return `// Auto-generated by @shiftapi/vite-plugin
+import createClient from "openapi-fetch";
+
+/** Pre-configured, fully-typed API client. */
+export const client = createClient({
+  baseUrl: ${baseUrlExpr},
+});
+
+export { createClient };
+`;
+}
+
+// src/codegen.ts
+import { resolve as resolve2, relative } from "path";
+import { writeFileSync, readFileSync as readFileSync2, mkdirSync, existsSync as existsSync2 } from "fs";
+import { parse, stringify } from "comment-json";
+async function regenerateTypes(serverEntry, goRoot, baseUrl, isDev, previousTypes) {
+  const spec = extractSpec(serverEntry, resolve2(goRoot));
+  const types = await generateTypes(spec);
+  const changed = types !== previousTypes;
+  const virtualModuleSource = virtualModuleTemplate(
+    baseUrl,
+    isDev ? DEV_API_PREFIX : void 0
+  );
+  return { types, virtualModuleSource, changed };
+}
+function writeGeneratedFiles(typesRoot, generatedDts, baseUrl) {
+  const outDir = resolve2(typesRoot, ".shiftapi");
+  if (!existsSync2(outDir)) {
+    mkdirSync(outDir, { recursive: true });
+  }
+  writeFileSync(resolve2(outDir, "client.d.ts"), dtsTemplate(generatedDts));
+  writeFileSync(resolve2(outDir, "client.js"), clientJsTemplate(baseUrl));
+  writeFileSync(
+    resolve2(outDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          paths: {
+            [MODULE_ID]: ["./client.d.ts"]
+          }
+        }
+      },
+      null,
+      2
+    ) + "\n"
+  );
+}
+function patchTsConfig(tsconfigDir, typesRoot) {
+  const tsconfigPath = resolve2(tsconfigDir, "tsconfig.json");
+  if (!existsSync2(tsconfigPath)) return;
+  const raw = readFileSync2(tsconfigPath, "utf-8");
+  let tsconfig;
+  try {
+    tsconfig = parse(raw);
+  } catch (err) {
+    console.warn(
+      `[shiftapi] Failed to parse tsconfig.json: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  const rel = relative(tsconfigDir, resolve2(typesRoot, ".shiftapi", "tsconfig.json"));
+  const extendsPath = rel.startsWith("..") ? rel : `./${rel}`;
+  if (tsconfig?.extends === extendsPath) return;
+  tsconfig.extends = extendsPath;
+  const detectedIndent = raw.match(/^[ \t]+/m)?.[0] ?? "  ";
+  writeFileSync(tsconfigPath, stringify(tsconfig, null, detectedIndent) + "\n");
+  console.log(
+    "[shiftapi] Updated tsconfig.json to extend .shiftapi/tsconfig.json"
+  );
+}
+
+export {
+  defineConfig,
+  loadConfig,
+  extractSpec,
+  generateTypes,
+  MODULE_ID,
+  RESOLVED_MODULE_ID,
+  DEV_API_PREFIX,
+  dtsTemplate,
+  clientJsTemplate,
+  virtualModuleTemplate,
+  regenerateTypes,
+  writeGeneratedFiles,
+  patchTsConfig
+};

package/dist/chunk-AYZYNLT6.js

@@ -0,0 +1,61 @@
+// src/config.ts
+import { existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { createRequire } from "module";
+function defineConfig(config) {
+  return config;
+}
+var CONFIG_FILENAMES = [
+  "shiftapi.config.ts",
+  "shiftapi.config.js",
+  "shiftapi.config.mjs"
+];
+async function loadConfig(startDir, configPath) {
+  let resolvedPath;
+  if (configPath) {
+    resolvedPath = resolve(startDir, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`[shiftapi] Config file not found: ${resolvedPath}`);
+    }
+  } else {
+    resolvedPath = findConfigFile(startDir);
+    if (!resolvedPath) {
+      throw new Error(
+        `[shiftapi] Could not find shiftapi.config.ts (searched upward from ${startDir}). Create one with: import { defineConfig } from "@shiftapi/core"`
+      );
+    }
+  }
+  const require2 = createRequire(import.meta.url);
+  const { createJiti } = require2("jiti");
+  const jiti = createJiti(resolvedPath);
+  const mod = await jiti.import(resolvedPath);
+  const config = mod.default ?? mod;
+  if (!config.server) {
+    throw new Error(
+      `[shiftapi] Config at ${resolvedPath} must specify a "server" field (path to Go entry point)`
+    );
+  }
+  return { config, configDir: dirname(resolvedPath) };
+}
+function findConfigFile(startDir) {
+  let dir = resolve(startDir);
+  const root = resolve("/");
+  while (true) {
+    for (const name of CONFIG_FILENAMES) {
+      const candidate = resolve(dir, name);
+      if (existsSync(candidate)) {
+        return candidate;
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir || dir === root) {
+      return void 0;
+    }
+    dir = parent;
+  }
+}
+
+export {
+  defineConfig,
+  loadConfig
+};

package/dist/chunk-M6SOET3R.js

@@ -0,0 +1,172 @@
+// src/extract.ts
+import { execFileSync } from "child_process";
+import { readFileSync, unlinkSync, rmSync, mkdtempSync } from "fs";
+import { join } from "path";
+import { tmpdir } from "os";
+function extractSpec(serverEntry, goRoot) {
+  const tempDir = mkdtempSync(join(tmpdir(), "shiftapi-"));
+  const specPath = join(tempDir, "openapi.json");
+  try {
+    execFileSync("go", ["run", "-tags", "shiftapidev", serverEntry], {
+      cwd: goRoot,
+      env: {
+        ...process.env,
+        SHIFTAPI_EXPORT_SPEC: specPath
+      },
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 3e4
+    });
+  } catch (err) {
+    const stderr = err instanceof Error && "stderr" in err ? String(err.stderr) : "";
+    throw new Error(
+      `shiftapi: Failed to extract OpenAPI spec.
+  Command: go run ${serverEntry}
+  CWD: ${goRoot}
+  Error: ${stderr || String(err)}`
+    );
+  }
+  let raw;
+  try {
+    raw = readFileSync(specPath, "utf-8");
+  } catch {
+    throw new Error(
+      `shiftapi: Spec file was not created at ${specPath}.
+  Make sure your Go server calls shiftapi.ListenAndServe().`
+    );
+  }
+  try {
+    unlinkSync(specPath);
+    rmSync(tempDir, { recursive: true });
+  } catch {
+  }
+  return JSON.parse(raw);
+}
+
+// src/generate.ts
+import openapiTS, { astToString } from "openapi-typescript";
+async function generateTypes(spec) {
+  const ast = await openapiTS(spec);
+  return astToString(ast);
+}
+
+// src/constants.ts
+var MODULE_ID = "@shiftapi/client";
+var RESOLVED_MODULE_ID = "\0" + MODULE_ID;
+var DEV_API_PREFIX = "/__shiftapi";
+
+// src/templates.ts
+function indent(text, spaces = 2) {
+  const prefix = " ".repeat(spaces);
+  return text.split("\n").map((line) => line ? prefix + line : line).join("\n");
+}
+function dtsTemplate(generatedTypes) {
+  return `// Auto-generated by shiftapi. Do not edit.
+declare module "@shiftapi/client" {
+${indent(generatedTypes)}
+
+  import type createClient from "openapi-fetch";
+
+  export const client: ReturnType<typeof createClient<paths>>;
+  export { createClient };
+}
+`;
+}
+function clientJsTemplate(baseUrl) {
+  return `// Auto-generated by shiftapi. Do not edit.
+import createClient from "openapi-fetch";
+
+/** Pre-configured, fully-typed API client. */
+export const client = createClient({
+  baseUrl: ${JSON.stringify(baseUrl)},
+});
+
+export { createClient };
+`;
+}
+function virtualModuleTemplate(baseUrl, devApiPrefix) {
+  const baseUrlExpr = devApiPrefix ? `import.meta.env.VITE_SHIFTAPI_BASE_URL || (import.meta.env.DEV ? ${JSON.stringify(devApiPrefix)} : ${JSON.stringify(baseUrl)})` : `import.meta.env.VITE_SHIFTAPI_BASE_URL || ${JSON.stringify(baseUrl)}`;
+  return `// Auto-generated by @shiftapi/vite-plugin
+import createClient from "openapi-fetch";
+
+/** Pre-configured, fully-typed API client. */
+export const client = createClient({
+  baseUrl: ${baseUrlExpr},
+});
+
+export { createClient };
+`;
+}
+
+// src/codegen.ts
+import { resolve, relative } from "path";
+import { writeFileSync, readFileSync as readFileSync2, mkdirSync, existsSync } from "fs";
+import { parse, stringify } from "comment-json";
+async function regenerateTypes(serverEntry, goRoot, baseUrl, isDev, previousTypes) {
+  const spec = extractSpec(serverEntry, resolve(goRoot));
+  const types = await generateTypes(spec);
+  const changed = types !== previousTypes;
+  const virtualModuleSource = virtualModuleTemplate(
+    baseUrl,
+    isDev ? DEV_API_PREFIX : void 0
+  );
+  return { types, virtualModuleSource, changed };
+}
+function writeGeneratedFiles(typesRoot, generatedDts, baseUrl) {
+  const outDir = resolve(typesRoot, ".shiftapi");
+  if (!existsSync(outDir)) {
+    mkdirSync(outDir, { recursive: true });
+  }
+  writeFileSync(resolve(outDir, "client.d.ts"), dtsTemplate(generatedDts));
+  writeFileSync(resolve(outDir, "client.js"), clientJsTemplate(baseUrl));
+  writeFileSync(
+    resolve(outDir, "tsconfig.json"),
+    JSON.stringify(
+      {
+        compilerOptions: {
+          paths: {
+            [MODULE_ID]: ["./client.d.ts"]
+          }
+        }
+      },
+      null,
+      2
+    ) + "\n"
+  );
+}
+function patchTsConfig(tsconfigDir, typesRoot) {
+  const tsconfigPath = resolve(tsconfigDir, "tsconfig.json");
+  if (!existsSync(tsconfigPath)) return;
+  const raw = readFileSync2(tsconfigPath, "utf-8");
+  let tsconfig;
+  try {
+    tsconfig = parse(raw);
+  } catch (err) {
+    console.warn(
+      `[shiftapi] Failed to parse tsconfig.json: ${err instanceof Error ? err.message : String(err)}`
+    );
+    return;
+  }
+  const rel = relative(tsconfigDir, resolve(typesRoot, ".shiftapi", "tsconfig.json"));
+  const extendsPath = rel.startsWith("..") ? rel : `./${rel}`;
+  if (tsconfig?.extends === extendsPath) return;
+  tsconfig.extends = extendsPath;
+  const detectedIndent = raw.match(/^[ \t]+/m)?.[0] ?? "  ";
+  writeFileSync(tsconfigPath, stringify(tsconfig, null, detectedIndent) + "\n");
+  console.log(
+    "[shiftapi] Updated tsconfig.json to extend .shiftapi/tsconfig.json"
+  );
+}
+
+export {
+  extractSpec,
+  generateTypes,
+  MODULE_ID,
+  RESOLVED_MODULE_ID,
+  DEV_API_PREFIX,
+  dtsTemplate,
+  clientJsTemplate,
+  virtualModuleTemplate,
+  regenerateTypes,
+  writeGeneratedFiles,
+  patchTsConfig
+};

package/dist/chunk-QBXBYTBE.js

@@ -0,0 +1,61 @@
+// src/config.ts
+import { existsSync } from "fs";
+import { resolve, dirname } from "path";
+import { createRequire } from "module";
+function defineConfig(config) {
+  return config;
+}
+var CONFIG_FILENAMES = [
+  "shiftapi.config.ts",
+  "shiftapi.config.js",
+  "shiftapi.config.mjs"
+];
+async function loadConfig(startDir, configPath) {
+  let resolvedPath;
+  if (configPath) {
+    resolvedPath = resolve(startDir, configPath);
+    if (!existsSync(resolvedPath)) {
+      throw new Error(`[shiftapi] Config file not found: ${resolvedPath}`);
+    }
+  } else {
+    resolvedPath = findConfigFile(startDir);
+    if (!resolvedPath) {
+      throw new Error(
+        `[shiftapi] Could not find shiftapi.config.ts (searched upward from ${startDir}). Create one with: import { defineConfig } from "shiftapi"`
+      );
+    }
+  }
+  const require2 = createRequire(import.meta.url);
+  const { createJiti } = require2("jiti");
+  const jiti = createJiti(resolvedPath);
+  const mod = await jiti.import(resolvedPath);
+  const config = mod.default ?? mod;
+  if (!config.server) {
+    throw new Error(
+      `[shiftapi] Config at ${resolvedPath} must specify a "server" field (path to Go entry point)`
+    );
+  }
+  return { config, configDir: dirname(resolvedPath) };
+}
+function findConfigFile(startDir) {
+  let dir = resolve(startDir);
+  const root = resolve("/");
+  while (true) {
+    for (const name of CONFIG_FILENAMES) {
+      const candidate = resolve(dir, name);
+      if (existsSync(candidate)) {
+        return candidate;
+      }
+    }
+    const parent = dirname(dir);
+    if (parent === dir || dir === root) {
+      return void 0;
+    }
+    dir = parent;
+  }
+}
+
+export {
+  defineConfig,
+  loadConfig
+};

package/dist/index-PUAivaXi.d.ts

@@ -0,0 +1,26 @@
+interface ShiftAPIConfig {
+    /** Path to the Go server entry point, relative to the config file (e.g., "./cmd/server") */
+    server: string;
+    /**
+     * Fallback base URL for the API client (default: "/").
+     * Can be overridden at build time via the `VITE_SHIFTAPI_BASE_URL` env var.
+     */
+    baseUrl?: string;
+    /**
+     * Address the Go server listens on (default: "http://localhost:8080").
+     * Used to auto-configure the Vite proxy in dev mode.
+     */
+    url?: string;
+}
+/** Identity helper for IntelliSense in `shiftapi.config.ts` files. */
+declare function defineConfig(config: ShiftAPIConfig): ShiftAPIConfig;
+/**
+ * Walk up from `startDir` looking for a shiftapi config file.
+ * Returns the parsed config and the directory containing it.
+ */
+declare function loadConfig(startDir: string, configPath?: string): Promise<{
+    config: ShiftAPIConfig;
+    configDir: string;
+}>;
+
+export { type ShiftAPIConfig as S, defineConfig as d, loadConfig as l };

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { S as ShiftAPIConfig, d as defineConfig } from './index-PUAivaXi.js';

package/dist/index.js

@@ -0,0 +1,6 @@
+import {
+  defineConfig
+} from "./chunk-QBXBYTBE.js";
+export {
+  defineConfig
+};

package/dist/internal.d.ts

@@ -0,0 +1,32 @@
+export { S as ShiftAPIConfig, d as defineConfig, l as loadConfig } from './index-PUAivaXi.js';
+
+declare function regenerateTypes(serverEntry: string, goRoot: string, baseUrl: string, isDev: boolean, previousTypes: string): Promise<{
+    types: string;
+    virtualModuleSource: string;
+    changed: boolean;
+}>;
+declare function writeGeneratedFiles(typesRoot: string, generatedDts: string, baseUrl: string): void;
+declare function patchTsConfig(tsconfigDir: string, typesRoot: string): void;
+
+/**
+ * Extracts the OpenAPI spec from a Go shiftapi server by running it with
+ * the SHIFTAPI_EXPORT_SPEC environment variable set. The Go binary writes
+ * the spec to the given path and exits immediately.
+ */
+declare function extractSpec(serverEntry: string, goRoot: string): object;
+
+/**
+ * Generates TypeScript type definitions from an OpenAPI spec object
+ * using the openapi-typescript programmatic API.
+ */
+declare function generateTypes(spec: object): Promise<string>;
+
+declare function dtsTemplate(generatedTypes: string): string;
+declare function clientJsTemplate(baseUrl: string): string;
+declare function virtualModuleTemplate(baseUrl: string, devApiPrefix?: string): string;
+
+declare const MODULE_ID = "@shiftapi/client";
+declare const RESOLVED_MODULE_ID: string;
+declare const DEV_API_PREFIX = "/__shiftapi";
+
+export { DEV_API_PREFIX, MODULE_ID, RESOLVED_MODULE_ID, clientJsTemplate, dtsTemplate, extractSpec, generateTypes, patchTsConfig, regenerateTypes, virtualModuleTemplate, writeGeneratedFiles };

package/dist/internal.js

@@ -0,0 +1,32 @@
+import {
+  DEV_API_PREFIX,
+  MODULE_ID,
+  RESOLVED_MODULE_ID,
+  clientJsTemplate,
+  dtsTemplate,
+  extractSpec,
+  generateTypes,
+  patchTsConfig,
+  regenerateTypes,
+  virtualModuleTemplate,
+  writeGeneratedFiles
+} from "./chunk-M6SOET3R.js";
+import {
+  defineConfig,
+  loadConfig
+} from "./chunk-QBXBYTBE.js";
+export {
+  DEV_API_PREFIX,
+  MODULE_ID,
+  RESOLVED_MODULE_ID,
+  clientJsTemplate,
+  defineConfig,
+  dtsTemplate,
+  extractSpec,
+  generateTypes,
+  loadConfig,
+  patchTsConfig,
+  regenerateTypes,
+  virtualModuleTemplate,
+  writeGeneratedFiles
+};

package/dist/prepare.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/prepare.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+import {
+  extractSpec,
+  generateTypes,
+  patchTsConfig,
+  writeGeneratedFiles
+} from "./chunk-M6SOET3R.js";
+import {
+  loadConfig
+} from "./chunk-QBXBYTBE.js";
+
+// src/prepare.ts
+import { resolve } from "path";
+var command = process.argv[2];
+if (command !== "prepare") {
+  console.error(`Usage: shiftapi prepare`);
+  process.exit(1);
+}
+async function main() {
+  const cwd = process.cwd();
+  console.log("[shiftapi] Preparing...");
+  const { config, configDir } = await loadConfig(cwd);
+  const serverEntry = config.server;
+  const baseUrl = config.baseUrl ?? "/";
+  const goRoot = configDir;
+  const spec = extractSpec(serverEntry, resolve(goRoot));
+  const types = await generateTypes(spec);
+  writeGeneratedFiles(configDir, types, baseUrl);
+  patchTsConfig(cwd, configDir);
+  console.log("[shiftapi] Done. Generated .shiftapi/client.d.ts and .shiftapi/client.js");
+}
+main().catch((err) => {
+  console.error(err instanceof Error ? err.message : String(err));
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "shiftapi",
+  "version": "0.0.14",
+  "description": "CLI and codegen for shiftapi – fully-typed TypeScript clients from Go servers",
+  "author": "Frank Chiarulli Jr. <frank@frankchiarulli.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/fcjr/shiftapi",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/fcjr/shiftapi",
+    "directory": "packages/shiftapi"
+  },
+  "bugs": {
+    "url": "https://github.com/fcjr/shiftapi/issues"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "default": "./dist/internal.js"
+    }
+  },
+  "bin": {
+    "shiftapi": "./dist/prepare.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts src/internal.ts src/prepare.ts --format esm --dts",
+    "dev": "tsup src/index.ts src/internal.ts src/prepare.ts --format esm --dts --watch",
+    "test": "vitest run"
+  },
+  "dependencies": {
+    "comment-json": "^4.5.1",
+    "jiti": "^2.6.1",
+    "openapi-typescript": "^7.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.2.3",
+    "tsup": "^8.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^2.0.0"
+  }
+}