@stacksjs/tinker 0.70.88 → 0.70.91

package/dist/index.d.ts

@@ -0,0 +1,71 @@
+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

@@ -0,0 +1,138 @@
+// @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};

package/package.json

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