@stacksjs/server 0.70.96 → 0.70.97

package/dist/imports.d.ts

@@ -11,6 +11,8 @@ export declare function generateAutoImportFiles(): Promise<void>;
  * available globally without explicit imports.
  */
 export declare function initiateImports(): void;
+/** Generate TypeScript declarations for the globals injected by the server. */
+export declare function generateServerAutoImportTypes(): Promise<void>;
 /**
  * Import and inject all auto-imports into globalThis for runtime access.
  * Call this early in your application startup.

package/dist/imports.js

@@ -5,6 +5,7 @@ import { log } from "@stacksjs/logging";
 import { path } from "@stacksjs/path";
 import { autoImports, generateRuntimeIndex, generateGlobalsScript } from "bun-plugin-auto-imports";
 import { globSync } from "@stacksjs/storage";
+import { primitiveAutoImportEntries, primitiveModules } from "./primitive-imports";
 const OPTIONAL_MODEL_MODULES = {
   commerce: ["config/commerce.ts"],
   Content: ["config/cms.ts", "config/blog.ts"],
@@ -91,6 +92,7 @@ async function generateDefineModelIndex(entries, outputPath) {
 `);
 }
 export async function generateAutoImportFiles() {
+  await generateServerAutoImportTypes();
   const userFunctionsPath = path.resourcesPath("functions"), defaultFunctionsPath = path.storagePath("framework/defaults/functions"), functionsPath = userFunctionsPath, outputDir = path.storagePath("framework/auto-imports"), userModelsPath = path.userModelsPath(), defaultModelDirs = resolveDefaultModelDirs(), [defaultsRoot = path.storagePath("framework/defaults/app/Models"), ...enabledSubdirs] = defaultModelDirs, userJobsPath = path.userJobsPath(), userControllersPath = path.userControllersPath(), defaultControllersPath = path.storagePath("framework/defaults/app/Controllers");
   await Bun.write(`${outputDir}/.gitkeep`, "");
   const functionsIndexPath = `${outputDir}/functions.ts`;
@@ -148,7 +150,12 @@ export function initiateImports() {
     as: exp.name
   })), options = {
     dts: path.storagePath("framework/types/server-auto-imports.d.ts"),
-    imports: [...defineModelImports, ...jobImports, ...controllerImports],
+    imports: [
+      ...primitiveAutoImportEntries(),
+      ...defineModelImports,
+      ...jobImports,
+      ...controllerImports
+    ],
     dirs: [functionsPath, defaultFunctionsPath],
     eslint: {
       enabled: !0,
@@ -160,37 +167,41 @@ export function initiateImports() {
     console.error("[Server] Failed to generate auto-import files:", err);
   });
 }
+export async function generateServerAutoImportTypes() {
+  const userModelsPath = path.userModelsPath(), defaultModelDirs = resolveDefaultModelDirs(), [defaultsRoot = path.storagePath("framework/defaults/app/Models"), ...enabledSubdirs] = defaultModelDirs, modelExports = [
+    ...scanDefineModelExports(userModelsPath),
+    ...scanDefineModelExports(defaultsRoot, { recursive: !1 }),
+    ...enabledSubdirs.flatMap((dir) => scanDefineModelExports(dir))
+  ], jobExports = scanDefineModelExports(path.userJobsPath()), controllerExports = [
+    ...scanDefineModelExports(path.userControllersPath()),
+    ...scanDefineModelExports(path.storagePath("framework/defaults/app/Controllers"))
+  ], seen = new Set, valueExports = [...modelExports, ...jobExports, ...controllerExports].filter((exp) => !GLOBAL_SHADOW_BLOCKLIST.has(exp.name)).filter((exp) => {
+    if (seen.has(exp.name))
+      return !1;
+    seen.add(exp.name);
+    return !0;
+  }), outputPath = path.storagePath("framework/types/server-auto-imports.d.ts"), outputDir = dirname(outputPath), declaredValues = new Set(valueExports.map((exp) => exp.name)), lines = [
+    "// Generated by Stacks server auto-imports",
+    "// This file is regenerated automatically when the API starts.",
+    "export {}",
+    "declare global {"
+  ];
+  for (const { from, name, as } of primitiveAutoImportEntries())
+    if (!declaredValues.has(as))
+      lines.push(`  const ${as}: typeof import('${from}')['${name}']`);
+  for (const exp of valueExports) {
+    const importPath = relative(outputDir, exp.file).replace(/\\/g, "/").replace(/\.ts$/, ""), relativePath = importPath.startsWith(".") ? importPath : `./${importPath}`;
+    lines.push(`  const ${exp.name}: typeof import('${relativePath}')['default']`);
+  }
+  lines.push("}", "");
+  await Bun.write(outputPath, lines.join(`
+`));
+}
 export async function injectGlobalAutoImports() {
   if (globalThis.__stacksAutoImportsInjected)
     return;
   globalThis.__stacksAutoImportsInjected = !0;
-  const errors = [], primitiveModules = [
-    ["@stacksjs/types", ["Every", "ExitCode"]],
-    ["@stacksjs/path", ["path"]],
-    ["@stacksjs/error-handling", ["HttpError", "handleError"]],
-    ["@stacksjs/logging", ["log"]],
-    ["@stacksjs/config", ["config"]],
-    ["@stacksjs/validation", ["schema"]],
-    ["@stacksjs/router", ["response", "request", "route", "Middleware", "url"]],
-    ["@stacksjs/storage", ["storage", "fs"]],
-    ["@stacksjs/orm", ["defineModel", "toAttrs"]],
-    ["@stacksjs/database", ["db", "sql"]],
-    ["@stacksjs/email", ["mail", "template"]],
-    ["@stacksjs/queue", ["Job"]],
-    ["@stacksjs/scheduler", ["schedule"]],
-    ["@stacksjs/actions", ["Action"]],
-    ["@stacksjs/auth", ["Auth", "register", "sessionCheck"]],
-    ["@stacksjs/events", ["dispatch", "listen", "emitter"]],
-    ["@stacksjs/feature-flags", ["Feature"]],
-    ["@stacksjs/security", ["makeHash", "verifyHash"]],
-    ["@stacksjs/collections", ["collect"]],
-    ["@stacksjs/cli", ["quotes"]],
-    ["@stacksjs/notifications", ["notify", "useNotification", "useEmail", "useSMS", "useChat", "useDatabase"]],
-    ["@stacksjs/realtime", ["emit", "emitToUser", "emitToUsers", "createChannel", "dispatchBroadcast"]],
-    ["@stacksjs/i18n", ["I18n", "t", "tc", "te", "setLocale", "getLocale"]],
-    ["@stacksjs/stx", ["state", "derived", "effect"]],
-    ["@stacksjs/browser", ["useDark", "usePreferredDark", "useToggle", "useStorage"]]
-  ], importWithTimeout = async (pkg) => {
+  const errors = [], importWithTimeout = async (pkg) => {
     return Promise.race([
       import(pkg),
       new Promise((_, reject) => setTimeout(() => reject(Error(`auto-import timed out: ${pkg}`)), 4000))

package/dist/primitive-imports.d.ts

@@ -0,0 +1,10 @@
+export declare function primitiveAutoImportEntries(): void;
+/**
+ * Runtime values Stacks makes available as server-side globals.
+ *
+ * This list is shared by runtime injection and the auto-import declaration
+ * generator so globals such as `db` have the same behavior in Bun and in the
+ * TypeScript language service.
+ */
+export declare const primitiveModules: readonly PrimitiveModule[];
+export type PrimitiveModule = readonly [module: string, names: readonly string[]];

package/dist/primitive-imports.js

@@ -0,0 +1,29 @@
+export const primitiveModules = [
+  ["@stacksjs/path", ["path"]],
+  ["@stacksjs/error-handling", ["HttpError", "handleError"]],
+  ["@stacksjs/logging", ["log"]],
+  ["@stacksjs/config", ["config"]],
+  ["@stacksjs/validation", ["schema"]],
+  ["@stacksjs/router", ["response", "request", "route", "Middleware", "url"]],
+  ["@stacksjs/storage", ["storage", "fs"]],
+  ["@stacksjs/orm", ["defineModel", "toAttrs"]],
+  ["@stacksjs/database", ["db", "sql"]],
+  ["@stacksjs/email", ["mail", "template"]],
+  ["@stacksjs/queue", ["Job"]],
+  ["@stacksjs/scheduler", ["schedule"]],
+  ["@stacksjs/actions", ["Action"]],
+  ["@stacksjs/auth", ["Auth", "register", "sessionCheck"]],
+  ["@stacksjs/events", ["dispatch", "listen", "emitter"]],
+  ["@stacksjs/feature-flags", ["Feature"]],
+  ["@stacksjs/security", ["makeHash", "verifyHash"]],
+  ["@stacksjs/collections", ["collect"]],
+  ["@stacksjs/cli", ["quotes"]],
+  ["@stacksjs/notifications", ["notify", "useNotification", "useEmail", "useSMS", "useChat", "useDatabase"]],
+  ["@stacksjs/realtime", ["emit", "emitToUser", "emitToUsers", "createChannel", "dispatchBroadcast"]],
+  ["@stacksjs/i18n", ["I18n", "t", "tc", "te", "setLocale", "getLocale"]],
+  ["@stacksjs/stx", ["state", "derived", "effect"]],
+  ["@stacksjs/browser", ["useDark", "usePreferredDark", "useToggle", "useStorage"]]
+];
+export function primitiveAutoImportEntries() {
+  return primitiveModules.flatMap(([from, names]) => names.map((name) => ({ from, name, as: name })));
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/server",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.96",
+  "version": "0.70.97",
   "description": "Local development and production-ready.",
   "author": "Chris Breuer",
   "contributors": [
@@ -53,11 +53,11 @@
     "prepublishOnly": "bun run build"
   },
   "devDependencies": {
-    "@stacksjs/config": "0.70.96",
+    "@stacksjs/config": "0.70.97",
     "better-dx": "^0.2.16",
-    "@stacksjs/path": "0.70.96",
-    "@stacksjs/router": "0.70.96",
-    "@stacksjs/validation": "0.70.96"
+    "@stacksjs/path": "0.70.97",
+    "@stacksjs/router": "0.70.97",
+    "@stacksjs/validation": "0.70.97"
   },
   "dependencies": {
     "bun-plugin-auto-imports": "^0.4.0"