ras-stack 0.12.0 → 0.13.0

package/README.md

@@ -208,6 +208,17 @@ await startTusUpload(upload)
 
 Applications retain ownership of email templates, missing-email behavior, upload metadata, authorization, quotas, and completion processing.
 
+Stateful development servers can reuse one typed resource across HMR without application-specific `globalThis` casts:
+
+```ts
+import { clearGlobalSingleton, globalAsyncSingleton } from 'ras-stack/server'
+
+export const app = () => globalAsyncSingleton('my-app.instance', createApp)
+export const resetApp = () => clearGlobalSingleton('my-app.instance', (instance) => instance.close())
+```
+
+Rejected async initialization removes only its own pending value so a later request can retry. Clearing deletes the key before awaiting initialization or disposal, allowing replacement startup without reusing a closing resource.
+
 ## Shared project configuration
 
 Extend the supplied configuration and override anything specific to the application:

package/dist/server/index.d.ts

@@ -1,3 +1,4 @@
 export * from './canonical-host.js';
 export * from './health.js';
 export * from './rpc.js';
+export * from './singleton.js';

package/dist/server/index.js

@@ -1,4 +1,5 @@
 export * from './canonical-host.js';
 export * from './health.js';
 export * from './rpc.js';
+export * from './singleton.js';
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA","sourcesContent":["export * from './canonical-host.js'\nexport * from './health.js'\nexport * from './rpc.js'\n"]}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,UAAU,CAAA;AACxB,cAAc,gBAAgB,CAAA","sourcesContent":["export * from './canonical-host.js'\nexport * from './health.js'\nexport * from './rpc.js'\nexport * from './singleton.js'\n"]}

package/dist/server/singleton.d.ts

@@ -0,0 +1,4 @@
+export declare function globalSingleton<T>(key: string, create: () => T): T;
+export declare function globalAsyncSingleton<T>(key: string, create: () => T | Promise<T>): Promise<T>;
+export declare function peekGlobalSingleton(key: string): unknown;
+export declare function clearGlobalSingleton<T>(key: string, dispose?: (value: Awaited<T>) => void | Promise<void>): Promise<boolean>;

package/dist/server/singleton.js

@@ -0,0 +1,48 @@
+const storeKey = Symbol.for('ras-stack.server.singletons');
+function store() {
+    const target = globalThis;
+    return (target[storeKey] ??= new Map());
+}
+export function globalSingleton(key, create) {
+    const singletons = store();
+    const existing = singletons.get(key);
+    if (existing) {
+        if (existing.kind !== 'sync')
+            throw new Error(`singleton ${key} is asynchronous`);
+        return existing.value;
+    }
+    const value = create();
+    singletons.set(key, { kind: 'sync', value });
+    return value;
+}
+export function globalAsyncSingleton(key, create) {
+    const singletons = store();
+    const existing = singletons.get(key);
+    if (existing) {
+        if (existing.kind !== 'async')
+            throw new Error(`singleton ${key} is synchronous`);
+        return existing.value;
+    }
+    const pending = Promise.resolve().then(create);
+    const guarded = pending.catch((error) => {
+        if (singletons.get(key)?.value === guarded)
+            singletons.delete(key);
+        throw error;
+    });
+    singletons.set(key, { kind: 'async', value: guarded });
+    return guarded;
+}
+export function peekGlobalSingleton(key) {
+    return store().get(key)?.value;
+}
+export async function clearGlobalSingleton(key, dispose) {
+    const singletons = store();
+    if (!singletons.has(key))
+        return false;
+    const value = singletons.get(key)?.value;
+    singletons.delete(key);
+    if (dispose)
+        await dispose(await value);
+    return true;
+}
+//# sourceMappingURL=singleton.js.map

package/dist/server/singleton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.js","sourceRoot":"","sources":["../../src/server/singleton.ts"],"names":[],"mappings":"AAAA,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAA;AAI1D,SAAS,KAAK;IACZ,MAAM,MAAM,GAAG,UAA6B,CAAA;IAC5C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,GAAG,EAAE,CAAC,CAAA;AACzC,CAAC;AAED,MAAM,UAAU,eAAe,CAAI,GAAW,EAAE,MAAe;IAC7D,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,kBAAkB,CAAC,CAAA;QACjF,OAAO,QAAQ,CAAC,KAAU,CAAA;IAC5B,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,EAAE,CAAA;IACtB,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAA;IAC5C,OAAO,KAAK,CAAA;AACd,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAI,GAAW,EAAE,MAA4B;IAC/E,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;IACpC,IAAI,QAAQ,EAAE,CAAC;QACb,IAAI,QAAQ,CAAC,IAAI,KAAK,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,aAAa,GAAG,iBAAiB,CAAC,CAAA;QACjF,OAAO,QAAQ,CAAC,KAAmB,CAAA;IACrC,CAAC;IACD,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;QAC/C,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,KAAK,OAAO;YAAE,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;QAClE,MAAM,KAAK,CAAA;IACb,CAAC,CAAC,CAAA;IACF,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAA;IACtD,OAAO,OAAO,CAAA;AAChB,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAK,CAAA;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAI,GAAW,EAAE,OAAqD;IAC9G,MAAM,UAAU,GAAG,KAAK,EAAE,CAAA;IAC1B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IACtC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,KAAU,CAAA;IAC7C,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAA;IACtB,IAAI,OAAO;QAAE,MAAM,OAAO,CAAC,MAAM,KAAK,CAAC,CAAA;IACvC,OAAO,IAAI,CAAA;AACb,CAAC","sourcesContent":["const storeKey = Symbol.for('ras-stack.server.singletons')\ntype SingletonEntry = { kind: 'sync' | 'async'; value: unknown }\ntype SingletonGlobal = typeof globalThis & { [storeKey]?: Map<string, SingletonEntry> }\n\nfunction store() {\n  const target = globalThis as SingletonGlobal\n  return (target[storeKey] ??= new Map())\n}\n\nexport function globalSingleton<T>(key: string, create: () => T): T {\n  const singletons = store()\n  const existing = singletons.get(key)\n  if (existing) {\n    if (existing.kind !== 'sync') throw new Error(`singleton ${key} is asynchronous`)\n    return existing.value as T\n  }\n  const value = create()\n  singletons.set(key, { kind: 'sync', value })\n  return value\n}\n\nexport function globalAsyncSingleton<T>(key: string, create: () => T | Promise<T>): Promise<T> {\n  const singletons = store()\n  const existing = singletons.get(key)\n  if (existing) {\n    if (existing.kind !== 'async') throw new Error(`singleton ${key} is synchronous`)\n    return existing.value as Promise<T>\n  }\n  const pending = Promise.resolve().then(create)\n  const guarded = pending.catch((error: unknown) => {\n    if (singletons.get(key)?.value === guarded) singletons.delete(key)\n    throw error\n  })\n  singletons.set(key, { kind: 'async', value: guarded })\n  return guarded\n}\n\nexport function peekGlobalSingleton(key: string): unknown {\n  return store().get(key)?.value\n}\n\nexport async function clearGlobalSingleton<T>(key: string, dispose?: (value: Awaited<T>) => void | Promise<void>) {\n  const singletons = store()\n  if (!singletons.has(key)) return false\n  const value = singletons.get(key)?.value as T\n  singletons.delete(key)\n  if (dispose) await dispose(await value)\n  return true\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ras-stack",
-  "version": "0.12.0",
+  "version": "0.13.0",
   "description": "Composable full-stack primitives shared across Richard Solomou's applications.",
   "keywords": [
     "authentication",