@stacksjs/tinker 0.70.86 → 0.70.88

package/package.json

@@ -2,7 +2,7 @@
   "name": "@stacksjs/tinker",
   "type": "module",
   "sideEffects": false,
-  "version": "0.70.86",
+  "version": "0.70.88",
   "description": "Interactive REPL with Stacks framework preloaded.",
   "author": "Chris Breuer",
   "contributors": [

package/dist/index.d.ts

@@ -1,71 +0,0 @@
-import type { Subprocess } from 'bun';
-export type { Subprocess };
-/**
- * Get the path to the tinker history file.
- */
-export declare function getHistoryPath(config?: TinkerConfig): string;
-/**
- * Read history entries from file.
- */
-export declare function readHistory(config?: TinkerConfig): string[];
-/**
- * Append a single entry to the history file.
- *
- * The history file lives at `~/.stacks_tinker_history` and accumulates
- * every expression a developer types — including any one-off pasted
- * tokens, API keys, or DB credentials. Forcing 0600 permissions keeps
- * the file readable only by the file's owner so other users on a shared
- * machine can't grep it for accidentally-committed secrets.
- */
-export declare function appendHistory(entry: string, config?: TinkerConfig): void;
-/**
- * Clear the tinker history file.
- */
-export declare function clearHistory(config?: TinkerConfig): void;
-/**
- * Start an interactive Stacks tinker session.
- *
- * Launches Bun's built-in REPL with all Stacks framework modules
- * preloaded into the global scope. ORM models, database, config,
- * logging, and other framework utilities are immediately available.
- *
- * @example
- * ```ts
- * import { startTinker } from '@stacksjs/tinker'
- *
- * await startTinker()
- * ```
- *
- * @example
- * ```ts
- * // Evaluate a single expression
- * await startTinker({ eval: 'await User.count()' })
- * ```
- *
- * @example
- * ```ts
- * // Evaluate and print
- * await startTinker({ print: 'await User.all()' })
- * ```
- */
-export declare function startTinker(config?: TinkerConfig): Promise<{ exitCode: number }>;
-/**
- * Convenience function to evaluate a single expression in tinker context
- * and return the result.
- */
-export declare function tinkerEval(expression: string, config?: TinkerConfig): Promise<{ exitCode: number }>;
-/**
- * Convenience function to evaluate and print a single expression.
- */
-export declare function tinkerPrint(expression: string, config?: TinkerConfig): Promise<{ exitCode: number }>;
-export declare interface TinkerConfig {
-  preload?: string[]
-  historyFile?: string
-  historySize?: number
-  cwd?: string
-  banner?: boolean
-  stacksPreload?: boolean
-  eval?: string
-  print?: string
-  verbose?: boolean
-}

package/dist/index.js

@@ -1,138 +0,0 @@
-// @bun
-var U=import.meta.require;import{existsSync as W,readFileSync as _,writeFileSync as M,appendFileSync as $,chmodSync as V}from"fs";import{homedir as b}from"os";import{join as Q}from"path";import L from"process";function X(q){let A=[];if(q.stacksPreload!==!1)A.push(`
-// ---- Stacks Framework Preload ----
-// ORM & Database
-try {
-  const { db } = await import('@stacksjs/database')
-  globalThis.db = db
-} catch {}
-
-try {
-  const orm = await import('@stacksjs/orm')
-  // Expose all ORM exports globally (User, Post, etc.)
-  for (const [key, value] of Object.entries(orm)) {
-    if (key !== 'default' && key !== 'db') {
-      globalThis[key] = value
-    }
-  }
-} catch {}
-
-// Config
-try {
-  const config = await import('@stacksjs/config')
-  globalThis.config = config
-} catch {}
-
-// Path utilities
-try {
-  const path = await import('@stacksjs/path')
-  globalThis.path = path
-} catch {}
-
-// Storage
-try {
-  const storage = await import('@stacksjs/storage')
-  globalThis.storage = storage
-} catch {}
-
-// Validation
-try {
-  const validation = await import('@stacksjs/validation')
-  globalThis.validation = validation
-} catch {}
-
-// Logging
-try {
-  const { log } = await import('@stacksjs/cli')
-  globalThis.log = log
-} catch {}
-
-// Collections
-try {
-  const collections = await import('@stacksjs/collections')
-  globalThis.collect = collections.collect ?? collections.default
-} catch {}
-
-// Strings
-try {
-  const strings = await import('@stacksjs/strings')
-  globalThis.Str = strings
-} catch {}
-
-// Cache
-try {
-  const cache = await import('@stacksjs/cache')
-  globalThis.cache = cache
-} catch {}
-
-// Queue / Jobs
-try {
-  const queue = await import('@stacksjs/queue')
-  globalThis.queue = queue
-} catch {}
-
-// Events
-try {
-  const events = await import('@stacksjs/events')
-  globalThis.events = events
-} catch {}
-
-// Router
-try {
-  const router = await import('@stacksjs/router')
-  globalThis.router = router
-} catch {}
-
-// Auth
-try {
-  const auth = await import('@stacksjs/auth')
-  globalThis.auth = auth
-} catch {}
-
-// Notifications
-try {
-  const notifications = await import('@stacksjs/notifications')
-  globalThis.notifications = notifications
-} catch {}
-
-// Env / environment helpers
-try {
-  const env = await import('@stacksjs/env')
-  globalThis.env = env
-} catch {}
-
-// validate() shortcut \u2014 paired with schema for fluent validation in REPL.
-try {
-  const { validate } = await import('@stacksjs/validation')
-  globalThis.validate = validate
-} catch {}
-
-// Jobs facade \u2014 lets you fire jobs without remembering the dispatch builder.
-try {
-  const { Jobs } = await import('@stacksjs/queue')
-  globalThis.Jobs = Jobs
-} catch {}
-
-// Request introspection \u2014 only useful inside an active request, but
-// the proxy is safe to expose: outside a request scope every property
-// returns a typed default (see request-context.ts).
-try {
-  const { request, listRegisteredRoutes } = await import('@stacksjs/router')
-  globalThis.request = request
-  globalThis.routes = listRegisteredRoutes
-} catch {}
-
-// dump/dd helpers for quick inspection \u2014 a Laravel-ism that's always
-// nice to have at the REPL when investigating a value.
-globalThis.dump = (...args) => { console.dir(args.length === 1 ? args[0] : args, { depth: 6, colors: true }) }
-globalThis.dd = (...args) => { console.dir(args.length === 1 ? args[0] : args, { depth: 6, colors: true }); process.exit(0) }
-`);if(q.preload?.length)for(let D of q.preload){let E=D.replace(/[@/\-\.]/g,"_").replace(/^_+/,"");A.push(`try { globalThis.${E} = await import('${D}') } catch {}`)}return A.join(`
-`)}function R(q){return q?.historyFile??Q(b(),".stacks_tinker_history")}function B(q){let A=R(q);if(!W(A))return[];return _(A,"utf-8").split(`
-`).filter(Boolean)}function v(q,A){let D=R(A),E=!W(D);if($(D,`${q}
-`),E)try{V(D,384)}catch{}let J=A?.historySize??5000,G=B(A);if(G.length>J){let K=G.slice(G.length-J);M(D,K.join(`
-`)+`
-`);try{V(D,384)}catch{}}}function H(q){let A=R(q);M(A,"")}function I(){return["",`  \x1B[36mStacks Tinker\x1B[0m (Bun v${typeof Bun<"u"?Bun.version:"unknown"})`,"  Interactive REPL with Stacks framework preloaded.","","  \x1B[2mAvailable globals: db, config, path, storage, log, Str,","  cache, queue, events, router, auth, collect, env, request,","  validate, Jobs, routes, dump, dd","  + all ORM models (User, Post, etc.)\x1B[0m","","  \x1B[2mType .help for REPL commands. Press Ctrl+D to exit.\x1B[0m",""].join(`
-`)}async function Y(q={}){let A=q.cwd??L.cwd();if(q.eval||q.print)return z(q,A);if(q.banner!==!1)L.stdout.write(I());let D=X(q),E=Q(A,".tinker-preload.ts");M(E,D);let J=["repl"],K=await Bun.spawn(["bun",...J],{cwd:A,stdin:"inherit",stdout:"inherit",stderr:"inherit",env:{...L.env,BUN_PRELOAD:E}}).exited;try{let{unlinkSync:O}=await import("fs");O(E)}catch{}return{exitCode:K}}async function z(q,A){let D=X(q),E=q.print??q.eval??"",J=`${D}
-
-const __result__ = await (async () => { return ${E} })()
-${q.print?"console.log(__result__)":""}`,G=Q(A,".tinker-eval.ts");M(G,J);let O=await Bun.spawn(["bun","run",G],{cwd:A,stdin:"inherit",stdout:"inherit",stderr:"inherit",env:L.env}).exited;try{let{unlinkSync:Z}=await import("fs");Z(G)}catch{}return{exitCode:O}}async function u(q,A={}){return Y({...A,eval:q})}async function F(q,A={}){return Y({...A,print:q})}export{F as tinkerPrint,u as tinkerEval,Y as startTinker,B as readHistory,R as getHistoryPath,H as clearHistory,v as appendHistory};