@nimiplatform/sdk 0.5.14

package/dist/runtime/runtime-app-lifecycle-decode.js

@@ -0,0 +1,282 @@
+import { ReasonCode } from '../types/index.js';
+import { createNimiError } from './errors.js';
+import { toIsoFromTimestamp } from './helpers.js';
+import { AppInstallJobPhase as ProtoAppInstallJobPhase, AppInstallJobState as ProtoAppInstallJobState, AppInstallSourceKind as ProtoAppInstallSourceKind, AppLifecycleJobKind as ProtoAppLifecycleJobKind, AppOpenFlowStep as ProtoAppOpenFlowStep, AppOpenState as ProtoAppOpenState, } from './generated/runtime/v1/app.js';
+import { ReasonCode as RuntimeReasonCode } from './generated/runtime/v1/common.js';
+// ── Proto → typed decode (fail-closed) ─────────────────────────────────
+function decodeError(message, reasonCode) {
+    throw createNimiError({
+        message,
+        reasonCode,
+        actionHint: 'check_runtime_app_lifecycle_projection',
+        source: 'runtime',
+    });
+}
+function optionalString(value) {
+    return typeof value === 'string' && value.trim() ? value.trim() : undefined;
+}
+function decodePhase(value) {
+    switch (value) {
+        case ProtoAppInstallJobPhase.QUEUED:
+            return 'queued';
+        case ProtoAppInstallJobPhase.RESOLVE_DESCRIPTOR:
+            return 'resolve_descriptor';
+        case ProtoAppInstallJobPhase.DOWNLOAD:
+            return 'download';
+        case ProtoAppInstallJobPhase.VERIFY:
+            return 'verify';
+        case ProtoAppInstallJobPhase.MATERIALIZE:
+            return 'materialize';
+        case ProtoAppInstallJobPhase.UNPACK:
+            return 'unpack';
+        case ProtoAppInstallJobPhase.EVIDENCE:
+            return 'evidence';
+        case ProtoAppInstallJobPhase.INSTALLED:
+            return 'installed';
+        case ProtoAppInstallJobPhase.SWAP:
+            return 'swap';
+        case ProtoAppInstallJobPhase.FAILED:
+            return 'failed';
+        case ProtoAppInstallJobPhase.CANCELLED:
+            return 'cancelled';
+        case ProtoAppInstallJobPhase.UNINSTALLED:
+            return 'uninstalled';
+        default:
+            return decodeError(`runtime app install job has unspecified phase: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+}
+function decodeState(value) {
+    switch (value) {
+        case ProtoAppInstallJobState.QUEUED:
+            return 'queued';
+        case ProtoAppInstallJobState.IN_PROGRESS:
+            return 'in_progress';
+        case ProtoAppInstallJobState.INSTALLED:
+            return 'installed';
+        case ProtoAppInstallJobState.FAILED:
+            return 'failed';
+        case ProtoAppInstallJobState.CANCELLED:
+            return 'cancelled';
+        case ProtoAppInstallJobState.UNINSTALLED:
+            return 'uninstalled';
+        default:
+            return decodeError(`runtime app install job has unspecified state: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+}
+function decodeKind(value) {
+    switch (value) {
+        case ProtoAppLifecycleJobKind.INSTALL:
+            return 'install';
+        case ProtoAppLifecycleJobKind.UPDATE:
+            return 'update';
+        case ProtoAppLifecycleJobKind.REPAIR:
+            return 'repair';
+        case ProtoAppLifecycleJobKind.UNINSTALL:
+            return 'uninstall';
+        default:
+            return decodeError(`runtime app install job has unspecified kind: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+}
+function decodeSourceKind(value) {
+    switch (value) {
+        case ProtoAppInstallSourceKind.BUNDLED:
+            return 'bundled';
+        case ProtoAppInstallSourceKind.EXTERNAL_ARTIFACT:
+            return 'external_artifact';
+        default:
+            return decodeError(`runtime app install job has unspecified source kind: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+}
+/**
+ * Map a runtime-owned numeric `ReasonCode` to its stable string name. An
+ * unknown / unspecified code fail-closes — it is never collapsed silently.
+ */
+function decodeReasonCode(value) {
+    if (!Number.isFinite(value) || value === RuntimeReasonCode.REASON_CODE_UNSPECIFIED) {
+        return undefined;
+    }
+    const name = RuntimeReasonCode[value];
+    if (!name) {
+        return decodeError(`runtime app lifecycle job carries an unknown reason code: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    return String(name).trim();
+}
+function decodeStorage(storage) {
+    if (!storage) {
+        return decodeError('runtime app lifecycle projection is missing the storage roots', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    return {
+        appRoot: storage.appRoot,
+        releaseRoot: storage.releaseRoot,
+        durableDataRoot: storage.durableDataRoot,
+        cacheRoot: storage.cacheRoot,
+        tempRoot: storage.tempRoot,
+    };
+}
+function toBytes(value) {
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : 0;
+}
+function toSequence(value) {
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        return decodeError(`runtime app install job event has an invalid sequence: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    return parsed;
+}
+/**
+ * Decode a proto `AppInstallJob` into the typed projection. A missing job
+ * fail-closes — the consumer never receives a synthesized placeholder.
+ */
+export function decodeAppInstallJob(job) {
+    if (!job) {
+        return decodeError('runtime app lifecycle response is missing the job projection', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const jobId = optionalString(job.jobId);
+    if (!jobId) {
+        return decodeError('runtime app install job is missing a job id', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const appId = optionalString(job.appId);
+    if (!appId) {
+        return decodeError('runtime app install job is missing an app id', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const state = decodeState(job.state);
+    const reasonCode = decodeReasonCode(job.reasonCode);
+    // A failed / cancelled job must always carry a typed reason code so the
+    // consumer never has to invent one — fail-close if the runtime omits it.
+    if ((state === 'failed' || state === 'cancelled') && !reasonCode) {
+        return decodeError(`runtime app install job ${jobId} is ${state} without a typed reason code`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    return {
+        jobId,
+        appId,
+        kind: decodeKind(job.kind),
+        releaseDescriptorRef: job.releaseDescriptorRef,
+        installedVersion: job.installedVersion,
+        ...(optionalString(job.previousVersion)
+            ? { previousVersion: optionalString(job.previousVersion) }
+            : {}),
+        state,
+        phase: decodePhase(job.phase),
+        sourceKind: decodeSourceKind(job.sourceKind),
+        ...(optionalString(job.sha256) ? { sha256: optionalString(job.sha256) } : {}),
+        artifactBytes: toBytes(job.artifactBytes),
+        storage: decodeStorage(job.storage),
+        ...(reasonCode ? { reasonCode } : {}),
+        ...(optionalString(job.failureDetail)
+            ? { failureDetail: optionalString(job.failureDetail) }
+            : {}),
+        retryable: job.retryable,
+        ...(optionalString(job.createdAt) ? { createdAt: optionalString(job.createdAt) } : {}),
+        ...(optionalString(job.updatedAt) ? { updatedAt: optionalString(job.updatedAt) } : {}),
+    };
+}
+export function decodeUninstallResult(result, jobProjection) {
+    if (!result) {
+        return decodeError('runtime uninstall response is missing the result projection', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const appId = optionalString(result.appId);
+    if (!appId) {
+        return decodeError('runtime uninstall result is missing an app id', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const reasonCode = decodeReasonCode(result.reasonCode);
+    // The uninstall response carries the watchable uninstall lifecycle job
+    // (K-APP-017) — the single live-job truth source for the `uninstalling`
+    // card state. A missing job fail-closes; it is never synthesized.
+    const job = decodeAppInstallJob(jobProjection);
+    return {
+        appId,
+        releaseRemoved: result.releaseRemoved,
+        durableDataRemoved: result.durableDataRemoved,
+        storage: decodeStorage(result.storage),
+        ...(reasonCode ? { reasonCode } : {}),
+        job,
+    };
+}
+function decodeOpenFlowStep(value) {
+    switch (value) {
+        case ProtoAppOpenFlowStep.RESOLVE_REGISTRY:
+            return 'resolve_registry';
+        case ProtoAppOpenFlowStep.VERIFY_PACKAGE:
+            return 'verify_package';
+        case ProtoAppOpenFlowStep.VERIFY_LIBRARY:
+            return 'verify_library';
+        case ProtoAppOpenFlowStep.VERIFY_APP_DATA:
+            return 'verify_app_data';
+        case ProtoAppOpenFlowStep.VERIFY_PERMISSIONS:
+            return 'verify_permissions';
+        case ProtoAppOpenFlowStep.ENSURE_AICONFIG:
+            return 'ensure_aiconfig';
+        case ProtoAppOpenFlowStep.VALIDATE_MANIFEST:
+            return 'validate_manifest';
+        case ProtoAppOpenFlowStep.LAUNCH:
+            return 'launch';
+        default:
+            return decodeError(`runtime app open projection has an unspecified flow step: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+}
+function decodeOpenState(value) {
+    switch (value) {
+        case ProtoAppOpenState.LAUNCHED:
+            return 'launched';
+        case ProtoAppOpenState.BLOCKED:
+            return 'blocked';
+        default:
+            return decodeError(`runtime app open projection has an unspecified state: ${String(value)}`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+}
+function decodeOpenScope(scope) {
+    if (!scope)
+        return undefined;
+    const ownerId = optionalString(scope.ownerId);
+    if (scope.kind !== 'app' || !ownerId) {
+        return decodeError('runtime app open projection carries a non-canonical app-launch scope', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const surfaceId = optionalString(scope.surfaceId);
+    return {
+        kind: 'app',
+        ownerId,
+        ...(surfaceId ? { surfaceId } : {}),
+    };
+}
+/**
+ * Decode a proto `AppOpenProjection` into the typed projection. A `blocked`
+ * open must always carry a typed reason code so the consumer never has to
+ * invent one — fail-close if the runtime omits it.
+ */
+export function decodeOpenProjection(projection) {
+    if (!projection) {
+        return decodeError('runtime open response is missing the open projection', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const appId = optionalString(projection.appId);
+    if (!appId) {
+        return decodeError('runtime app open projection is missing an app id', ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const state = decodeOpenState(projection.state);
+    const reasonCode = decodeReasonCode(projection.reasonCode);
+    if (state === 'blocked' && !reasonCode) {
+        return decodeError(`runtime app open projection for ${appId} is blocked without a typed reason code`, ReasonCode.SDK_RUNTIME_RESPONSE_DECODE_FAILED);
+    }
+    const activeVersion = optionalString(projection.activeVersion);
+    const detail = optionalString(projection.detail);
+    const scope = decodeOpenScope(projection.scope);
+    return {
+        appId,
+        state,
+        reachedStep: decodeOpenFlowStep(projection.reachedStep),
+        launched: projection.launched,
+        ...(activeVersion ? { activeVersion } : {}),
+        ...(scope ? { scope } : {}),
+        ...(reasonCode ? { reasonCode } : {}),
+        ...(detail ? { detail } : {}),
+    };
+}
+export function decodeJobEvent(event) {
+    const timestamp = toIsoFromTimestamp(event.timestamp);
+    return {
+        sequence: toSequence(event.sequence),
+        job: decodeAppInstallJob(event.job),
+        ...(timestamp ? { timestamp } : {}),
+    };
+}
+//# sourceMappingURL=runtime-app-lifecycle-decode.js.map

package/dist/runtime/runtime-app-lifecycle-decode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-app-lifecycle-decode.js","sourceRoot":"","sources":["../../src/runtime/runtime-app-lifecycle-decode.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,197 @@
+import type { RuntimeCallOptions, RuntimeStreamCallOptions } from './types.js';
+/**
+ * Concrete install/update/repair pipeline phase. Mirrors
+ * `AppInstallJobPhase`; the consumer renders the exact step rather than a
+ * generic spinner. Phase is never inferred from transfer/process state.
+ */
+export type RuntimeAppInstallJobPhase = 'queued' | 'resolve_descriptor' | 'download' | 'verify' | 'materialize' | 'unpack' | 'evidence' | 'installed' | 'swap' | 'failed' | 'cancelled' | 'uninstalled';
+/** Terminal / in-flight job state. Mirrors `AppInstallJobState`. */
+export type RuntimeAppInstallJobState = 'queued' | 'in_progress' | 'installed' | 'failed' | 'cancelled' | 'uninstalled';
+/** Lifecycle operation that produced a job. Mirrors `AppLifecycleJobKind`. */
+export type RuntimeAppLifecycleJobKind = 'install' | 'update' | 'repair' | 'uninstall';
+/** Install artifact source. Mirrors `AppInstallSourceKind`. */
+export type RuntimeAppInstallSourceKind = 'bundled' | 'external_artifact';
+/** Health/repair action token. Mirrors `AppHealthRepairAction` (S-APP-002). */
+export type RuntimeAppHealthRepairAction = 'cancel' | 'retry' | 'repair' | 'reinstall';
+/** Runtime-owned absolute app storage roots (P-NAPP-015 / S-APP-011). */
+export type RuntimeAppInstallStorage = {
+    appRoot: string;
+    releaseRoot: string;
+    durableDataRoot: string;
+    cacheRoot: string;
+    tempRoot: string;
+};
+/**
+ * Typed lifecycle job projection. Covers install / update / repair jobs;
+ * `kind` distinguishes the operation so it is never inferred from `phase`.
+ * On a `failed` / `cancelled` job, `reasonCode` / `failureDetail` /
+ * `retryable` carry the fail-closed recovery contract.
+ */
+export type RuntimeAppInstallJob = {
+    jobId: string;
+    appId: string;
+    kind: RuntimeAppLifecycleJobKind;
+    releaseDescriptorRef: string;
+    installedVersion: string;
+    /** Active release version before an update/repair job ran. Empty for install. */
+    previousVersion?: string;
+    state: RuntimeAppInstallJobState;
+    phase: RuntimeAppInstallJobPhase;
+    sourceKind: RuntimeAppInstallSourceKind;
+    /** sha256 over the artifact bytes. Present only after the verify phase. */
+    sha256?: string;
+    artifactBytes: number;
+    storage: RuntimeAppInstallStorage;
+    /** Typed fail-closed reason on a failed/cancelled job. */
+    reasonCode?: string;
+    failureDetail?: string;
+    retryable: boolean;
+    createdAt?: string;
+    updatedAt?: string;
+};
+/** One typed progress frame from the WatchAppInstallJobEvents stream. */
+export type RuntimeAppInstallJobEvent = {
+    sequence: number;
+    job: RuntimeAppInstallJob;
+    timestamp?: string;
+};
+/** Typed uninstall projection. */
+export type RuntimeAppUninstallResult = {
+    appId: string;
+    releaseRemoved: boolean;
+    durableDataRemoved: boolean;
+    storage: RuntimeAppInstallStorage;
+    reasonCode?: string;
+    /**
+     * The watchable uninstall lifecycle job (kind=`uninstall`). It is the
+     * single live-job truth source for the `uninstalling` card state and can be
+     * followed via `watchJobEvents`.
+     */
+    job: RuntimeAppInstallJob;
+};
+/**
+ * Explicit canonical app-launch AIConfig scope (`P-AISC-007`). It is the
+ * app-shape `AIScopeRef`: `kind` is always `app`; `ownerId` is the admitted
+ * Nimi App id being opened; `surfaceId` is set only when the app's manifest
+ * declares a stable AI feature surface. `open` requires this scope and never
+ * infers it (`S-APP-003` / `K-APP-017`).
+ */
+export type RuntimeAppOpenScopeRef = {
+    kind: 'app';
+    ownerId: string;
+    surfaceId?: string;
+};
+/** Typed Open-flow step. Mirrors `AppOpenFlowStep` (K-APP-017). */
+export type RuntimeAppOpenFlowStep = 'resolve_registry' | 'verify_package' | 'verify_library' | 'verify_app_data' | 'verify_permissions' | 'ensure_aiconfig' | 'validate_manifest' | 'launch';
+/** Terminal Open-flow state. Mirrors `AppOpenState`. */
+export type RuntimeAppOpenState = 'launched' | 'blocked';
+/**
+ * Typed Open-flow projection. On a `blocked` open, `reasonCode` carries the
+ * distinct fail-closed reason and `reachedStep` names the exact step that
+ * blocked — it is never collapsed and never projected as launched.
+ */
+export type RuntimeAppOpenProjection = {
+    appId: string;
+    state: RuntimeAppOpenState;
+    reachedStep: RuntimeAppOpenFlowStep;
+    launched: boolean;
+    /** Active release version the launch resolved. Empty when blocked early. */
+    activeVersion?: string;
+    /** The resolved app-launch AIConfig scope. */
+    scope?: RuntimeAppOpenScopeRef;
+    /** Typed reason on a blocked open; `ACTION_EXECUTED` on a launched open. */
+    reasonCode?: string;
+    detail?: string;
+};
+export type RuntimeAppInstallInput = {
+    /** Admitted Nimi App registry id. */
+    appId: string;
+    /**
+     * Records that the user confirmed the install requirement preview
+     * (size, data roots, AI/profile requirements, permissions).
+     */
+    confirmed: boolean;
+};
+export type RuntimeAppUninstallInput = {
+    appId: string;
+    /**
+     * When true, additionally removes the durable app data root. Requires
+     * `destructiveDataDeleteConfirmed`.
+     */
+    deleteDurableData?: boolean;
+    /**
+     * Explicit user confirmation of the separate destructive
+     * "Delete app data" flow with impact preview.
+     */
+    destructiveDataDeleteConfirmed?: boolean;
+};
+export type RuntimeAppUpdateInput = {
+    appId: string;
+    /**
+     * Records that the user confirmed the update impact preview. Required for
+     * a required (breaking) update; ignored for a non-breaking update.
+     */
+    confirmed: boolean;
+};
+export type RuntimeAppHealthRepairInput = {
+    appId: string;
+    /** Typed repair action. Only the four S-APP-002 tokens are accepted. */
+    action: RuntimeAppHealthRepairAction;
+    /**
+     * Optionally targets a specific lifecycle job for cancel/retry. When
+     * omitted, cancel/retry resolve the most recent recoverable job.
+     */
+    jobId?: string;
+};
+export type RuntimeAppOpenInput = {
+    /** Admitted Nimi App registry id to open. */
+    appId: string;
+    /**
+     * Mandatory explicit app-launch AIConfig scope (`S-APP-003` / `K-APP-017`).
+     * `open` never infers the launch scope.
+     */
+    scope: RuntimeAppOpenScopeRef;
+};
+export type RuntimeAppLifecycleModule = {
+    /**
+     * Trigger the Runtime-owned install lifecycle for an admitted app.
+     * Returns the initial typed `AppInstallJob` projection.
+     */
+    install(input: RuntimeAppInstallInput, options?: RuntimeCallOptions): Promise<RuntimeAppInstallJob>;
+    /** Uninstall an app's release payload (durable data kept unless confirmed). */
+    uninstall(input: RuntimeAppUninstallInput, options?: RuntimeCallOptions): Promise<RuntimeAppUninstallResult>;
+    /** Read a single lifecycle job's typed projection by id. */
+    getJob(input: {
+        jobId: string;
+    }, options?: RuntimeCallOptions): Promise<RuntimeAppInstallJob>;
+    /** List lifecycle job projections, optionally filtered to a single app. */
+    listJobs(input?: {
+        appId?: string;
+    }, options?: RuntimeCallOptions): Promise<RuntimeAppInstallJob[]>;
+    /**
+     * Subscribe to the typed progress stream. Each frame carries a monotonic
+     * sequence and the full job snapshot at that moment.
+     */
+    watchJobEvents(input?: {
+        jobId?: string;
+    }, options?: RuntimeStreamCallOptions): Promise<AsyncIterable<RuntimeAppInstallJobEvent>>;
+    /**
+     * Trigger the Runtime-owned atomic update lifecycle. Returns the typed
+     * update job projection (kind=`update`).
+     */
+    update(input: RuntimeAppUpdateInput, options?: RuntimeCallOptions): Promise<RuntimeAppInstallJob>;
+    /**
+     * Trigger the Runtime-owned health/repair lifecycle. `cancel` returns the
+     * cancelled job; `retry`/`repair`/`reinstall` return the new in-flight job.
+     */
+    healthRepair(input: RuntimeAppHealthRepairInput, options?: RuntimeCallOptions): Promise<RuntimeAppInstallJob>;
+    /**
+     * Open (launch) an admitted Nimi App through the Runtime Open flow
+     * (`K-APP-017`). It requires an explicit app-launch `AIScopeRef` and never
+     * infers launch scope. Returns the typed Open projection: a `blocked` open
+     * carries the distinct fail-closed `reasonCode` and the step that blocked;
+     * it is never projected as launched.
+     */
+    open(input: RuntimeAppOpenInput, options?: RuntimeCallOptions): Promise<RuntimeAppOpenProjection>;
+};
+//# sourceMappingURL=runtime-app-lifecycle-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-app-lifecycle-types.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-app-lifecycle-types.ts"],"names":[],"mappings":"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"}

package/dist/runtime/runtime-app-lifecycle-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=runtime-app-lifecycle-types.js.map

package/dist/runtime/runtime-app-lifecycle-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-app-lifecycle-types.js","sourceRoot":"","sources":["../../src/runtime/runtime-app-lifecycle-types.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,13 @@
+import type { RuntimeInternalContext } from './internal-context.js';
+export type { RuntimeAppHealthRepairAction, RuntimeAppHealthRepairInput, RuntimeAppInstallInput, RuntimeAppInstallJob, RuntimeAppInstallJobEvent, RuntimeAppInstallJobPhase, RuntimeAppInstallJobState, RuntimeAppInstallSourceKind, RuntimeAppInstallStorage, RuntimeAppLifecycleJobKind, RuntimeAppLifecycleModule, RuntimeAppOpenInput, RuntimeAppOpenFlowStep, RuntimeAppOpenProjection, RuntimeAppOpenScopeRef, RuntimeAppOpenState, RuntimeAppUninstallInput, RuntimeAppUninstallResult, RuntimeAppUpdateInput, } from './runtime-app-lifecycle-types.js';
+import type { RuntimeAppLifecycleModule } from './runtime-app-lifecycle-types.js';
+export { decodeAppInstallJob } from './runtime-app-lifecycle-decode.js';
+/**
+ * Construct the RuntimeAppLifecycleModule from the Runtime internal context.
+ * Called from the Runtime constructor (Runtime class `readonly appLifecycle`
+ * field, never a singleton const export).
+ */
+export declare function createRuntimeAppLifecycleModule(input: {
+    ctx: RuntimeInternalContext;
+}): RuntimeAppLifecycleModule;
+//# sourceMappingURL=runtime-app-lifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"runtime-app-lifecycle.d.ts","sourceRoot":"","sources":["../../src/runtime/runtime-app-lifecycle.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAEpE,YAAY,EACV,4BAA4B,EAC5B,2BAA2B,EAC3B,sBAAsB,EACtB,oBAAoB,EACpB,yBAAyB,EACzB,yBAAyB,EACzB,yBAAyB,EACzB,2BAA2B,EAC3B,wBAAwB,EACxB,0BAA0B,EAC1B,yBAAyB,EACzB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,sBAAsB,EACtB,mBAAmB,EACnB,wBAAwB,EACxB,yBAAyB,EACzB,qBAAqB,GACtB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,KAAK,EAGV,yBAAyB,EAE1B,MAAM,kCAAkC,CAAC;AA4F1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAIxE;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE;IACrD,GAAG,EAAE,sBAAsB,CAAC;CAC7B,GAAG,yBAAyB,CAuF5B"}