@econ-v1/app-sdk 7.0.18 → 7.0.20

package/dist/__tests__/lease-drain-socket.integration.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/__tests__/lease-drain.fixture.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -108,6 +108,10 @@ export interface CapabilityRequest {
     trace_context?: Record<string, string>;
     /** Opaque host-issued correlator copied only across nested capability calls. */
     invocation_context_id?: string;
+    /** Lease duration in seconds for the app's lifetime, as granted by the
+     * host's lease engine. Absent/`undefined` means an unbounded lease
+     * (T=∞ — today's behavior). Purely additive wire field. */
+    lease_secs?: number;
 }
 export interface CapabilityResponse {
     id: string;
@@ -148,6 +152,16 @@ export declare const host: {
     info: (message: string) => void;
     warn: (message: string) => void;
     error: (message: string) => void;
+    /**
+     * Hold the app's lease open for work that outlives the frame that started
+     * it (e.g. a detached background task). Increments the same in-flight
+     * counter that brackets `handleCapability`/`handleRequest`/`handleEvent`,
+     * which blocks the lease timer from arming while the hold is outstanding.
+     *
+     * Returns a release closure. Idempotent: calling it more than once has no
+     * further effect after the first call.
+     */
+    holdLease: () => (() => void);
 };
 /**
  * Invoke a capability on the host via the capability router.
@@ -167,6 +181,17 @@ export declare function invokeCapability(request: CapabilityRequest, timeoutMs?:
  * This is a fire-and-forget operation — no response is returned.
  */
 export declare function publishEvent(eventName: string, data: unknown): void;
+/** @internal test-only export; not part of the public SDK surface. */
+export declare function _testResetLeaseState(): void;
+/** @internal test-only export; not part of the public SDK surface. */
+export declare function _testSetLeaseExitFn(fn: () => void): void;
+/** @internal test-only export; not part of the public SDK surface. */
+export declare function _testLeaseState(): {
+    inFlight: number;
+    rememberedSecs: number | undefined;
+    timerArmed: boolean;
+    draining: boolean;
+};
 export interface AppMemorySample {
     heap_used_kb: number;
     heap_total_kb: number;