@stacksjs/types 0.70.85 → 0.70.87

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@stacksjs/types",
   "type": "module",
-  "version": "0.70.85",
+  "version": "0.70.87",
   "description": "The Stacks framework types.",
   "author": "Chris Breuer",
   "contributors": [
@@ -43,8 +43,7 @@
   "types": "dist/index.d.ts",
   "files": [
     "README.md",
-    "dist",
-    "src"
+    "dist"
   ],
   "scripts": {
     "build": "bun build.ts",
@@ -66,10 +65,25 @@
     }
   },
   "devDependencies": {
-    "@stacksjs/validation": "0.70.85",
+    "@stacksjs/validation": "0.70.87",
     "@types/bun": "^1.3.11",
     "meilisearch": "^0.59.0",
     "typescript": "^7.0.2"
   },
-  "sideEffects": false
+  "sideEffects": false,
+  "publishConfig": {
+    "exports": {
+      ".": {
+        "types": "./dist/index.d.ts",
+        "bun": "./dist/index.js",
+        "import": "./dist/index.js",
+        "default": "./dist/index.js"
+      },
+      "./*": {
+        "bun": "./dist/*",
+        "import": "./dist/*",
+        "default": "./dist/*"
+      }
+    }
+  }
 }

package/src/ai.ts

@@ -1,41 +0,0 @@
-type AiModel =
-  // Amazon Titan
-  | 'amazon.titan-embed-text-v1'
-  | 'amazon.titan-embed-text-v2:0'
-  | 'amazon.titan-text-lite-v1'
-  | 'amazon.titan-text-express-v1'
-  | 'amazon.titan-text-premier-v1:0'
-  | 'amazon.titan-embed-image-v1'
-  | 'amazon.titan-image-generator-v1'
-  | 'amazon.titan-image-generator-v2:0'
-  // Anthropic Claude (current models via Bedrock)
-  | 'anthropic.claude-sonnet-4-20250514-v1:0'
-  | 'anthropic.claude-haiku-4-20250514-v1:0'
-  | 'anthropic.claude-3-5-sonnet-20241022-v2:0'
-  | 'anthropic.claude-3-5-haiku-20241022-v1:0'
-  | 'anthropic.claude-3-opus-20240229-v1:0'
-  | 'anthropic.claude-3-sonnet-20240229-v1:0'
-  | 'anthropic.claude-3-haiku-20240307-v1:0'
-  // Meta Llama 3
-  | 'meta.llama3-8b-instruct-v1:0'
-  | 'meta.llama3-70b-instruct-v1:0'
-  | 'meta.llama3-1-8b-instruct-v1:0'
-  | 'meta.llama3-1-70b-instruct-v1:0'
-  | 'meta.llama3-1-405b-instruct-v1:0'
-  // Allow custom model strings
-  | (string & {})
-
-/**
- * **AI Options**
- *
- * This configuration defines all of your AI options. Because Stacks is fully-typed, you
- * may hover any of the options below and the definitions will be provided. In case you
- * have any questions, feel free to reach out via Discord or GitHub Discussions.
- */
-export interface AiOptions {
-  default: AiModel
-  models: AiModel[]
-  deploy: boolean
-}
-
-export type AiConfig = Partial<AiOptions>

package/src/analytics.ts

@@ -1,58 +0,0 @@
-/**
- * **Analytics Options**
- *
- * This configuration defines all of your Analytics options. Because Stacks is fully-typed, you
- * may hover any of the options below and the definitions will be provided. In case you
- * have any questions, feel free to reach out via Discord or GitHub Discussions.
- */
-export interface AnalyticsOptions {
-  /** The analytics driver/provider to use */
-  driver: 'google-analytics' | 'fathom' | 'plausible' | 'self-hosted'
-
-  drivers: {
-    /** Google Analytics configuration */
-    googleAnalytics?: {
-      /** GA4 Measurement ID (e.g., G-XXXXXXXXXX) */
-      trackingId: string
-      /** Enable debug mode */
-      debug?: boolean
-    }
-    /** Fathom Analytics configuration (privacy-focused) */
-    fathom?: {
-      /** Fathom site ID */
-      siteId: string
-      /** Custom script URL */
-      scriptUrl?: string
-      /** Honor Do Not Track browser setting */
-      honorDnt?: boolean
-      /** Enable SPA mode for client-side routing */
-      spa?: boolean
-    }
-    /** Plausible Analytics configuration (privacy-focused, open source) */
-    plausible?: {
-      /** Your domain (e.g., example.com) */
-      domain: string
-      /** Custom script URL (for self-hosted Plausible) */
-      scriptUrl?: string
-      /** Track localhost during development */
-      trackLocalhost?: boolean
-      /** Enable hash-based routing */
-      hashMode?: boolean
-    }
-    /** Self-hosted analytics configuration (using Stacks Analytics / dynamodb-tooling) */
-    selfHosted?: {
-      /** Site ID for tracking */
-      siteId: string
-      /** API endpoint URL for collecting analytics (e.g., https://api.example.com/analytics) */
-      apiEndpoint: string
-      /** Honor Do Not Track browser setting */
-      honorDnt?: boolean
-      /** Track hash changes as page views */
-      trackHashChanges?: boolean
-      /** Track outbound link clicks */
-      trackOutboundLinks?: boolean
-    }
-  }
-}
-
-export type AnalyticsConfig = Partial<AnalyticsOptions>

package/src/api.ts

@@ -1,77 +0,0 @@
-/**
- * **API Options**
- *
- * This configuration defines all of your API options. Because Stacks is fully-typed, you
- * may hover any of the options below and the definitions will be provided. In case you
- * have any questions, feel free to reach out via Discord or GitHub Discussions.
- */
-export interface ApiOptions {
-  /**
-   * **API Description**
-   *
-   * This value defines the description for your API.
-   *
-   * @default "Stacks API"
-   */
-  description: string
-
-  /**
-   * **API Prefix**
-   *
-   * This value defines the prefix for all of your API routes. For example, if you set
-   * this value to `api`, all of your API routes will be prefixed with `/api`. This
-   * value is useful for when you want to version your API.
-   *
-   * @default string "api"
-   * @example string "api/v1"
-   */
-  prefix: string
-
-  middleware: string[]
-
-  routes:
-    | {
-      index: boolean
-      show: boolean
-      store: boolean
-      update: boolean
-      destroy: boolean
-    }
-    | boolean
-
-  /**
-   * **API Prewarm**
-   *
-   * This configuration determines the prewarming behavior of your API. Prewarming eliminates
-   * cold starts in your API. If this value is set to `true`, the API will be prewarmed
-   * every 5 minutes. If you provide a number, Stacks will prewarm the
-   * specified number of containers every 5 minutes.
-   *
-   * @default true
-   * @example false
-   * @example 10
-   */
-  prewarm: boolean | number
-
-  /**
-   * **API Memory Size**
-   *
-   * This value defines the memory size for your API.
-   *
-   * @default 512
-   */
-  memorySize: number
-
-  /**
-   * **API Timeout**
-   *
-   * This value defines the timeout for your API.
-   *
-   * @default 30
-   */
-  timeout: number
-
-  deploy: boolean
-}
-
-export type ApiConfig = Partial<ApiOptions>

package/src/app.ts

@@ -1,189 +0,0 @@
-export type AppEnvType = 'local' | 'dev' | 'stage' | 'prod' | 'testing' | string
-
-/**
- * **Application Options**
- *
- * This configuration defines all of your application options. Because Stacks is fully-typed,
- * you may hover any of the options below and the definitions will be provided. In case
- * you have any questions, feel free to reach out via Discord or GitHub Discussions.
- */
-export interface AppOptions {
-  /**
-   * **Application Name**
-   *
-   * This value is the name of your application. This value is used when the
-   * framework needs to place the application's name in a log or any
-   * other location as required by the application or its packages.
-   *
-   * @default string "Stacks"
-   */
-  name: string
-
-  /**
-   * **Application Description**
-   *
-   * This value is the description of your application. This value is used when the
-   * framework generates meta tags for the frontend.
-   */
-  description: string
-
-  /**
-   * **Application Environment**
-   *
-   * This value determines the "environment" your application is currently
-   * running in. This may determine how you prefer to configure various
-   * services the application utilizes. Set this in your ".env" file
-   *
-   * @default "local"
-   */
-  env: AppEnvType
-
-  /**
-   * **Application URL**
-   *
-   * This URL is used by the console to properly generate URLs when using
-   * the Buddy command line tool. You should set this to the root of
-   * your application so that it is used when running Buddy tasks.
-   *
-   * @default string "stacks.localhost"
-   * @example "my-project.test"
-   */
-  url: string
-
-  /**
-   * **Redirect URLs**
-   *
-   * A Redirect URL is a URL that permanently redirects to the Application URL.
-   * This is useful for when you have multiple domains that you want to redirect
-   * to your application. You can set this to a string or an array of strings.
-   *
-   * @default []
-   * @example "['stacksjs.com', 'stacksjs.dev']"
-   */
-  redirectUrls: string | string[]
-
-  /**
-   * **Application Debug Mode**
-   *
-   * When your application is in debug mode, detailed error messages with
-   * stack traces will be shown on every error that occurs within your
-   * application. If disabled, a simple generic error page is shown.
-   *
-   * @default true
-   */
-  debug: boolean
-
-  /**
-   * **Maintenance Mode**
-   *
-   * When your application is in maintenance mode, a simple maintenance
-   * page will be shown on every request into your application.
-   *
-   * @default false
-   */
-  maintenanceMode: boolean
-
-  /**
-   * **Coming Soon Mode**
-   *
-   * When enabled, public web requests can render a launch screen while
-   * optionally allowing preview access through a secret bypass.
-   *
-   * @default false
-   */
-  comingSoonMode?: boolean
-
-  /**
-   * **Coming Soon Secret**
-   *
-   * Optional preview token used to bypass coming soon mode.
-   */
-  comingSoonSecret?: string
-
-  /**
-   * **Encryption Key**
-   *
-   * This key is used by the Stacks encrypter service and should be set to
-   * a random, 32 character string, otherwise these encrypted strings will
-   * not be safe. Please do this before deploying an application!
-   */
-  key: string
-
-  /**
-   * **Application Timezone**
-   *
-   * Here you may specify the default timezone for your application, which
-   * will be used by Stacks and date-time functions. We have gone ahead
-   * and set this to a sensible default for you out of the box.
-   *
-   * @default string "UTC"
-   */
-  timezone: string
-
-  /**
-   * **Application Locale Configuration**
-   *
-   * The application locale determines the default locale that will be used
-   * by the translation service provider. You are free to set this value
-   * to any of the locales which will be supported by the application.
-   *
-   * @default string "en"
-   * @example
-   * de // ./lang/de.yml needs to be present for this
-   */
-  locale: string
-
-  /**
-   * **Application Fallback Locale**
-   *
-   * The fallback locale determines the locale to use when the current one
-   * is not available. You may change the value to correspond to any of
-   * the language folders that are provided through your application.
-   *
-   * @default string "en"
-   */
-  fallbackLocale: 'en'
-
-  /**
-   * **Cipher**
-   *
-   * Description WIP.
-   *
-   * @default string "aes-256-cbc"
-   */
-  cipher: string
-
-  // inspect: <InspectOptions>{},
-
-  /**
-   * **Documentation Mode**
-   *
-   * $appUrl becomes your Documentation URL.
-   *
-   * @default false
-   */
-  docMode: boolean
-
-  /**
-   * **Primary Brand Color**
-   *
-   * The primary color used for branding in emails and UI components.
-   * Should be a valid CSS color value (hex, rgb, etc.)
-   *
-   * @default "#3b82f6"
-   * @example "#3b82f6"
-   */
-  primaryColor: string
-
-  /**
-   * **Support Email**
-   *
-   * The email address users should contact for support.
-   * Used in transactional emails and error messages.
-   *
-   * @example "support@example.com"
-   */
-  supportEmail: string
-}
-
-export type AppConfig = Partial<AppOptions>

package/src/attributes.ts

@@ -1,5 +0,0 @@
-// Project-generated `Attributes` interface lives at
-// `storage/framework/types/attributes.ts` (one big union of every model's
-// fillable column). Re-export type-only so Bun's runtime resolver doesn't
-// try to load the file from the shipped `@stacksjs/types` package.
-export type * from '../../../types/attributes'

package/src/auth.ts

@@ -1,161 +0,0 @@
-export interface AuthOptions {
-  /**
-   * Top-level feature gate. When `false`, the auth feature is inert at boot
-   * (no token/password-reset/email-verification flows wired up). Missing or
-   * `true` means auth is on.
-   */
-  enabled?: boolean
-  /** Optional deploy-target gate, e.g. `['production']`. */
-  env?: string[]
-  /**
-   * The default authentication guard to use
-   */
-  default: string
-
-  /**
-   * The authentication guards available
-   */
-  guards: {
-    [key: string]: {
-      /**
-       * The authentication driver to use
-       */
-      driver: 'session' | 'token'
-
-      /**
-       * The authentication provider to use
-       */
-      provider: string
-    }
-  }
-
-  /**
-   * The authentication providers available
-   */
-  providers: {
-    [key: string]: {
-      /**
-       * The database driver to use
-       */
-      driver: 'database'
-
-      /**
-       * The database table to use
-       */
-      table: string
-    }
-  }
-
-  /**
-   * The username field used for authentication
-   */
-  username: string
-
-  /**
-   * The password field used for authentication
-   */
-  password: string
-
-  /**
-   * The access-token expiry time in milliseconds. Defaults to 1 hour —
-   * the matching refresh token below covers the longer-lived window.
-   */
-  tokenExpiry: number
-
-  /**
-   * The refresh-token expiry time in milliseconds. Defaults to 30 days.
-   * Refresh tokens are single-use and rotate on every refresh exchange.
-   */
-  refreshTokenExpiry?: number
-
-  /**
-   * The token rotation time in hours
-   */
-  tokenRotation: number
-
-  /**
-   * The token abilities that are granted by default
-   */
-  defaultAbilities: string[]
-
-  /**
-   * The token name used when creating new tokens
-   */
-  defaultTokenName: string
-
-  /**
-   * Password reset configuration
-   */
-  passwordReset: {
-    /**
-     * Token expiration time in minutes
-     * @default 60
-     */
-    expire: number
-
-    /**
-     * Throttle time in seconds between password reset requests
-     * @default 60
-     */
-    throttle: number
-
-    /**
-     * Reset-link URL template. Supports `{token}` and `{email}`
-     * placeholders. Absolute templates (`https://…`) are used as-is;
-     * path templates are prefixed with the app URL. Lets apps whose
-     * reset page lives on a custom route reuse `passwordResets().sendEmail()`
-     * instead of hand-rolling the send.
-     * @default '/password/reset/{token}?email={email}'
-     */
-    url?: string
-  }
-
-  /**
-   * Email verification configuration
-   */
-  emailVerification?: {
-    /**
-     * Token expiration time in minutes
-     * @default 60
-     */
-    expire?: number
-
-    /**
-     * Verification-link URL template. Supports `{id}` and `{token}`
-     * placeholders. Absolute templates (`https://…`) are used as-is;
-     * path templates are prefixed with the app URL. Lets apps whose
-     * verify page lives on a custom route reuse `sendVerificationEmail()`
-     * instead of hand-rolling the send.
-     * @default '/verify-email/{id}/{token}'
-     */
-    url?: string
-  }
-}
-
-export type AuthConfig = Partial<AuthOptions>
-
-export interface AuthInstance {
-  guard: string
-  provider: string
-  user?: any
-  token?: string
-}
-
-export type GuardType = 'session' | 'token'
-export type ProviderType = 'database'
-
-export interface AuthDriver {
-  attempt: (credentials: any) => Promise<boolean>
-  validate: (token: string) => Promise<boolean>
-  login: (credentials: any) => Promise<{ token: string } | null>
-  logout: () => Promise<void>
-  user: () => Promise<any>
-  token: () => string | null
-}
-
-export interface Authenticatable {
-  getAuthIdentifier: () => any
-  getAuthPassword: () => string
-  getRememberToken: () => string
-  setRememberToken: (token: string) => void
-}

package/src/auto-imports.ts

@@ -1,8 +0,0 @@
-// `unplugin-auto-import` isn't a runtime dependency of @stacksjs/types — we
-// only re-publish its option shape so users get autocomplete in user-land
-// configs. The local type intentionally mirrors the upstream `Options`
-// surface as an open record; if/when this package adopts unplugin-auto-import
-// as a real dependency, swap this for `import type { Options }` from there.
-export interface AutoImportsOptions {
-  [key: string]: unknown
-}

package/src/binary.ts

@@ -1,13 +0,0 @@
-/**
- * The Binary/CLI Options used in `./config/cli.ts`.
- */
-export interface BinaryOptions {
-  name: string
-  command: string
-  description: string
-  source: string
-  deploy: boolean
-  // path: string // TODO: add this for a configurable path where the commands are located
-}
-
-export type BinaryConfig = Partial<BinaryOptions>