@cldmv/slothlet 3.15.3 → 3.16.0

package/types/stub/lib/runtime/runtime-asynclocalstorage.d.mts

@@ -1,3 +1,73 @@
 // AUTO-GENERATED by tools/build/build-typestubs.mjs — do not edit.
-// Re-exports the real declarations from @cldmv/slothlet-types (install it for TypeScript support).
-export * from "@cldmv/slothlet-types/runtime/async";
+// Self-contained copy: this subpath is internal and not published by @cldmv/slothlet-types.
+/**
+ * Live binding to the current API (self-reference)
+ * @type {Proxy}
+ * @public
+ *
+ * @description
+ * A proxy that provides access to the full API object within the current context.
+ * Automatically resolves to the correct instance's API in AsyncLocalStorage context.
+ *
+ * @example
+ * import { self } from "@cldmv/slothlet/runtime/async";
+ *
+ * export function callOtherFunction() {
+ *   // Call another function in the same API
+ *   return self.otherFunction();
+ * }
+ */
+export const self: ProxyConstructor;
+/**
+ * User-provided context object
+ * @type {Proxy}
+ * @public
+ *
+ * @description
+ * A proxy that provides access to user-provided context data (e.g., request data, user info).
+ * Can be set via `slothlet.run()` or `slothlet.scope()`.
+ *
+ * @example
+ * import { context } from "@cldmv/slothlet/runtime/async";
+ *
+ * export function getUserInfo() {
+ *   // Access user-provided context
+ *   return {
+ *     userId: context.userId,
+ *     userName: context.userName
+ *   };
+ * }
+ */
+export const context: ProxyConstructor;
+/**
+ * Reference to initialization reference object
+ * @type {Proxy}
+ * @public
+ *
+ * @description
+ * The reference object is merged directly into the API at initialization using the add API system.
+ * It is NOT available as a runtime export. Access it directly from the API or via api.slothlet.diag.reference().
+ *
+ * @example
+ * // Reference merged into API - access directly:
+ * export function useReferenceData() {
+ *   return self.myData; // if reference had myData property
+ * }
+ */
+/**
+ * Current instance ID
+ * @type {Proxy}
+ * @public
+ *
+ * @description
+ * A proxy that provides access to the current slothlet instance ID.
+ * Useful for debugging and tracking which instance is handling a request.
+ *
+ * @example
+ * import { instanceID } from "@cldmv/slothlet/runtime/async";
+ *
+ * export function getInstanceInfo() {
+ *   return { instanceID };
+ * }
+ */
+export const instanceID: ProxyConstructor;

package/types/stub/lib/runtime/runtime-livebindings.d.mts

@@ -1,3 +1,39 @@
 // AUTO-GENERATED by tools/build/build-typestubs.mjs — do not edit.
-// Re-exports the real declarations from @cldmv/slothlet-types (install it for TypeScript support).
-export * from "@cldmv/slothlet-types/runtime/live";
+// Self-contained copy: this subpath is internal and not published by @cldmv/slothlet-types.
+/**
+ * Live binding to the current API (self-reference)
+ * @type {Proxy}
+ * @public
+ *
+ * @description
+ * A proxy that provides direct access to the current instance's API.
+ * In live mode, this directly references the active instance without AsyncLocalStorage.
+ *
+ * @example
+ * import { self } from "@cldmv/slothlet/runtime/live";
+ *
+ * export function callOtherFunction() {
+ *   return self.otherFunction();
+ * }
+ */
+export const self: ProxyConstructor;
+/**
+ * User-provided context object
+ * @type {Proxy}
+ * @public
+ *
+ * @description
+ * A proxy that provides access to user-provided context data.
+ * In live mode, this directly accesses the current instance's context.
+ *
+ * @example
+ * import { context } from "@cldmv/slothlet/runtime/live";
+ *
+ * export function getUserInfo() {
+ *   return {
+ *     userId: context.userId,
+ *     userName: context.userName
+ *   };
+ * }
+ */
+export const context: ProxyConstructor;