@stacksjs/config 0.70.87 → 0.70.90

package/dist/config.d.ts

@@ -81,6 +81,7 @@ export declare let dns: StacksOptions['dns'];
 export declare let docs: StacksOptions['docs'];
 export declare let email: StacksOptions['email'];
 export declare let errors: StacksOptions['errors'];
+export declare let featureFlags: StacksOptions['featureFlags'];
 export declare let git: StacksOptions['git'];
 export declare let hashing: StacksOptions['hashing'];
 export declare let library: StacksOptions['library'];

package/dist/config.js

@@ -0,0 +1,109 @@
+import { defaults } from "./defaults";
+import { overrides, overridesReady } from "./overrides";
+function readMerged(prop) {
+  const o = overrides[prop];
+  if (o !== void 0 && (typeof o !== "object" || Object.keys(o).length > 0))
+    return o;
+  return defaults[prop];
+}
+const proxyTarget = function configProxyTarget() {};
+export const config = new Proxy(proxyTarget, {
+  get(_t, prop) {
+    return readMerged(prop);
+  },
+  has(_t, prop) {
+    return prop in overrides || prop in defaults;
+  },
+  ownKeys() {
+    return Array.from(new Set([
+      ...Object.keys(overrides),
+      ...Object.keys(defaults)
+    ]));
+  },
+  getOwnPropertyDescriptor(_t, prop) {
+    if (typeof prop !== "string")
+      return;
+    if (!(prop in overrides) && !(prop in defaults))
+      return;
+    return {
+      enumerable: !0,
+      configurable: !0,
+      writable: !0,
+      value: readMerged(prop)
+    };
+  },
+  isExtensible() {
+    return !0;
+  },
+  preventExtensions() {
+    return !1;
+  }
+});
+export async function awaitConfig() {
+  await overridesReady;
+  return config;
+}
+const DB_READY = Symbol.for("@stacksjs/config:databaseReady"), globalScope = globalThis;
+export async function awaitDatabaseConfig() {
+  await overridesReady;
+  const deadline = Date.now() + 5000;
+  while (!globalScope[DB_READY] && Date.now() < deadline)
+    await new Promise((r) => setTimeout(r, 25));
+  if (!globalScope[DB_READY])
+    console.warn("[config] awaitDatabaseConfig() timed out \u2014 database driver did not signal readiness within 5s");
+  return config;
+}
+export function markDatabaseReady() {
+  globalScope[DB_READY] = !0;
+}
+export function getConfig() {
+  return config;
+}
+export let { ai, analytics, app, auth, realtime, cache, cloud, cli, dashboard, database, dns, docs, email, errors, featureFlags, git, hashing, library, logging, notification, payment, ports, queue, security, saas, searchEngine, services, filesystems, team, ui } = config;
+overridesReady.then(() => {
+  ai = config.ai;
+  analytics = config.analytics;
+  app = config.app;
+  auth = config.auth;
+  realtime = config.realtime;
+  cache = config.cache;
+  cloud = config.cloud;
+  cli = config.cli;
+  dashboard = config.dashboard;
+  database = config.database;
+  dns = config.dns;
+  docs = config.docs;
+  email = config.email;
+  errors = config.errors;
+  featureFlags = config.featureFlags;
+  git = config.git;
+  hashing = config.hashing;
+  library = config.library;
+  logging = config.logging;
+  notification = config.notification;
+  payment = config.payment;
+  ports = config.ports;
+  queue = config.queue;
+  security = config.security;
+  saas = config.saas;
+  searchEngine = config.searchEngine;
+  services = config.services;
+  filesystems = config.filesystems;
+  team = config.team;
+  ui = config.ui;
+}).catch(() => {});
+
+export * from "./helpers";
+export { defaults, overrides, overridesReady };
+export function determineAppEnv() {
+  const env = config.app?.env;
+  if (env === "local" || env === "development")
+    return "dev";
+  if (env === "staging")
+    return "stage";
+  if (env === "production")
+    return "prod";
+  if (!env)
+    throw Error("Couldn't determine app environment");
+  return env;
+}

package/dist/defaults.js

@@ -0,0 +1,626 @@
+var {require}=import.meta;import { commandsPath, projectPath, userDatabasePath } from "@stacksjs/path";
+export const FRAMEWORK_DEFAULTS = {
+  awsRegion: "us-east-1",
+  timezone: "UTC",
+  noReplyEmail: "no-reply@stacksjs.com",
+  fallbackDomain: "stacks.localhost"
+};
+function deriveAppDefaults() {
+  try {
+    const pkgPath = projectPath("package.json"), raw = (require(pkgPath).name ?? "").trim();
+    if (!raw)
+      return { name: "Stacks", url: "stacks.localhost" };
+    const slug = raw.replace(/^@[^/]+\//, "").toLowerCase();
+    return { name: slug.replace(/[-_]+/g, " ").replace(/(^|\s)\w/g, (c) => c.toUpperCase()), url: `${slug}.localhost` };
+  } catch {
+    return { name: "Stacks", url: "stacks.localhost" };
+  }
+}
+const appDefaults = deriveAppDefaults();
+export const defaults = {
+  cms: { enabled: !1 },
+  commerce: { enabled: !1 },
+  marketing: { enabled: !1 },
+  monitoring: { enabled: !1 },
+  ai: {
+    deploy: !1,
+    models: [
+      "anthropic.claude-sonnet-4-20250514-v1:0",
+      "anthropic.claude-haiku-4-20250514-v1:0",
+      "anthropic.claude-3-5-sonnet-20241022-v2:0",
+      "amazon.titan-embed-text-v2:0",
+      "amazon.titan-text-premier-v1:0",
+      "amazon.titan-image-generator-v2:0",
+      "meta.llama3-1-70b-instruct-v1:0",
+      "meta.llama3-1-8b-instruct-v1:0"
+    ]
+  },
+  auth: {
+    username: "email",
+    password: "password",
+    defaultTokenName: "auth-token",
+    tokenExpiry: 3600000,
+    refreshTokenExpiry: 2592000000,
+    defaultAbilities: ["*"]
+  },
+  realtime: {
+    driver: "pusher"
+  },
+  analytics: {
+    driver: void 0
+  },
+  app: {
+    name: appDefaults.name,
+    description: "A Stacks application.",
+    env: "local",
+    url: appDefaults.url,
+    debug: !0,
+    key: "",
+    timezone: FRAMEWORK_DEFAULTS.timezone,
+    locale: "en",
+    fallbackLocale: "en",
+    cipher: "AES-256-CBC",
+    docMode: !1,
+    redirectUrls: [],
+    maintenanceMode: !1,
+    comingSoonMode: !1,
+    comingSoonSecret: ""
+  },
+  cli: {
+    name: "My Custom CLI",
+    command: "my-custom-cli",
+    description: "Stacks is a full-stack framework for TypeScript.",
+    source: commandsPath(),
+    deploy: !1
+  },
+  cache: {
+    driver: "memory",
+    prefix: "stx",
+    ttl: 3600,
+    maxKeys: -1,
+    useClones: !0,
+    drivers: {
+      redis: {
+        host: "localhost",
+        port: 6379,
+        username: "",
+        password: "",
+        database: 0,
+        tls: !1
+      },
+      memory: {
+        maxKeys: -1,
+        checkPeriod: 600,
+        deleteOnExpire: !0
+      }
+    }
+  },
+  featureFlags: {
+    default: "memory",
+    missing: "false",
+    drivers: {
+      memory: { cloneValues: !0 },
+      database: { table: "feature_flags", autoCreate: !1 }
+    }
+  },
+  cloud: {
+    infrastructure: {
+      type: "serverless",
+      driver: "aws",
+      environments: ["production", "staging", "development"],
+      firewall: {
+        enabled: !0,
+        countryCodes: [],
+        ipAddresses: [],
+        queryString: [],
+        httpHeaders: [],
+        rateLimitPerMinute: 1000,
+        useIpReputationLists: !0,
+        useKnownBadInputsRuleSet: !0
+      },
+      cdn: {
+        allowedMethods: "GET_HEAD",
+        cachedMethods: "GET_HEAD",
+        minTtl: 0,
+        defaultTtl: 86400,
+        maxTtl: 31536000,
+        compress: !0,
+        priceClass: "PriceClass_All",
+        originShieldRegion: FRAMEWORK_DEFAULTS.awsRegion,
+        cookieBehavior: "none",
+        allowList: {
+          cookies: [],
+          headers: [],
+          queryStrings: []
+        },
+        realtimeLogs: {
+          enabled: !0,
+          samplingRate: 2
+        }
+      },
+      fileSystem: !1,
+      storage: {}
+    },
+    sites: {
+      root: "",
+      path: ""
+    }
+  },
+  dashboard: {
+    sections: {
+      library: { enabled: !0 },
+      content: { enabled: !0 },
+      commerce: { enabled: !0 },
+      marketing: { enabled: !0 },
+      analytics: { enabled: !0 },
+      management: { enabled: !0 },
+      utilities: { enabled: !0 }
+    }
+  },
+  database: {
+    default: "sqlite",
+    logging: !1,
+    connections: {
+      sqlite: {
+        database: userDatabasePath("stacks.sqlite"),
+        prefix: ""
+      }
+    },
+    migrations: "migrations",
+    migrationLocks: "migration_locks"
+  },
+  dns: {
+    driver: "aws",
+    a: [],
+    aaaa: [],
+    cname: [],
+    mx: [],
+    txt: []
+  },
+  docs: {
+    lang: "en-US",
+    title: "Stacks",
+    description: "Rapid application, cloud & library framework.",
+    lastUpdated: !0,
+    deploy: !1,
+    themeConfig: {
+      editLink: {
+        pattern: "https://github.com/stacksjs/stacks/edit/main/docs/docs/:path",
+        text: "Edit this page on GitHub"
+      },
+      footer: {
+        message: "Released under the MIT License.",
+        copyright: "Copyright \xA9 2024-present Stacks.js, Inc."
+      }
+    }
+  },
+  email: {
+    from: {
+      name: "Stacks",
+      address: FRAMEWORK_DEFAULTS.noReplyEmail
+    },
+    mailboxes: [],
+    server: {
+      enabled: !0,
+      scan: !0
+    }
+  },
+  errors: {
+    messages: {
+      string: "The {{ field }} field must be a string",
+      email: "The {{ field }} field must be a valid email address",
+      regex: "The {{ field }} field format is invalid",
+      url: "The {{ field }} field must be a valid URL",
+      activeUrl: "The {{ field }} field must be a valid URL",
+      alpha: "The {{ field }} field must contain only letters",
+      alphaNumeric: "The {{ field }} field must contain only letters and numbers",
+      "min(": "The {{ field }} field must have at least {{ min }} characters",
+      maxLength: "The {{ field }} field must not be greater than {{ max }} characters",
+      fixedLength: "The {{ field }} field must be {{ size }} characters long",
+      confirmed: "The {{ field }} field and {{ otherField }} field must be the same",
+      endsWith: "The {{ field }} field must end with {{ substring }}",
+      startsWith: "The {{ field }} field must start with {{ substring }}",
+      sameAs: "The {{ field }} field and {{ otherField }} field must be the same",
+      notSameAs: "The {{ field }} field and {{ otherField }} field must be different",
+      in: "The selected {{ field }} is invalid",
+      notIn: "The selected {{ field }} is invalid",
+      ipAddress: "The {{ field }} field must be a valid IP address",
+      uuid: "The {{ field }} field must be a valid UUID",
+      ascii: "The {{ field }} field must only contain ASCII characters",
+      creditCard: "The {{ field }} field must be a valid {{ providersList }} card number",
+      hexCode: "The {{ field }} field must be a valid hex color code",
+      iban: "The {{ field }} field must be a valid IBAN number",
+      jwt: "The {{ field }} field must be a valid JWT token",
+      coordinates: "The {{ field }} field must contain latitude and longitude coordinates",
+      mobile: "The {{ field }} field must be a valid mobile phone number",
+      passport: "The {{ field }} field must be a valid passport number",
+      postalCode: "The {{ field }} field must be a valid postal code",
+      boolean: "The value must be a boolean",
+      number: "The {{ field }} field must be a number",
+      min: "The {{ field }} field must be at least {{ min }}",
+      max: "The {{ field }} field must not be greater than {{ max }}",
+      range: "The {{ field }} field must be between {{ min }} and {{ max }}",
+      positive: "The {{ field }} field must be positive",
+      negative: "The {{ field }} field must be negative",
+      decimal: "The {{ field }} field must have {{ digits }} decimal places",
+      withoutDecimals: "The {{ field }} field must not have decimal places",
+      date: "The {{ field }} field must be a datetime value",
+      "date.equals": "The {{ field }} field must be a date equal to {{ expectedValue }}",
+      "date.after": "The {{ field }} field must be a date after {{ expectedValue }}",
+      "date.before": "The {{ field }} field must be a date before {{ expectedValue }}",
+      "date.afterOrEqual": "The {{ field }} field must be a date after or equal to {{ expectedValue }}",
+      "date.beforeOrEqual": "The {{ field }} field must be a date before or equal to {{ expectedValue }}",
+      "date.sameAs": "The {{ field }} field and {{ otherField }} field must be the same",
+      "date.notSameAs": "The {{ field }} field and {{ otherField }} field must be different",
+      "date.afterField": "The {{ field }} field must be a date after {{ otherField }}",
+      accepted: "The {{ field }} field must be accepted",
+      enum: "The selected {{ field }} is invalid",
+      literal: "The {{ field }} field must be {{ expectedValue }}",
+      object: "The {{ field }} field must be an object",
+      record: "The {{ field }} field must be an object",
+      "record.min(": "The {{ field }} field must have at least {{ min }} items",
+      "record.maxLength": "The {{ field }} field must not have more than {{ max }} items",
+      "record.fixedLength": "The {{ field }} field must contain {{ size }} items",
+      array: "The {{ field }} field must be an array",
+      "array.min(": "The {{ field }} field must have at least {{ min }} items",
+      "array.maxLength": "The {{ field }} field must not have more than {{ max }} items",
+      "array.fixedLength": "The {{ field }} field must contain {{ size }} items",
+      notEmpty: "The {{ field }} field must not be empty",
+      distinct: "The {{ field }} field has duplicate values",
+      tuple: "The {{ field }} field must be an array",
+      union: "Invalid value provided for {{ field }} field",
+      unionGroup: "Invalid value provided for {{ field }} field",
+      unionOfTypes: "Invalid value provided for {{ field }} field"
+    }
+  },
+  git: {
+    hooks: {
+      "pre-commit": "lint-staged"
+    },
+    scopes: [
+      "",
+      "ci",
+      "deps",
+      "dx",
+      "release",
+      "docs",
+      "test",
+      "core",
+      "actions",
+      "arrays",
+      "auth",
+      "build",
+      "cache",
+      "cli",
+      "cloud",
+      "collections",
+      "config",
+      "database",
+      "datetime",
+      "docs",
+      "errors",
+      "git",
+      "lint",
+      "x-ray",
+      "modules",
+      "notifications",
+      "objects",
+      "path",
+      "realtime",
+      "router",
+      "buddy",
+      "security",
+      "server",
+      "storage",
+      "strings",
+      "tests",
+      "types",
+      "ui",
+      "utils"
+    ],
+    messages: {
+      type: "Select the type of change that you're committing:",
+      scope: "Select the SCOPE of this change (optional):",
+      customScope: "Select the SCOPE of this change:",
+      subject: `Write a SHORT, IMPERATIVE tense description of the change:
+`,
+      body: `Provide a LONGER description of the change (optional). Use "|" to break new line:
+`,
+      breaking: `List any BREAKING CHANGES (optional). Use "|" to break new line:
+`,
+      footerPrefixesSelect: "Select the ISSUES type of the change list by this change (optional):",
+      customFooterPrefixes: "Input ISSUES prefix:",
+      footer: `List any ISSUES by this change. E.g.: #31, #34:
+`,
+      confirmCommit: "Are you sure you want to proceed with the commit above?"
+    },
+    types: [
+      {
+        value: "feat",
+        name: "feat:     \u2728  A new feature",
+        emoji: ":sparkles:"
+      },
+      { value: "fix", name: "fix:      \uD83D\uDC1B  A bug fix", emoji: ":bug:" },
+      {
+        value: "docs",
+        name: "docs:     \uD83D\uDCDD  Documentation only changes",
+        emoji: ":memo:"
+      },
+      {
+        value: "style",
+        name: "style:    \uD83D\uDC84  Changes that do not affect the meaning of the code",
+        emoji: ":lipstick:"
+      },
+      {
+        value: "refactor",
+        name: "refactor: \u267B\uFE0F   A code change that neither fixes a bug nor adds a feature",
+        emoji: ":recycle:"
+      },
+      {
+        value: "perf",
+        name: "perf:     \u26A1\uFE0F  A code change that improves performance",
+        emoji: ":zap:"
+      },
+      {
+        value: "test",
+        name: "test:     \u2705  Adding missing tests or adjusting existing tests",
+        emoji: ":white_check_mark:"
+      },
+      {
+        value: "build",
+        name: "build:    \uD83D\uDCE6\uFE0F  Changes that affect the build system or external dependencies",
+        emoji: ":package:"
+      },
+      {
+        value: "ci",
+        name: "ci:       \uD83C\uDFA1  Changes to our CI configuration files and scripts",
+        emoji: ":ferris_wheel:"
+      },
+      {
+        value: "chore",
+        name: "chore:    \uD83D\uDD28  Other changes that don't modify src or test files",
+        emoji: ":hammer:"
+      },
+      {
+        value: "revert",
+        name: "revert:   \u23EA\uFE0F  Reverts a previous commit",
+        emoji: ":rewind:"
+      }
+    ]
+  },
+  hashing: {
+    driver: "bcrypt",
+    bcrypt: {
+      rounds: 12
+    },
+    argon2: {
+      memory: 65536,
+      time: 2
+    }
+  },
+  library: {
+    name: "hello-world",
+    owner: "@stacksjs",
+    repository: "stacksjs/stacks",
+    license: "MIT",
+    author: "",
+    contributors: [],
+    defaultLanguage: "en",
+    webComponents: {
+      name: "hello-world-elements",
+      description: "Your framework agnostic web component library description.",
+      keywords: ["custom-elements", "web-components", "library", "framework-agnostic", "typescript", "javascript"],
+      tags: [
+        {
+          name: ["HelloWorld", "AppHelloWorld"],
+          description: "The Hello World custom element, built via this framework.",
+          attributes: [
+            {
+              name: "greeting",
+              description: "The greeting."
+            }
+          ]
+        }
+      ]
+    },
+    functions: {
+      name: "hello-world-fx",
+      description: "Your function library description.",
+      keywords: ["functions", "composables", "library", "typescript", "javascript"],
+      shouldGenerateSourcemap: !1,
+      files: ["counter", "dark"]
+    }
+  },
+  logging: {
+    logsPath: "storage/logs/stacks.log",
+    deploymentsPath: "storage/logs/deployments.log"
+  },
+  notification: {
+    default: "email"
+  },
+  payment: {
+    driver: "stripe"
+  },
+  ports: {
+    frontend: 3000,
+    backend: 3001,
+    admin: 3002,
+    library: 3003,
+    desktop: 3004,
+    email: 3005,
+    docs: 3006,
+    inspect: 3007,
+    api: 3008,
+    systemTray: 3009,
+    database: 3010
+  },
+  queue: {
+    default: "sync",
+    connections: {
+      sync: {
+        driver: "sync"
+      },
+      database: {
+        driver: "database",
+        table: "jobs",
+        queue: "default",
+        retryAfter: 90
+      },
+      redis: {
+        driver: "redis",
+        queue: "default",
+        retryAfter: 90
+      },
+      sqs: {
+        driver: "sqs",
+        key: "",
+        secret: "",
+        prefix: "",
+        suffix: "",
+        queue: "default",
+        region: FRAMEWORK_DEFAULTS.awsRegion
+      }
+    }
+  },
+  saas: {
+    plans: [
+      {
+        productName: "Stacks Hobby",
+        description: "All the Stacks features.",
+        pricing: [
+          {
+            key: "stacks_hobby_monthly",
+            price: 3900,
+            interval: "month",
+            currency: "usd"
+          },
+          {
+            key: "stacks_hobby_yearly",
+            price: 37900,
+            interval: "year",
+            currency: "usd"
+          }
+        ],
+        metadata: {
+          createdBy: "admin",
+          version: "1.0.0"
+        }
+      },
+      {
+        productName: "Stacks Pro",
+        description: "All the Stacks features, including being able to invite team members.",
+        pricing: [
+          {
+            key: "stacks_pro_monthly",
+            price: 5900,
+            interval: "month",
+            currency: "usd"
+          },
+          {
+            key: "stacks_pro_yearly",
+            price: 57900,
+            interval: "year",
+            currency: "usd"
+          }
+        ],
+        metadata: {
+          createdBy: "admin",
+          version: "1.0.0"
+        }
+      }
+    ],
+    webhook: {
+      endpoint: "/webhooks/stripe",
+      secret: ""
+    },
+    currencies: ["usd"],
+    coupons: [
+      {
+        code: "SUMMER2024",
+        amountOff: 500,
+        duration: "once"
+      }
+    ],
+    products: [
+      {
+        name: "Stacks Pro",
+        description: "All the Stacks features.",
+        images: ["url_to_image"]
+      }
+    ]
+  },
+  searchEngine: {
+    driver: "opensearch"
+  },
+  security: {
+    firewall: {
+      enabled: !0,
+      countryCodes: [],
+      ipAddresses: [],
+      queryString: [],
+      httpHeaders: [],
+      rateLimitPerMinute: 1000,
+      useIpReputationLists: !0,
+      useKnownBadInputsRuleSet: !0
+    }
+  },
+  services: {
+    aws: {
+      accountId: "",
+      appId: "",
+      apiKey: "",
+      region: FRAMEWORK_DEFAULTS.awsRegion
+    },
+    algolia: {
+      appId: "",
+      apiKey: ""
+    },
+    meilisearch: {
+      appId: "",
+      apiKey: ""
+    },
+    stripe: {
+      appId: "",
+      apiKey: ""
+    }
+  },
+  filesystems: {
+    driver: "s3"
+  },
+  team: {
+    name: "",
+    members: {}
+  },
+  ui: {
+    shortcuts: [
+      [
+        "btn",
+        "inline-flex items-center px-4 py-2 ml-2 border border-transparent shadow-sm text-base font-medium rounded-md text-white bg-indigo-600 hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500 cursor-pointer"
+      ]
+    ],
+    safelist: "prose prose-sm m-auto text-left",
+    trigger: ":stx:",
+    classPrefix: "stx-",
+    reset: "tailwind",
+    icons: ["hugeicons"],
+    fonts: {
+      email: {
+        title: "Mona",
+        text: "Hubot"
+      },
+      desktop: {
+        title: "Mona",
+        text: "Hubot"
+      },
+      mobile: {
+        title: "Mona",
+        text: "Hubot"
+      },
+      web: {
+        title: "Mona",
+        text: "Hubot"
+      }
+    }
+  }
+};
+export default defaults;

package/dist/features.js

@@ -0,0 +1,53 @@
+import { config } from "./config";
+const FEATURE_NAMES = [
+  "auth",
+  "marketing",
+  "cms",
+  "commerce",
+  "dashboard",
+  "monitoring",
+  "realtime",
+  "queue"
+], FEATURE_DEFAULTS = {
+  dashboard: !0
+}, overrides = new Map;
+function configFor(name) {
+  const raw = config[name];
+  return raw && typeof raw === "object" ? raw : void 0;
+}
+export function feature(name) {
+  if (overrides.has(name))
+    return overrides.get(name);
+  const cfg = configFor(name);
+  if (cfg) {
+    const enabledField = cfg.enabled;
+    if (enabledField === !1)
+      return !1;
+    if (Array.isArray(cfg.env) && cfg.env.length > 0) {
+      const currentEnv = (config.app?.env ?? "").toString();
+      if (!cfg.env.includes(currentEnv))
+        return !1;
+    }
+    if (enabledField !== void 0)
+      return !!enabledField;
+    return !0;
+  }
+  return FEATURE_DEFAULTS[name] ?? !1;
+}
+export function enableFeature(name) {
+  overrides.set(name, !0);
+}
+export function disableFeature(name) {
+  overrides.set(name, !1);
+}
+export function resetFeature(name) {
+  overrides.delete(name);
+}
+export function listFeatures() {
+  const out = {};
+  for (const name of FEATURE_NAMES)
+    out[name] = feature(name);
+  for (const name of overrides.keys())
+    out[name] = feature(name);
+  return out;
+}

package/dist/helpers.d.ts

@@ -1,5 +1,5 @@
 import { config } from '.';
-import type { AppConfig, CacheConfig, CdnConfig, ChatConfig, CliConfig, DatabaseConfig, DependenciesConfig, DnsConfig, EmailConfig, Events, FilesystemsConfig, GitConfig, HashingConfig, LibraryConfig, Model, NotificationConfig, PaymentConfig, QueueConfig, SearchEngineConfig, SecurityConfig, ServicesConfig, StacksConfig, StorageConfig, UiConfig } from '@stacksjs/types';
+import type { AppConfig, CacheConfig, CdnConfig, ChatConfig, CliConfig, DatabaseConfig, DependenciesConfig, DnsConfig, EmailConfig, Events, FilesystemsConfig, FeatureFlagsConfig, GitConfig, HashingConfig, LibraryConfig, Model, NotificationConfig, PaymentConfig, QueueConfig, SearchEngineConfig, SecurityConfig, ServicesConfig, StacksConfig, StorageConfig, UiConfig } from '@stacksjs/types';
 export declare function localUrl(options?: {
   domain?: string
   type?: LocalUrlType
@@ -30,6 +30,7 @@ export declare function defineServices(config: ServicesConfig): ServicesConfig;
 export declare function defineSms(config: any): any;
 export declare function defineStorage(config: StorageConfig): StorageConfig;
 export declare function defineFilesystems(config: FilesystemsConfig): FilesystemsConfig;
+export declare function defineFeatureFlags(config: FeatureFlagsConfig): FeatureFlagsConfig;
 export declare function defineUi(config: UiConfig): UiConfig;
 export declare function defineModel(config: Model): Model;
 export declare function defineEvents(config: Events): Events;

package/dist/helpers.js

@@ -0,0 +1,153 @@
+import { config } from ".";
+export async function localUrl(options = {}) {
+  const domain = options.domain ?? config.app.url ?? "stacks", type = options.type ?? "frontend", localhost = options.localhost ?? !1, https = options.https, network = options.network;
+  let url = domain.replace(/\.[^.]+$/, ".localhost");
+  async function tunnel(port) {
+    const { createLocalTunnel } = await import("@stacksjs/tunnel");
+    return createLocalTunnel(port);
+  }
+  switch (type) {
+    case "frontend":
+      if (network)
+        return await tunnel(config.ports?.frontend || 3000);
+      if (localhost)
+        return `http://localhost:${config.ports?.frontend}`;
+      break;
+    case "backend":
+      if (network)
+        return await tunnel(config.ports?.backend || 3001);
+      if (localhost)
+        return `http://localhost:${config.ports?.backend}`;
+      url = `api.${url}`;
+      break;
+    case "admin":
+      if (network)
+        return await tunnel(config.ports?.admin || 3002);
+      if (localhost)
+        return `http://localhost:${config.ports?.admin}`;
+      url = `admin.${url}`;
+      break;
+    case "library":
+      if (network)
+        return await tunnel(config.ports?.library || 3003);
+      if (localhost)
+        return `http://localhost:${config.ports?.library}`;
+      url = `libs.${url}`;
+      break;
+    case "email":
+      if (network)
+        return await tunnel(config.ports?.email || 3005);
+      if (localhost)
+        return `http://localhost:${config.ports?.email}`;
+      url = `email.${url}`;
+      break;
+    case "desktop":
+      if (network)
+        return await tunnel(config.ports?.desktop || 3004);
+      if (localhost)
+        return `http://localhost:${config.ports?.desktop}`;
+      url = `desktop.${url}`;
+      break;
+    case "docs":
+      if (network)
+        return await tunnel(config.ports?.docs || 3006);
+      if (localhost)
+        return `http://localhost:${config.ports?.docs}`;
+      url = `docs.${url}`;
+      break;
+    case "inspect":
+      if (network)
+        return await tunnel(config.ports?.inspect || 3007);
+      if (localhost)
+        return `http://localhost:${config.ports?.inspect}`;
+      url = `inspect.${url}`;
+      break;
+    default:
+      if (localhost)
+        return `http://localhost:${config.ports?.frontend}`;
+  }
+  if (https)
+    return `https://${url}`;
+  return `http://${url}`;
+}
+export function defineStacksConfig(config) {
+  return config;
+}
+export function defineApp(config) {
+  return config;
+}
+export function defineCache(config) {
+  return config;
+}
+export function defineCdn(config) {
+  return config;
+}
+export function defineChat(config) {
+  return config;
+}
+export function defineCli(config) {
+  return config;
+}
+export function defineDatabase(config) {
+  return config;
+}
+export function defineDependencies(config) {
+  return config;
+}
+export function defineDns(config) {
+  return config;
+}
+export function defineEmailConfig(config) {
+  return config;
+}
+export function defineEmail(config) {
+  return config;
+}
+export function defineGit(config) {
+  return config;
+}
+export function defineHashing(config) {
+  return config;
+}
+export function defineLibrary(config) {
+  return config;
+}
+export function defineNotification(config) {
+  return config;
+}
+export function definePayment(config) {
+  return config;
+}
+export function defineQueue(config) {
+  return config;
+}
+export function defineSearchEngine(config) {
+  return config;
+}
+export function defineSecurity(config) {
+  return config;
+}
+export function defineServices(config) {
+  return config;
+}
+export function defineSms(config) {
+  return config;
+}
+export function defineStorage(config) {
+  return config;
+}
+export function defineFilesystems(config) {
+  return config;
+}
+export function defineFeatureFlags(config) {
+  return config;
+}
+export function defineUi(config) {
+  return config;
+}
+export function defineModel(config) {
+  return config;
+}
+export function defineEvents(config) {
+  return config;
+}

package/dist/index.js

@@ -1,9 +1,4 @@
-// @bun
-var M=import.meta.require;import{commandsPath as P,projectPath as C,userDatabasePath as S}from"@stacksjs/path";var B={awsRegion:"us-east-1",timezone:"UTC",noReplyEmail:"no-reply@stacksjs.com",fallbackDomain:"stacks.localhost"};function D(){try{let x=C("package.json"),G=(M(x).name??"").trim();if(!G)return{name:"Stacks",url:"stacks.localhost"};let z=G.replace(/^@[^/]+\//,"").toLowerCase();return{name:z.replace(/[-_]+/g," ").replace(/(^|\s)\w/g,(Q)=>Q.toUpperCase()),url:`${z}.localhost`}}catch{return{name:"Stacks",url:"stacks.localhost"}}}var H=D(),U={cms:{enabled:!1},commerce:{enabled:!1},marketing:{enabled:!1},monitoring:{enabled:!1},ai:{deploy:!1,models:["anthropic.claude-sonnet-4-20250514-v1:0","anthropic.claude-haiku-4-20250514-v1:0","anthropic.claude-3-5-sonnet-20241022-v2:0","amazon.titan-embed-text-v2:0","amazon.titan-text-premier-v1:0","amazon.titan-image-generator-v2:0","meta.llama3-1-70b-instruct-v1:0","meta.llama3-1-8b-instruct-v1:0"]},auth:{username:"email",password:"password",defaultTokenName:"auth-token",tokenExpiry:3600000,refreshTokenExpiry:2592000000,defaultAbilities:["*"]},realtime:{driver:"pusher"},analytics:{driver:void 0},app:{name:H.name,description:"A Stacks application.",env:"local",url:H.url,debug:!0,key:"",timezone:B.timezone,locale:"en",fallbackLocale:"en",cipher:"AES-256-CBC",docMode:!1,redirectUrls:[],maintenanceMode:!1,comingSoonMode:!1,comingSoonSecret:""},cli:{name:"My Custom CLI",command:"my-custom-cli",description:"Stacks is a full-stack framework for TypeScript.",source:P(),deploy:!1},cache:{driver:"memory",prefix:"stx",ttl:3600,maxKeys:-1,useClones:!0,drivers:{redis:{host:"localhost",port:6379,username:"",password:"",database:0,tls:!1},memory:{maxKeys:-1,checkPeriod:600,deleteOnExpire:!0}}},cloud:{infrastructure:{type:"serverless",driver:"aws",environments:["production","staging","development"],firewall:{enabled:!0,countryCodes:[],ipAddresses:[],queryString:[],httpHeaders:[],rateLimitPerMinute:1000,useIpReputationLists:!0,useKnownBadInputsRuleSet:!0},cdn:{allowedMethods:"GET_HEAD",cachedMethods:"GET_HEAD",minTtl:0,defaultTtl:86400,maxTtl:31536000,compress:!0,priceClass:"PriceClass_All",originShieldRegion:B.awsRegion,cookieBehavior:"none",allowList:{cookies:[],headers:[],queryStrings:[]},realtimeLogs:{enabled:!0,samplingRate:2}},fileSystem:!1,storage:{}},sites:{root:"",path:""}},dashboard:{sections:{library:{enabled:!0},content:{enabled:!0},commerce:{enabled:!0},marketing:{enabled:!0},analytics:{enabled:!0},management:{enabled:!0},utilities:{enabled:!0}}},database:{default:"sqlite",logging:!1,connections:{sqlite:{database:S("stacks.sqlite"),prefix:""}},migrations:"migrations",migrationLocks:"migration_locks"},dns:{driver:"aws",a:[],aaaa:[],cname:[],mx:[],txt:[]},docs:{lang:"en-US",title:"Stacks",description:"Rapid application, cloud & library framework.",lastUpdated:!0,deploy:!1,themeConfig:{editLink:{pattern:"https://github.com/stacksjs/stacks/edit/main/docs/docs/:path",text:"Edit this page on GitHub"},footer:{message:"Released under the MIT License.",copyright:"Copyright \xA9 2024-present Stacks.js, Inc."}}},email:{from:{name:"Stacks",address:B.noReplyEmail},mailboxes:[],server:{enabled:!0,scan:!0}},errors:{messages:{string:"The {{ field }} field must be a string",email:"The {{ field }} field must be a valid email address",regex:"The {{ field }} field format is invalid",url:"The {{ field }} field must be a valid URL",activeUrl:"The {{ field }} field must be a valid URL",alpha:"The {{ field }} field must contain only letters",alphaNumeric:"The {{ field }} field must contain only letters and numbers","min(":"The {{ field }} field must have at least {{ min }} characters",maxLength:"The {{ field }} field must not be greater than {{ max }} characters",fixedLength:"The {{ field }} field must be {{ size }} characters long",confirmed:"The {{ field }} field and {{ otherField }} field must be the same",endsWith:"The {{ field }} field must end with {{ substring }}",startsWith:"The {{ field }} field must start with {{ substring }}",sameAs:"The {{ field }} field and {{ otherField }} field must be the same",notSameAs:"The {{ field }} field and {{ otherField }} field must be different",in:"The selected {{ field }} is invalid",notIn:"The selected {{ field }} is invalid",ipAddress:"The {{ field }} field must be a valid IP address",uuid:"The {{ field }} field must be a valid UUID",ascii:"The {{ field }} field must only contain ASCII characters",creditCard:"The {{ field }} field must be a valid {{ providersList }} card number",hexCode:"The {{ field }} field must be a valid hex color code",iban:"The {{ field }} field must be a valid IBAN number",jwt:"The {{ field }} field must be a valid JWT token",coordinates:"The {{ field }} field must contain latitude and longitude coordinates",mobile:"The {{ field }} field must be a valid mobile phone number",passport:"The {{ field }} field must be a valid passport number",postalCode:"The {{ field }} field must be a valid postal code",boolean:"The value must be a boolean",number:"The {{ field }} field must be a number",min:"The {{ field }} field must be at least {{ min }}",max:"The {{ field }} field must not be greater than {{ max }}",range:"The {{ field }} field must be between {{ min }} and {{ max }}",positive:"The {{ field }} field must be positive",negative:"The {{ field }} field must be negative",decimal:"The {{ field }} field must have {{ digits }} decimal places",withoutDecimals:"The {{ field }} field must not have decimal places",date:"The {{ field }} field must be a datetime value","date.equals":"The {{ field }} field must be a date equal to {{ expectedValue }}","date.after":"The {{ field }} field must be a date after {{ expectedValue }}","date.before":"The {{ field }} field must be a date before {{ expectedValue }}","date.afterOrEqual":"The {{ field }} field must be a date after or equal to {{ expectedValue }}","date.beforeOrEqual":"The {{ field }} field must be a date before or equal to {{ expectedValue }}","date.sameAs":"The {{ field }} field and {{ otherField }} field must be the same","date.notSameAs":"The {{ field }} field and {{ otherField }} field must be different","date.afterField":"The {{ field }} field must be a date after {{ otherField }}",accepted:"The {{ field }} field must be accepted",enum:"The selected {{ field }} is invalid",literal:"The {{ field }} field must be {{ expectedValue }}",object:"The {{ field }} field must be an object",record:"The {{ field }} field must be an object","record.min(":"The {{ field }} field must have at least {{ min }} items","record.maxLength":"The {{ field }} field must not have more than {{ max }} items","record.fixedLength":"The {{ field }} field must contain {{ size }} items",array:"The {{ field }} field must be an array","array.min(":"The {{ field }} field must have at least {{ min }} items","array.maxLength":"The {{ field }} field must not have more than {{ max }} items","array.fixedLength":"The {{ field }} field must contain {{ size }} items",notEmpty:"The {{ field }} field must not be empty",distinct:"The {{ field }} field has duplicate values",tuple:"The {{ field }} field must be an array",union:"Invalid value provided for {{ field }} field",unionGroup:"Invalid value provided for {{ field }} field",unionOfTypes:"Invalid value provided for {{ field }} field"}},git:{hooks:{"pre-commit":"lint-staged"},scopes:["","ci","deps","dx","release","docs","test","core","actions","arrays","auth","build","cache","cli","cloud","collections","config","database","datetime","docs","errors","git","lint","x-ray","modules","notifications","objects","path","realtime","router","buddy","security","server","storage","strings","tests","types","ui","utils"],messages:{type:"Select the type of change that you're committing:",scope:"Select the SCOPE of this change (optional):",customScope:"Select the SCOPE of this change:",subject:`Write a SHORT, IMPERATIVE tense description of the change:
-`,body:`Provide a LONGER description of the change (optional). Use "|" to break new line:
-`,breaking:`List any BREAKING CHANGES (optional). Use "|" to break new line:
-`,footerPrefixesSelect:"Select the ISSUES type of the change list by this change (optional):",customFooterPrefixes:"Input ISSUES prefix:",footer:`List any ISSUES by this change. E.g.: #31, #34:
-`,confirmCommit:"Are you sure you want to proceed with the commit above?"},types:[{value:"feat",name:"feat:     \u2728  A new feature",emoji:":sparkles:"},{value:"fix",name:"fix:      \uD83D\uDC1B  A bug fix",emoji:":bug:"},{value:"docs",name:"docs:     \uD83D\uDCDD  Documentation only changes",emoji:":memo:"},{value:"style",name:"style:    \uD83D\uDC84  Changes that do not affect the meaning of the code",emoji:":lipstick:"},{value:"refactor",name:"refactor: \u267B\uFE0F   A code change that neither fixes a bug nor adds a feature",emoji:":recycle:"},{value:"perf",name:"perf:     \u26A1\uFE0F  A code change that improves performance",emoji:":zap:"},{value:"test",name:"test:     \u2705  Adding missing tests or adjusting existing tests",emoji:":white_check_mark:"},{value:"build",name:"build:    \uD83D\uDCE6\uFE0F  Changes that affect the build system or external dependencies",emoji:":package:"},{value:"ci",name:"ci:       \uD83C\uDFA1  Changes to our CI configuration files and scripts",emoji:":ferris_wheel:"},{value:"chore",name:"chore:    \uD83D\uDD28  Other changes that don't modify src or test files",emoji:":hammer:"},{value:"revert",name:"revert:   \u23EA\uFE0F  Reverts a previous commit",emoji:":rewind:"}]},hashing:{driver:"bcrypt",bcrypt:{rounds:12},argon2:{memory:65536,time:2}},library:{name:"hello-world",owner:"@stacksjs",repository:"stacksjs/stacks",license:"MIT",author:"",contributors:[],defaultLanguage:"en",webComponents:{name:"hello-world-elements",description:"Your framework agnostic web component library description.",keywords:["custom-elements","web-components","library","framework-agnostic","typescript","javascript"],tags:[{name:["HelloWorld","AppHelloWorld"],description:"The Hello World custom element, built via this framework.",attributes:[{name:"greeting",description:"The greeting."}]}]},functions:{name:"hello-world-fx",description:"Your function library description.",keywords:["functions","composables","library","typescript","javascript"],shouldGenerateSourcemap:!1,files:["counter","dark"]}},logging:{logsPath:"storage/logs/stacks.log",deploymentsPath:"storage/logs/deployments.log"},notification:{default:"email"},payment:{driver:"stripe"},ports:{frontend:3000,backend:3001,admin:3002,library:3003,desktop:3004,email:3005,docs:3006,inspect:3007,api:3008,systemTray:3009,database:3010},queue:{default:"sync",connections:{sync:{driver:"sync"},database:{driver:"database",table:"jobs",queue:"default",retryAfter:90},redis:{driver:"redis",queue:"default",retryAfter:90},sqs:{driver:"sqs",key:"",secret:"",prefix:"",suffix:"",queue:"default",region:B.awsRegion}}},saas:{plans:[{productName:"Stacks Hobby",description:"All the Stacks features.",pricing:[{key:"stacks_hobby_monthly",price:3900,interval:"month",currency:"usd"},{key:"stacks_hobby_yearly",price:37900,interval:"year",currency:"usd"}],metadata:{createdBy:"admin",version:"1.0.0"}},{productName:"Stacks Pro",description:"All the Stacks features, including being able to invite team members.",pricing:[{key:"stacks_pro_monthly",price:5900,interval:"month",currency:"usd"},{key:"stacks_pro_yearly",price:57900,interval:"year",currency:"usd"}],metadata:{createdBy:"admin",version:"1.0.0"}}],webhook:{endpoint:"/webhooks/stripe",secret:""},currencies:["usd"],coupons:[{code:"SUMMER2024",amountOff:500,duration:"once"}],products:[{name:"Stacks Pro",description:"All the Stacks features.",images:["url_to_image"]}]},searchEngine:{driver:"opensearch"},security:{firewall:{enabled:!0,countryCodes:[],ipAddresses:[],queryString:[],httpHeaders:[],rateLimitPerMinute:1000,useIpReputationLists:!0,useKnownBadInputsRuleSet:!0}},services:{aws:{accountId:"",appId:"",apiKey:"",region:B.awsRegion},algolia:{appId:"",apiKey:""},meilisearch:{appId:"",apiKey:""},stripe:{appId:"",apiKey:""}},filesystems:{driver:"s3"},team:{name:"",members:{}},ui:{shortcuts:[["btn","inline-flex items-center px-4 py-2 ml-2 border border-transparent shadow-sm text-base font-medium rounded-md text-white bg-indigo-600 hover:bg-indigo-700 focus:outline-none focus:ring-2 focus:ring-offset-2 focus:ring-indigo-500 cursor-pointer"]],safelist:"prose prose-sm m-auto text-left",trigger:":stx:",classPrefix:"stx-",reset:"tailwind",icons:["hugeicons"],fonts:{email:{title:"Mona",text:"Hubot"},desktop:{title:"Mona",text:"Hubot"},mobile:{title:"Mona",text:"Hubot"},web:{title:"Mona",text:"Hubot"}}}};function m(x){return typeof x==="object"&&x!==null&&!Array.isArray(x)}function _(x,X){return(G,z)=>{if(G==null)return[];let J=null;if(typeof G==="number"&&Number.isInteger(G))J=G;else if(typeof G==="string"&&/^-?\d+$/.test(G))J=Number.parseInt(G,10);if(J===null)return[{path:z,message:`expected integer, got ${typeof G} (${JSON.stringify(G)})`}];if(J<x||J>X)return[{path:z,message:`expected integer in [${x}, ${X}], got ${J}`}];return[]}}function j(x){return(X,G)=>{if(X==null)return[];if(typeof X!=="string"||!x.includes(X))return[{path:G,message:`expected one of [${x.join(", ")}], got ${JSON.stringify(X)}`}];return[]}}function T(){return(x,X)=>{if(x==null)return[];return typeof x==="string"?[]:[{path:X,message:`expected string, got ${typeof x}`}]}}function O(){return(x,X)=>{if(x==null)return[];return typeof x==="boolean"?[]:[{path:X,message:`expected boolean, got ${typeof x}`}]}}var q=_(1,65535),R={app:{rules:{name:T(),env:j(["local","development","staging","production","test"]),debug:O(),url:T()}},ports:{rules:{frontend:q,api:q,admin:q,docs:q,systemTray:q,desktop:q}},database:{rules:{default:j(["sqlite","mysql","singlestore","postgres","dynamodb"])}},cache:{rules:{driver:j(["memory","redis","singlestore"])}},queue:{rules:{default:j(["sync","database","redis"])}},logging:{rules:{level:j(["trace","debug","info","warn","error","fatal"])}},email:{rules:{default:j(["ses","sendgrid","mailgun","mailtrap","smtp","log","capture"])}}};function w(x){let X=[];for(let[G,z]of Object.entries(R)){let J=x[G];if(J==null)continue;if(!m(J)){X.push({path:G,message:`expected object, got ${typeof J}`});continue}for(let[Q,I]of Object.entries(z.rules)){let Z=J[Q];X.push(...I(Z,`${G}.${Q}`))}}return X}var k=process.env.SKIP_CONFIG_LOADING==="true",E=process.env.SKIP_CONFIG_VALIDATION==="true",Y=Symbol.for("@stacksjs/config:overrides"),b=Symbol.for("@stacksjs/config:overridesReady");function h(){return{ai:{},analytics:{},app:{name:process.env.APP_NAME||"Stacks",env:process.env.APP_ENV||"production"},auth:{},cache:{},cli:{},cloud:{},cms:{},commerce:{},dashboard:{},database:{},dns:{},realtime:{},email:{},errors:{},git:{},hashing:{},library:{},logging:{},marketing:{},monitoring:{},notification:{},queue:{},payment:{},ports:{},saas:{},searchEngine:{},security:{},services:{},filesystems:{},team:{},ui:{}}}var W=globalThis,d=W[Y],$=d??(()=>{let x=h();return W[Y]=x,x})(),p=[["ai","~/config/ai"],["analytics","~/config/analytics"],["app","~/config/app"],["auth","~/config/auth"],["cache","~/config/cache"],["cli","~/config/cli"],["cloud","~/config/cloud"],["cms","~/config/cms"],["commerce","~/config/commerce"],["dashboard","~/config/dashboard"],["database","~/config/database"],["dns","~/config/dns"],["email","~/config/email"],["errors","~/config/errors"],["git","~/config/git"],["hashing","~/config/hashing"],["library","~/config/library"],["logging","~/config/logging"],["marketing","~/config/marketing"],["monitoring","~/config/monitoring"],["notification","~/config/notification"],["payment","~/config/payment"],["ports","~/config/ports"],["queue","~/config/queue"],["realtime","~/config/realtime"],["saas","~/config/saas"],["searchEngine","~/config/search-engine"],["security","~/config/security"],["services","~/config/services"],["filesystems","~/config/filesystems"],["team","~/config/team"],["ui","~/config/ui"]],t=W[b],F=t??(()=>{let x=k?Promise.resolve($):Promise.all(p.map(async([X,G])=>{try{let z=await import(G);if(z?.default!==void 0)$[X]=z.default}catch(z){let J=z?.code,Q=z?.message??String(z);if(!(J==="ERR_MODULE_NOT_FOUND"||J==="MODULE_NOT_FOUND"||/Cannot find module/i.test(Q)))console.warn(`[config] Failed to load ${String(X)} config from ${G}: ${Q}`)}})).then(()=>{if(!E){let X=w($);if(X.length>0){console.error("[config] Configuration issues detected:");for(let z of X)console.error(`  \u2022 ${z.path}: ${z.message}`);let G=X.map((z)=>`  \u2022 ${z.path}: ${z.message}`).join(`
-`);throw Error(`[config] ${X.length} configuration issue(s) detected at boot:
-${G}
-Set SKIP_CONFIG_VALIDATION=true to bypass (e.g. when running migrations against partial config).`)}}return $});return W[b]=x,x})();async function Ax(x={}){let X=x.domain??N.app.url??"stacks",G=x.type??"frontend",z=x.localhost??!1,J=x.https,Q=x.network,I=X.replace(/\.[^.]+$/,".localhost");async function Z(A){let{createLocalTunnel:K}=await import("@stacksjs/tunnel");return K(A)}switch(G){case"frontend":if(Q)return await Z(N.ports?.frontend||3000);if(z)return`http://localhost:${N.ports?.frontend}`;break;case"backend":if(Q)return await Z(N.ports?.backend||3001);if(z)return`http://localhost:${N.ports?.backend}`;I=`api.${I}`;break;case"admin":if(Q)return await Z(N.ports?.admin||3002);if(z)return`http://localhost:${N.ports?.admin}`;I=`admin.${I}`;break;case"library":if(Q)return await Z(N.ports?.library||3003);if(z)return`http://localhost:${N.ports?.library}`;I=`libs.${I}`;break;case"email":if(Q)return await Z(N.ports?.email||3005);if(z)return`http://localhost:${N.ports?.email}`;I=`email.${I}`;break;case"desktop":if(Q)return await Z(N.ports?.desktop||3004);if(z)return`http://localhost:${N.ports?.desktop}`;I=`desktop.${I}`;break;case"docs":if(Q)return await Z(N.ports?.docs||3006);if(z)return`http://localhost:${N.ports?.docs}`;I=`docs.${I}`;break;case"inspect":if(Q)return await Z(N.ports?.inspect||3007);if(z)return`http://localhost:${N.ports?.inspect}`;I=`inspect.${I}`;break;default:if(z)return`http://localhost:${N.ports?.frontend}`}if(J)return`https://${I}`;return`http://${I}`}function Kx(x){return x}function Px(x){return x}function Cx(x){return x}function Sx(x){return x}function Dx(x){return x}function mx(x){return x}function _x(x){return x}function Ox(x){return x}function Rx(x){return x}function kx(x){return x}function Ex(x){return x}function hx(x){return x}function dx(x){return x}function px(x){return x}function tx(x){return x}function vx(x){return x}function rx(x){return x}function ux(x){return x}function sx(x){return x}function ax(x){return x}function lx(x){return x}function fx(x){return x}function gx(x){return x}function ex(x){return x}function cx(x){return x}function nx(x){return x}function y(x){let X=$[x];if(X!==void 0&&(typeof X!=="object"||Object.keys(X).length>0))return X;return U[x]}var v=function(){},N=new Proxy(v,{get(x,X){return y(X)},has(x,X){return X in $||X in U},ownKeys(){return Array.from(new Set([...Object.keys($),...Object.keys(U)]))},getOwnPropertyDescriptor(x,X){if(typeof X!=="string")return;if(!(X in $)&&!(X in U))return;return{enumerable:!0,configurable:!0,writable:!0,value:y(X)}},isExtensible(){return!0},preventExtensions(){return!1}});async function NN(){return await F,N}var L=Symbol.for("@stacksjs/config:databaseReady"),V=globalThis;async function XN(){await F;let x=Date.now()+5000;while(!V[L]&&Date.now()<x)await new Promise((X)=>setTimeout(X,25));if(!V[L])console.warn("[config] awaitDatabaseConfig() timed out \u2014 database driver did not signal readiness within 5s");return N}function zN(){V[L]=!0}function GN(){return N}var{ai:r,analytics:u,app:s,auth:a,realtime:l,cache:f,cloud:g,cli:e,dashboard:c,database:n,dns:i,docs:o,email:xx,errors:Nx,git:Xx,hashing:zx,library:Gx,logging:Ix,notification:Jx,payment:Qx,ports:Zx,queue:$x,security:jx,saas:qx,searchEngine:Bx,services:Ux,filesystems:Wx,team:Fx,ui:Mx}=N;F.then(()=>{r=N.ai,u=N.analytics,s=N.app,a=N.auth,l=N.realtime,f=N.cache,g=N.cloud,e=N.cli,c=N.dashboard,n=N.database,i=N.dns,o=N.docs,xx=N.email,Nx=N.errors,Xx=N.git,zx=N.hashing,Gx=N.library,Ix=N.logging,Jx=N.notification,Qx=N.payment,Zx=N.ports,$x=N.queue,jx=N.security,qx=N.saas,Bx=N.searchEngine,Ux=N.services,Wx=N.filesystems,Fx=N.team,Mx=N.ui}).catch(()=>{});function IN(){let x=N.app?.env;if(x==="local"||x==="development")return"dev";if(x==="staging")return"stage";if(x==="production")return"prod";if(!x)throw Error("Couldn't determine app environment");return x}export{UN as validateConfig,Mx as ui,Fx as team,Ux as services,jx as security,Bx as searchEngine,qx as saas,HN as resetFeature,WN as reportConfigIssues,l as realtime,$x as queue,Zx as ports,Qx as payment,F as overridesReady,$ as overrides,Jx as notification,zN as markDatabaseReady,Ix as logging,Ax as localUrl,TN as listFeatures,Gx as library,zx as hashing,Xx as git,GN as getConfig,Wx as filesystems,MN as feature,Nx as errors,LN as enableFeature,xx as email,o as docs,i as dns,VN as disableFeature,IN as determineAppEnv,ex as defineUi,fx as defineStorage,Kx as defineStacksConfig,lx as defineSms,ax as defineServices,sx as defineSecurity,ux as defineSearchEngine,rx as defineQueue,vx as definePayment,tx as defineNotification,cx as defineModel,px as defineLibrary,dx as defineHashing,hx as defineGit,gx as defineFilesystems,nx as defineEvents,kx as defineEmailConfig,Ex as defineEmail,Rx as defineDns,Ox as defineDependencies,_x as defineDatabase,mx as defineCli,Dx as defineChat,Sx as defineCdn,Cx as defineCache,Px as defineApp,U as defaults,n as database,c as dashboard,N as config,g as cloud,e as cli,f as cache,XN as awaitDatabaseConfig,NN as awaitConfig,a as auth,s as app,u as analytics,r as ai,qN as FRAMEWORK_DEFAULTS};
+export * from "./config";
+export { FRAMEWORK_DEFAULTS } from "./defaults";
+export { validateConfig, reportConfigIssues } from "./validators";
+export { feature, enableFeature, disableFeature, resetFeature, listFeatures } from "./features";

package/dist/overrides.js

@@ -0,0 +1,111 @@
+import { validateConfig } from "./validators";
+const skipConfigLoading = process.env.SKIP_CONFIG_LOADING === "true", skipConfigValidation = process.env.SKIP_CONFIG_VALIDATION === "true", OVERRIDES_KEY = Symbol.for("@stacksjs/config:overrides"), READY_KEY = Symbol.for("@stacksjs/config:overridesReady");
+function defaultsForOverrides() {
+  return {
+    ai: {},
+    analytics: {},
+    app: { name: process.env.APP_NAME || "Stacks", env: process.env.APP_ENV || "production" },
+    auth: {},
+    cache: {},
+    cli: {},
+    cloud: {},
+    cms: {},
+    commerce: {},
+    dashboard: {},
+    database: {},
+    dns: {},
+    realtime: {},
+    email: {},
+    errors: {},
+    featureFlags: {},
+    git: {},
+    hashing: {},
+    library: {},
+    logging: {},
+    marketing: {},
+    monitoring: {},
+    notification: {},
+    queue: {},
+    payment: {},
+    ports: {},
+    saas: {},
+    searchEngine: {},
+    security: {},
+    services: {},
+    filesystems: {},
+    team: {},
+    ui: {}
+  };
+}
+const globalScope = globalThis, sharedOverrides = globalScope[OVERRIDES_KEY];
+export const overrides = sharedOverrides ?? (() => {
+  const created = defaultsForOverrides();
+  globalScope[OVERRIDES_KEY] = created;
+  return created;
+})();
+const userConfigs = [
+  ["ai", "~/config/ai"],
+  ["analytics", "~/config/analytics"],
+  ["app", "~/config/app"],
+  ["auth", "~/config/auth"],
+  ["cache", "~/config/cache"],
+  ["cli", "~/config/cli"],
+  ["cloud", "~/config/cloud"],
+  ["cms", "~/config/cms"],
+  ["commerce", "~/config/commerce"],
+  ["dashboard", "~/config/dashboard"],
+  ["database", "~/config/database"],
+  ["dns", "~/config/dns"],
+  ["email", "~/config/email"],
+  ["errors", "~/config/errors"],
+  ["featureFlags", "~/config/feature-flags"],
+  ["git", "~/config/git"],
+  ["hashing", "~/config/hashing"],
+  ["library", "~/config/library"],
+  ["logging", "~/config/logging"],
+  ["marketing", "~/config/marketing"],
+  ["monitoring", "~/config/monitoring"],
+  ["notification", "~/config/notification"],
+  ["payment", "~/config/payment"],
+  ["ports", "~/config/ports"],
+  ["queue", "~/config/queue"],
+  ["realtime", "~/config/realtime"],
+  ["saas", "~/config/saas"],
+  ["searchEngine", "~/config/search-engine"],
+  ["security", "~/config/security"],
+  ["services", "~/config/services"],
+  ["filesystems", "~/config/filesystems"],
+  ["team", "~/config/team"],
+  ["ui", "~/config/ui"]
+], sharedReady = globalScope[READY_KEY];
+export const overridesReady = sharedReady ?? (() => {
+  const promise = skipConfigLoading ? Promise.resolve(overrides) : Promise.all(userConfigs.map(async ([key, modulePath]) => {
+    try {
+      const mod = await import(modulePath);
+      if (mod?.default !== void 0)
+        overrides[key] = mod.default;
+    } catch (err) {
+      const code = err?.code, msg = err?.message ?? String(err);
+      if (!(code === "ERR_MODULE_NOT_FOUND" || code === "MODULE_NOT_FOUND" || /Cannot find module/i.test(msg)))
+        console.warn(`[config] Failed to load ${String(key)} config from ${modulePath}: ${msg}`);
+    }
+  })).then(() => {
+    if (!skipConfigValidation) {
+      const issues = validateConfig(overrides);
+      if (issues.length > 0) {
+        console.error("[config] Configuration issues detected:");
+        for (const issue of issues)
+          console.error(`  \u2022 ${issue.path}: ${issue.message}`);
+        const summary = issues.map((i) => `  \u2022 ${i.path}: ${i.message}`).join(`
+`);
+        throw Error(`[config] ${issues.length} configuration issue(s) detected at boot:
+${summary}
+Set SKIP_CONFIG_VALIDATION=true to bypass (e.g. when running migrations against partial config).`);
+      }
+    }
+    return overrides;
+  });
+  globalScope[READY_KEY] = promise;
+  return promise;
+})();
+export default overrides;

package/dist/validators.js

@@ -0,0 +1,119 @@
+function isPlainObject(v) {
+  return typeof v === "object" && v !== null && !Array.isArray(v);
+}
+function checkInteger(min, max) {
+  return (value, path) => {
+    if (value == null)
+      return [];
+    let num = null;
+    if (typeof value === "number" && Number.isInteger(value))
+      num = value;
+    else if (typeof value === "string" && /^-?\d+$/.test(value))
+      num = Number.parseInt(value, 10);
+    if (num === null)
+      return [{ path, message: `expected integer, got ${typeof value} (${JSON.stringify(value)})` }];
+    if (num < min || num > max)
+      return [{ path, message: `expected integer in [${min}, ${max}], got ${num}` }];
+    return [];
+  };
+}
+function checkOneOf(values) {
+  return (value, path) => {
+    if (value == null)
+      return [];
+    if (typeof value !== "string" || !values.includes(value))
+      return [{ path, message: `expected one of [${values.join(", ")}], got ${JSON.stringify(value)}` }];
+    return [];
+  };
+}
+function checkString() {
+  return (value, path) => {
+    if (value == null)
+      return [];
+    return typeof value === "string" ? [] : [{ path, message: `expected string, got ${typeof value}` }];
+  };
+}
+function checkBoolean() {
+  return (value, path) => {
+    if (value == null)
+      return [];
+    return typeof value === "boolean" ? [] : [{ path, message: `expected boolean, got ${typeof value}` }];
+  };
+}
+const PORT_CHECK = checkInteger(1, 65535), SCHEMA = {
+  app: {
+    rules: {
+      name: checkString(),
+      env: checkOneOf(["local", "development", "staging", "production", "test"]),
+      debug: checkBoolean(),
+      url: checkString()
+    }
+  },
+  ports: {
+    rules: {
+      frontend: PORT_CHECK,
+      api: PORT_CHECK,
+      admin: PORT_CHECK,
+      docs: PORT_CHECK,
+      systemTray: PORT_CHECK,
+      desktop: PORT_CHECK
+    }
+  },
+  database: {
+    rules: {
+      default: checkOneOf(["sqlite", "mysql", "singlestore", "postgres", "dynamodb"])
+    }
+  },
+  cache: {
+    rules: {
+      driver: checkOneOf(["memory", "redis", "singlestore"])
+    }
+  },
+  featureFlags: {
+    rules: {
+      default: checkOneOf(["memory", "database"]),
+      missing: checkOneOf(["false", "throw"])
+    }
+  },
+  queue: {
+    rules: {
+      default: checkOneOf(["sync", "database", "redis"])
+    }
+  },
+  logging: {
+    rules: {
+      level: checkOneOf(["trace", "debug", "info", "warn", "error", "fatal"])
+    }
+  },
+  email: {
+    rules: {
+      default: checkOneOf(["ses", "sendgrid", "mailgun", "mailtrap", "smtp", "log", "capture"])
+    }
+  }
+};
+export function validateConfig(config) {
+  const issues = [];
+  for (const [section, schema] of Object.entries(SCHEMA)) {
+    const sectionValue = config[section];
+    if (sectionValue == null)
+      continue;
+    if (!isPlainObject(sectionValue)) {
+      issues.push({ path: section, message: `expected object, got ${typeof sectionValue}` });
+      continue;
+    }
+    for (const [field, check] of Object.entries(schema.rules)) {
+      const v = sectionValue[field];
+      issues.push(...check(v, `${section}.${field}`));
+    }
+  }
+  return issues;
+}
+export function reportConfigIssues(config) {
+  const issues = validateConfig(config);
+  if (issues.length === 0)
+    return !0;
+  console.warn("[config] Configuration issues detected:");
+  for (const issue of issues)
+    console.warn(`  \u2022 ${issue.path}: ${issue.message}`);
+  return !1;
+}

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/config",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.87",
+  "version": "0.70.90",
   "description": "The Stacks config helper methods.",
   "author": "Chris Breuer",
   "contributors": [
@@ -53,9 +53,9 @@
     "ts-pantry": "^0.10.11"
   },
   "devDependencies": {
-    "@stacksjs/alias": "0.70.87",
+    "@stacksjs/alias": "0.70.90",
     "better-dx": "^0.2.16",
-    "@stacksjs/types": "0.70.87",
+    "@stacksjs/types": "0.70.90",
     "bunfig": "^0.15.11"
   }
 }