@junejs/db 0.0.33-dev.1 → 0.0.33-dev.2

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-import { RequestScope, blob, currentLocale, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale } from "./scope.js";
-export { type RequestScope, blob, currentLocale, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };
+import { RequestScope, blob, currentLocale, currentServices, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale } from "./scope.js";
+export { type RequestScope, blob, currentLocale, currentServices, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };

package/dist/index.js

@@ -1,2 +1,2 @@
-import { blob, currentLocale, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale } from "./scope.js";
-export { blob, currentLocale, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };
+import { blob, currentLocale, currentServices, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale } from "./scope.js";
+export { blob, currentLocale, currentServices, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };

package/dist/scope.d.ts

@@ -4,15 +4,17 @@ type RequestScope = {
   resources: Resources;
   locals?: Map<symbol, unknown>;
   locale?: string;
+  services?: unknown;
 };
 declare function ensureScope(): Promise<void>;
 declare function runInScope<T>(scope: RequestScope, fn: () => T): T;
 declare function requestLocal<T>(key: symbol, make: () => T): T;
 declare function setRequestLocale(locale: string): void;
 declare function currentLocale(): string | undefined;
+declare function currentServices<T = unknown>(): T | undefined;
 declare function registerSqlTagger(tag: (sql: string) => void): void;
 declare const db: JuneDb;
 declare const kv: JuneKv;
 declare const blob: JuneBlob;
 //#endregion
-export { RequestScope, blob, currentLocale, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };
+export { RequestScope, blob, currentLocale, currentServices, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };

package/dist/scope.js

@@ -27,6 +27,9 @@ function setRequestLocale(locale) {
 function currentLocale() {
 	return als?.getStore()?.locale;
 }
+function currentServices() {
+	return als?.getStore()?.services ?? void 0;
+}
 function pick(name) {
 	const store = als?.getStore();
 	if (!store) throw new Error(`June: \`${name}\` was used outside a request scope. Resources are only available while a request is being handled (a route loader/view or an action).`);
@@ -56,4 +59,4 @@ const db = new Proxy({}, { get(_t, prop) {
 const kv = ambient("kv");
 const blob = ambient("blob");
 //#endregion
-export { blob, currentLocale, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };
+export { blob, currentLocale, currentServices, db, ensureScope, kv, registerSqlTagger, requestLocal, runInScope, setRequestLocale };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@junejs/db",
-  "version": "0.0.33-dev.1",
+  "version": "0.0.33-dev.2",
   "description": "June — the agent-native React framework. Ambient data resources (db/kv/blob).",
   "type": "module",
   "license": "MIT",

package/src/index.ts

@@ -12,6 +12,7 @@ export {
   requestLocal,
   setRequestLocale,
   currentLocale,
+  currentServices,
   registerSqlTagger,
   type RequestScope,
 } from "./scope";

package/src/scope.ts

@@ -33,6 +33,15 @@ export type RequestScope = {
   // opt-in layer (e.g. @junejs/i18n's ambient `t`) reads it WITHOUT the core
   // pipeline depending on that layer. Undefined when no i18n is configured.
   locale?: string;
+  // App-defined services bag, seeded by the host at each ISOLATE ENTRY from that
+  // isolate's env — the Worker pipeline from the worker env, a Durable Object from
+  // its own env (env only exists inside an invocation on workerd, never at module
+  // top-level). This is the seam for resources June does NOT model (Vectorize,
+  // Workers AI, an app ledger, a signing secret): the app builds it where env lives
+  // and reads it ambiently via currentServices(), so a tool needs neither a
+  // module-global setter nor `env` on ctx. Opaque here on purpose — @junejs/db
+  // never names the app's service shape; the app supplies the type at the read.
+  services?: unknown;
 };
 
 // The minimal slice of AsyncLocalStorage we use — kept structural so this module
@@ -100,6 +109,17 @@ export function currentLocale(): string | undefined {
   return als?.getStore()?.locale;
 }
 
+// The current isolate's app-defined services bag (see RequestScope.services), or
+// undefined outside a scope / when none was seeded. Soft (returns undefined) rather
+// than throwing, because services are optional and app-defined: the app wraps this
+// in its OWN typed accessor that throws when a specific service it needs is missing.
+// @junejs/db stays generic — it carries the bag, never inspects it. A nullish bag
+// (unset OR explicitly `null`) normalizes to `undefined` so the `T | undefined`
+// return type is sound — a caller guarding only `undefined` can't be handed a null.
+export function currentServices<T = unknown>(): T | undefined {
+  return (als?.getStore()?.services ?? undefined) as T | undefined;
+}
+
 function pick<K extends keyof Resources>(name: K): NonNullable<Resources[K]> {
   const store = als?.getStore();
   if (!store) {