@declaro/core 2.0.0-y.0 → 2.1.0

package/dist/node/scope/index.cjs

@@ -0,0 +1,69 @@
+var __create = Object.create;
+var __getProtoOf = Object.getPrototypeOf;
+var __defProp = Object.defineProperty;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+function __accessProp(key) {
+  return this[key];
+}
+var __toESMCache_node;
+var __toESMCache_esm;
+var __toESM = (mod, isNodeMode, target) => {
+  var canCache = mod != null && typeof mod === "object";
+  if (canCache) {
+    var cache = isNodeMode ? __toESMCache_node ??= new WeakMap : __toESMCache_esm ??= new WeakMap;
+    var cached = cache.get(mod);
+    if (cached)
+      return cached;
+  }
+  target = mod != null ? __create(__getProtoOf(mod)) : {};
+  const to = isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target;
+  for (let key of __getOwnPropNames(mod))
+    if (!__hasOwnProp.call(to, key))
+      __defProp(to, key, {
+        get: __accessProp.bind(mod, key),
+        enumerable: true
+      });
+  if (canCache)
+    cache.set(mod, to);
+  return to;
+};
+var __toCommonJS = (from) => {
+  var entry = (__moduleCache ??= new WeakMap).get(from), desc;
+  if (entry)
+    return entry;
+  entry = __defProp({}, "__esModule", { value: true });
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (var key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(entry, key))
+        __defProp(entry, key, {
+          get: __accessProp.bind(from, key),
+          enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+        });
+  }
+  __moduleCache.set(from, entry);
+  return entry;
+};
+var __moduleCache;
+var __commonJS = (cb, mod) => () => (mod || cb((mod = { exports: {} }).exports, mod), mod.exports);
+var __returnValue = (v) => v;
+function __exportSetter(name, newValue) {
+  this[name] = __returnValue.bind(null, newValue);
+}
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, {
+      get: all[name],
+      enumerable: true,
+      configurable: true,
+      set: __exportSetter.bind(all, name)
+    });
+};
+
+// src/scope/index.ts
+var exports_scope = {};
+module.exports = __toCommonJS(exports_scope);
+
+//# debugId=CF57D37C2EF99C7064756E2164756E21
+//# sourceMappingURL=index.cjs.map

package/dist/node/scope/index.cjs.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "CF57D37C2EF99C7064756E2164756E21",
+  "names": []
+}

package/dist/node/scope/index.js

@@ -0,0 +1,3 @@
+
+//# debugId=136023E5B7D33CB064756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/node/scope/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "136023E5B7D33CB064756E2164756E21",
+  "names": []
+}

package/dist/ts/app/app-context.d.ts

@@ -0,0 +1,9 @@
+import { Context, type DeclaroRequestScope } from '../context/context';
+/**
+ * Get the name of the app making the current request via header x-app. (returns "default" when no app was provided).
+ *
+ * @param context A context that includes DeclaroRequestScope properties
+ * @returns the name of the app in a string.
+ */
+export declare function useApp<S extends DeclaroRequestScope>(context: Context<S>): string | string[];
+//# sourceMappingURL=app-context.d.ts.map

package/dist/ts/app/app-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-context.d.ts","sourceRoot":"","sources":["../../../src/app/app-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAEtE;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,CAAC,SAAS,mBAAmB,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,qBAIxE"}

package/dist/ts/app/app-lifecycle.d.ts

@@ -0,0 +1,6 @@
+import { Context, type ContextListener } from '../context/context';
+import type { IEvent } from '../events';
+export declare function onInit<C extends Context>(context: C, listener: ContextListener<C, IEvent>): void;
+export declare function onStart<C extends Context>(context: C, listener: ContextListener<C, IEvent>): void;
+export declare function onDestroy<C extends Context>(context: C, listener: ContextListener<C, IEvent>): void;
+//# sourceMappingURL=app-lifecycle.d.ts.map

package/dist/ts/app/app-lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-lifecycle.d.ts","sourceRoot":"","sources":["../../../src/app/app-lifecycle.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAClE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC,wBAAgB,MAAM,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,QAEzF;AAED,wBAAgB,OAAO,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,QAE1F;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC,QAE5F"}

package/dist/ts/app/app.d.ts

@@ -0,0 +1,24 @@
+import { Context, type ContextMiddleware, type ContextListener } from '../context/context';
+import type { IEvent } from '../events';
+export type AppConfig = {
+    context?: Context;
+    init?: ContextMiddleware;
+    start?: ContextMiddleware;
+    destroy?: ContextMiddleware;
+};
+export declare class App<C extends Context = Context> {
+    readonly context: C;
+    constructor(context: C);
+    static Events: {
+        Init: string;
+        Start: string;
+        Destroy: string;
+    };
+    init(): Promise<void>;
+    onInit(listener: ContextListener<C, IEvent>): this;
+    start(): Promise<void>;
+    onStart(listener: ContextListener<C, IEvent>): void;
+    destroy(): Promise<void>;
+    onDestroy(listener: ContextListener<C, IEvent>): void;
+}
+//# sourceMappingURL=app.d.ts.map

package/dist/ts/app/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../../src/app/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,iBAAiB,EAAE,KAAK,eAAe,EAAE,MAAM,oBAAoB,CAAA;AAC1F,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAA;AAGvC,MAAM,MAAM,SAAS,GAAG;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,IAAI,CAAC,EAAE,iBAAiB,CAAA;IACxB,KAAK,CAAC,EAAE,iBAAiB,CAAA;IACzB,OAAO,CAAC,EAAE,iBAAiB,CAAA;CAC9B,CAAA;AAED,qBAAa,GAAG,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;aACZ,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC;IAEtC,MAAM,CAAC,MAAM;;;;MAIZ;IAEK,IAAI;IAKV,MAAM,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC;IAKrC,KAAK;IAIX,OAAO,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC;IAKtC,OAAO;IAIb,SAAS,CAAC,QAAQ,EAAE,eAAe,CAAC,CAAC,EAAE,MAAM,CAAC;CAGjD"}

package/dist/{app → ts/app}/index.d.ts

@@ -1,3 +1,4 @@
 export * from './app-context';
 export * from './app-lifecycle';
 export * from './app';
+//# sourceMappingURL=index.d.ts.map

package/dist/ts/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/app/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAA;AAC7B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,OAAO,CAAA"}

package/dist/ts/application/create-request-context.d.ts

@@ -0,0 +1,4 @@
+import { Context, type DeclaroRequestScope, type DeclaroScope } from '../context/context';
+import { type Request } from '../http/request';
+export declare function createRequestContext<S extends DeclaroScope>(appContext: Context<S>, request: Request): Promise<Context<DeclaroRequestScope>>;
+//# sourceMappingURL=create-request-context.d.ts.map

package/dist/ts/application/create-request-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-request-context.d.ts","sourceRoot":"","sources":["../../../src/application/create-request-context.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,KAAK,mBAAmB,EAAE,KAAK,YAAY,EAAE,MAAM,oBAAoB,CAAA;AACzF,OAAO,EAAkB,KAAK,OAAO,EAAE,MAAM,iBAAiB,CAAA;AAE9D,wBAAsB,oBAAoB,CAAC,CAAC,SAAS,YAAY,EAC7D,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,EACtB,OAAO,EAAE,OAAO,GACjB,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAC,CAYvC"}

package/dist/ts/application/create-request-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-request-context.test.d.ts.map

package/dist/ts/application/create-request-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-request-context.test.d.ts","sourceRoot":"","sources":["../../../src/application/create-request-context.test.ts"],"names":[],"mappings":""}

package/dist/ts/application/use-declaro.d.ts

@@ -0,0 +1,3 @@
+import type { Context, DeclaroScope } from '../context/context';
+export declare function useDeclaro(): <S extends DeclaroScope>(context: Context<S>) => Promise<void>;
+//# sourceMappingURL=use-declaro.d.ts.map

package/dist/ts/application/use-declaro.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"use-declaro.d.ts","sourceRoot":"","sources":["../../../src/application/use-declaro.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAG/D,wBAAgB,UAAU,KACR,CAAC,SAAS,YAAY,EAAE,SAAS,OAAO,CAAC,CAAC,CAAC,mBAqB5D"}

package/dist/{auth → ts/auth}/permission-validator.d.ts

@@ -32,3 +32,4 @@ export declare class PermissionValidator {
     validate(permissions?: string[]): boolean;
     safeValidate(permissions?: string[]): PermissionValidationResults;
 }
+//# sourceMappingURL=permission-validator.d.ts.map

package/dist/ts/auth/permission-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-validator.d.ts","sourceRoot":"","sources":["../../../src/auth/permission-validator.ts"],"names":[],"mappings":"AAEA,oBAAY,kBAAkB;IAC1B,MAAM,WAAW;IACjB,OAAO,YAAY;IACnB,OAAO,YAAY;CACtB;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,mBAAmB,CAAA;AAEzD,MAAM,MAAM,cAAc,GAAG;IACzB,IAAI,EAAE,kBAAkB,CAAA;IACxB,WAAW,EAAE,cAAc,EAAE,CAAA;IAC7B,YAAY,EAAE,MAAM,CAAA;CACvB,CAAA;AAED,qBAAa,eAAgB,SAAQ,KAAK;IACF,IAAI,EAAE,cAAc;IAAS,WAAW,EAAE,cAAc,EAAE;gBAAlF,OAAO,EAAE,MAAM,EAAS,IAAI,EAAE,cAAc,EAAS,WAAW,EAAE,cAAc,EAAE;CAGjG;AAED,MAAM,MAAM,2BAA2B,GAAG;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,eAAe,EAAE,CAAA;CAC5B,CAAA;AAED,qBAAa,mBAAmB;IAC5B,QAAQ,CAAC,KAAK,EAAE,cAAc,EAAE,CAAK;IACrC,MAAM,CAAC,MAAM;IAIb,OAAO,CAAC,GAAG,IAAI,EAAE,cAAc,EAAE;IAKjC,MAAM,CAAC,GAAG,UAAU,EAAE,mBAAmB,EAAE;IAO3C,KAAK,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,YAAY,GAAE,MAAmD;IAStG,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,YAAY,GAAE,MAAyC;IAS7F,MAAM,CAAC,WAAW,EAAE,cAAc,EAAE,EAAE,YAAY,GAAE,MAA0D;IAS9G,OAAO,CAAC,YAAY;IAYpB,OAAO,CAAC,aAAa;IAUrB,QAAQ,CAAC,WAAW,GAAE,MAAM,EAAO;IAYnC,YAAY,CAAC,WAAW,GAAE,MAAM,EAAO,GAAG,2BAA2B;CA2BxE"}

package/dist/ts/auth/permission-validator.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=permission-validator.test.d.ts.map

package/dist/ts/auth/permission-validator.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"permission-validator.test.d.ts","sourceRoot":"","sources":["../../../src/auth/permission-validator.test.ts"],"names":[],"mappings":""}

package/dist/ts/context/async-context.d.ts

@@ -0,0 +1,54 @@
+import type { Context } from './context';
+/**
+ * Minimal interface for the storage backing `withContext` / `useContext`.
+ * Satisfied by Node's native `AsyncLocalStorage` and by the browser shim.
+ */
+export interface AsyncContextStorage<C extends Context = Context> {
+    run<R>(store: C, fn: (...args: any[]) => R, ...args: any[]): R;
+    getStore(): C | undefined;
+}
+export interface UseContextOptions {
+    strict?: boolean;
+}
+/**
+ * Create a `withContext` / `useContext` pair backed by the given storage.
+ *
+ * The generic type parameter `C` fixes the context type enforced by both
+ * functions, keeping the pair consistent. If no storage is provided, a new
+ * `AsyncLocalStorage<C>` is created automatically — in browser builds this
+ * resolves to the synchronous shim, so callers don't need to think about it.
+ *
+ * Pass a custom storage explicitly when you need an alternative
+ * implementation (e.g. a test spy or the browser shim in a test environment):
+ *
+ * @example Default (auto-polyfilled in browser builds)
+ * ```ts
+ * const { withContext, useContext } = createContextAPI<MyContext>()
+ * ```
+ *
+ * @example Custom storage (for testing or advanced use)
+ * ```ts
+ * import { AsyncLocalStorage } from '../shims/async-local-storage'
+ * const { withContext, useContext } = createContextAPI<MyContext>(new AsyncLocalStorage())
+ * ```
+ */
+export declare function createContextAPI<C extends Context = Context>(storage?: AsyncContextStorage<C>): {
+    withContext: <T = unknown>(context: C, fn: () => T) => T;
+    useContext: {
+        <U extends C = C>(options?: {
+            strict?: false;
+        }): U | null;
+        <U extends C = C>(options: {
+            strict: true;
+        }): U;
+    };
+};
+export declare const withContext: <T = unknown>(context: Context<any>, fn: () => T) => T, useContext: {
+    <U extends Context<any> = Context<any>>(options?: {
+        strict?: false;
+    } | undefined): U | null;
+    <U extends Context<any> = Context<any>>(options: {
+        strict: true;
+    }): U;
+};
+//# sourceMappingURL=async-context.d.ts.map

package/dist/ts/context/async-context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.d.ts","sourceRoot":"","sources":["../../../src/context/async-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC;;;GAGG;AACH,MAAM,WAAW,mBAAmB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO;IAC5D,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,CAAC,CAAA;IAC9D,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAA;CAC5B;AAED,MAAM,WAAW,iBAAiB;IAC9B,MAAM,CAAC,EAAE,OAAO,CAAA;CACnB;AAED;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,OAAO,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC;kBA6CrE,CAAC,qBAAqB,CAAC,MAAM,MAAM,CAAC,KAAG,CAAC;;SA2BzC,CAAC,SAAS,CAAC,gBAAgB;YAAE,MAAM,CAAC,EAAE,KAAK,CAAA;SAAE,GAAG,CAAC,GAAG,IAAI;SACxD,CAAC,SAAS,CAAC,eAAe;YAAE,MAAM,EAAE,IAAI,CAAA;SAAE,GAAG,CAAC;;EAYrE;AAKD,eAAO,MAAQ,WAAW,GA7CD,CAAC,sDA6CE,UAAU;KAlBd,CAAC;iBAAqC,KAAK;;KAC3C,CAAC;gBAAmC,IAAI;;CAiBM,CAAA"}

package/dist/ts/context/async-context.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=async-context.test.d.ts.map

package/dist/ts/context/async-context.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"async-context.test.d.ts","sourceRoot":"","sources":["../../../src/context/async-context.test.ts"],"names":[],"mappings":""}

package/dist/{context → ts/context}/context-consumer.d.ts

@@ -1,5 +1,9 @@
 import { Context } from './context';
+/**
+ * @deprecated Inject dependencies directly into the constructor of the class that needs them.
+ */
 export declare class ContextConsumer<C extends Context = Context, A extends any[] = any[]> {
     protected readonly context: C;
     constructor(context: C, ...args: A);
 }
+//# sourceMappingURL=context-consumer.d.ts.map

package/dist/ts/context/context-consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context-consumer.d.ts","sourceRoot":"","sources":["../../../src/context/context-consumer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC;;GAEG;AACH,qBAAa,eAAe,CAAC,CAAC,SAAS,OAAO,GAAG,OAAO,EAAE,CAAC,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE;IACjE,SAAS,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;gBAAV,OAAO,EAAE,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC;CACxD"}

package/dist/ts/context/context.circular-deps.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=context.circular-deps.test.d.ts.map

package/dist/ts/context/context.circular-deps.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.circular-deps.test.d.ts","sourceRoot":"","sources":["../../../src/context/context.circular-deps.test.ts"],"names":[],"mappings":""}