@supacloud/compiler 0.27.4 → 0.28.0

package/dist/delivery-context.d.ts

@@ -1,4 +1,5 @@
 import { type ExecutionContextPack } from "./execution-context";
+import { type ApplicationDevelopmentContext } from "./application-development";
 export declare class DeliveryContextError extends Error {
     readonly code: "DELIVERY_CONTEXT_INVALID" | "DELIVERY_CONTEXT_IDENTITY_MISMATCH" | "DELIVERY_CONTEXT_INTEGRITY_FAILED";
     constructor(code: "DELIVERY_CONTEXT_INVALID" | "DELIVERY_CONTEXT_IDENTITY_MISMATCH" | "DELIVERY_CONTEXT_INTEGRITY_FAILED");
@@ -11,5 +12,20 @@ export interface DeliveryExecutionContextPack extends Omit<ExecutionContextPack,
         artifactVerified: true;
     };
 }
+export interface DeliveredApplicationDevelopmentContext {
+    correlation: "verified-build-snapshot";
+    delivery: {
+        target: string;
+        objectId: string;
+        artifactVerified: true;
+    };
+    context: ApplicationDevelopmentContext;
+}
+/**
+ * Read the application development contract from an immutable delivered object.
+ * Local artifact integrity only: this does not attest deployment, runtime state
+ * or account identity. It never falls back to the current source checkout.
+ */
+export declare function readApplicationDevelopmentContext(manifestPath: string, target: string): Promise<DeliveredApplicationDevelopmentContext>;
 /** Local artifact integrity only. Caller-supplied events do not attest execution or deployment. */
 export declare function createDeliveryExecutionContextPack(manifestPath: string, target: string, subject: string, observations: unknown, requestId: string): Promise<DeliveryExecutionContextPack>;

package/dist/delivery-render.d.ts

@@ -4,6 +4,7 @@ import { type GenerateOptions } from "./generate";
 /** Keep conservative service factories while restricting exposed route/job descriptors. */
 export declare function renderDeliveryTarget(graph: ApplicationGraph, target: DeliveryTarget, options: GenerateOptions): {
     executionSnapshot: string;
+    applicationDevelopment: string;
     applicationCode: string;
     manifestJson: string;
     contractsManifestJson: string;

package/dist/environment-bindings-file.d.ts

@@ -0,0 +1,3 @@
+import { type EnvironmentBindingsDocument } from "./environment-bindings";
+/** Bound actual bytes before decoding/parsing, including files growing during a read. */
+export declare function readEnvironmentBindingsFile(file: string): Promise<EnvironmentBindingsDocument>;

package/dist/environment-bindings.d.ts

@@ -0,0 +1,78 @@
+import type { ApplicationGraph, InfraResourceKind } from "./types";
+/** Static binding references only; this never proves runtime availability or permissions. */
+export declare const ENVIRONMENT_BINDINGS_SCHEMA = "supacloud.environments.v1";
+export declare const ENVIRONMENT_BINDINGS_PROJECTION_SCHEMA = "supacloud.environment-bindings.v1";
+export declare const ENVIRONMENT_BINDING_REFERENCE_PATTERN = "^(?:local|[a-z][a-z0-9-]{0,15}:[A-Za-z0-9][A-Za-z0-9_.-]{0,63})$";
+export declare const ENVIRONMENT_BINDINGS_LIMITS: {
+    readonly environments: number;
+    readonly bindings: number;
+    readonly resources: number;
+    readonly outputBytes: number;
+};
+export type EnvironmentBindingErrorCode = "ENVIRONMENT_BINDINGS_INVALID" | "ENVIRONMENT_BINDINGS_TOO_LARGE" | "ENVIRONMENT_BINDINGS_UNKNOWN_ENVIRONMENT" | "ENVIRONMENT_BINDINGS_PRODUCTION_FORBIDDEN";
+export declare class EnvironmentBindingError extends Error {
+    readonly code: EnvironmentBindingErrorCode;
+    constructor(code: EnvironmentBindingErrorCode);
+}
+export type EnvironmentBindingDiagnosticCode = "missing-environment-binding" | "unknown-environment-binding" | "invalid-environment-binding";
+export interface EnvironmentBindingDiagnostic {
+    code: EnvironmentBindingDiagnosticCode;
+    severity: "error";
+    environment: string;
+    resource?: string;
+    message: string;
+}
+export interface EnvironmentBindingsDocument {
+    schema: typeof ENVIRONMENT_BINDINGS_SCHEMA;
+    environments: Record<string, {
+        bindings: Record<string, string>;
+    }>;
+}
+export interface EnvironmentBindingEntry {
+    resource: string;
+    kind: InfraResourceKind;
+    binding: string;
+}
+export interface EnvironmentBindingsProjection {
+    schema: typeof ENVIRONMENT_BINDINGS_PROJECTION_SCHEMA;
+    environment: string;
+    bindings: EnvironmentBindingEntry[];
+    omitted: {
+        resources: number;
+    };
+    limits: typeof ENVIRONMENT_BINDINGS_LIMITS;
+}
+export interface EnvironmentBindingsResult {
+    projection: EnvironmentBindingsProjection;
+    diagnostics: EnvironmentBindingDiagnostic[];
+}
+/** Parse a detached document, retaining invalid references for safe resolution diagnostics. */
+export declare function parseEnvironmentBindings(value: unknown): EnvironmentBindingsDocument;
+export declare function formatEnvironmentBindings(result: EnvironmentBindingsResult): string;
+/** Resolve only own binding properties and reject invalid references without echoing them. */
+export declare function resolveEnvironmentBindings(graph: ApplicationGraph, document: EnvironmentBindingsDocument, environment: string): EnvironmentBindingsResult;
+/** Classification only. A name check is not proof of environment identity or isolation. */
+export declare const RUNTIME_BINDINGS_SCHEMA = "supacloud.runtime-bindings.v1";
+export type RuntimeBindingProfile = "fast" | "integration";
+export type RuntimeBindingMode = "ephemeral" | "external";
+export interface RuntimeBindingEntry extends EnvironmentBindingEntry {
+    mode: RuntimeBindingMode;
+}
+export interface RuntimeBindingsProjection {
+    schema: typeof RUNTIME_BINDINGS_SCHEMA;
+    profile: RuntimeBindingProfile;
+    environment: string;
+    credentials: "resolved-by-local-runner";
+    bindings: RuntimeBindingEntry[];
+    omitted: {
+        resources: number;
+    };
+    limits: typeof ENVIRONMENT_BINDINGS_LIMITS;
+}
+export interface RuntimeBindingsResult {
+    projection: RuntimeBindingsProjection;
+    diagnostics: EnvironmentBindingDiagnostic[];
+}
+export declare function formatRuntimeBindings(result: RuntimeBindingsResult): string;
+/** Validate the full declaration set before applying any display limit. */
+export declare function resolveRuntimeBindings(graph: ApplicationGraph, document: EnvironmentBindingsDocument, environment: string, profile: RuntimeBindingProfile): RuntimeBindingsResult;

package/dist/execution-context.d.ts

@@ -10,6 +10,9 @@ export declare const EXECUTION_CONTEXT_LIMITS: {
     readonly files: number;
     readonly diagnostics: number;
     readonly plans: number;
+    readonly timeline: number;
+    readonly timelineAttempts: number;
+    readonly timelineStages: number;
 };
 interface ExecutionMetadata {
     kind: "route" | "command" | "job";
@@ -18,6 +21,39 @@ interface ExecutionMetadata {
     phase: "started" | "succeeded" | "failed";
     requestId?: string;
     durationMs?: number;
+    /** 1-based execution attempt; omitted means the first. Distinguishes retries without inventing a counter. */
+    attempt?: number;
+    /** Opaque correlation ID (for example a W3C trace ID) shared across a business operation and its tasks. */
+    traceId?: string;
+}
+export interface ExecutionTimelineStage {
+    stage: string;
+    phase: "started" | "succeeded" | "failed";
+    durationMs?: number;
+    index: number;
+}
+export interface ExecutionTimelineAttempt {
+    attempt: number;
+    stages: ExecutionTimelineStage[];
+    failed: boolean;
+    /** The last declared stage succeeded in the matched input, before display caps. Not business success. */
+    complete: boolean;
+    /** Declared stages with no observation in this attempt. Absence is not proof a stage was skipped. */
+    missingStages: string[];
+    /** Observed stages not present in the current static plan. */
+    unexpectedStages: string[];
+    traceIds: string[];
+    /** Matched stage observations excluded from this attempt's displayed details. */
+    omittedStages: number;
+}
+export interface ExecutionTimelineEntry {
+    kind: "route" | "command" | "job";
+    operation: string;
+    module: string;
+    declaredStages: string[];
+    attempts: ExecutionTimelineAttempt[];
+    /** Attempts excluded from this entry by the display cap. */
+    omittedAttempts: number;
 }
 export declare class ExecutionContextError extends Error {
     readonly code: "EXECUTION_METADATA_INVALID" | "EXECUTION_METADATA_UNREADABLE" | "EXECUTION_CONTEXT_NOT_FOUND" | "EXECUTION_CONTEXT_TOO_LARGE";
@@ -57,7 +93,10 @@ export interface ExecutionContextPack {
         diagnostics: number;
         plans: number;
         unmatchedEvents: number;
+        timeline: number;
     };
+    /** Per-operation timeline summarized from all matched observations, independently of display caps. */
+    timeline: ExecutionTimelineEntry[];
     limits: typeof EXECUTION_CONTEXT_LIMITS;
 }
 /** Read only a bounded regular file; parse failures never echo file contents or paths. */

package/dist/fixtures/runtime-source.d.ts

@@ -3,5 +3,5 @@
  * AST analysis matches decorators by name only and generated code does not import it;
  * implementation exists only so fixture sources can be dynamically imported and executed by bun.
  */
-export declare const RUNTIME_SOURCE = "export class InjectionToken<T = unknown> {\n  readonly name: string;\n  readonly scope?: string;\n\n  constructor(name: string, options: { scope?: string } = {}) {\n    this.name = name;\n    this.scope = options.scope;\n  }\n}\n\nexport function Injectable(_options: { scope?: string; deps?: unknown[] } = {}) {\n  return () => {};\n}\n\nexport function Inject(_token: unknown) {\n  return () => {};\n}\n\nexport function Module(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function defineModule(_options: Record<string, unknown>) {\n  return class DefinedModule {};\n}\n\nexport function Command(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function Job(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function Query(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function Controller(_path: string) {\n  return () => {};\n}\n\nfunction routeDecorator(_method: string) {\n  return (_path: string, _options?: Record<string, unknown>) => () => {};\n}\n\nexport const Get = routeDecorator(\"GET\");\nexport const Post = routeDecorator(\"POST\");\nexport const Put = routeDecorator(\"PUT\");\nexport const Patch = routeDecorator(\"PATCH\");\nexport const Delete = routeDecorator(\"DELETE\");\nexport const Head = routeDecorator(\"HEAD\");\nexport const Options = routeDecorator(\"OPTIONS\");\n\nexport const REQUEST_CONTEXT = new InjectionToken(\"supacloud.request-context\", {\n  scope: \"request\",\n});\nexport const JOB_CONTEXT = new InjectionToken(\"supacloud.job-context\", {\n  scope: \"job\",\n});\n";
+export declare const RUNTIME_SOURCE = "export class InjectionToken<T = unknown> {\n  readonly name: string;\n  readonly scope?: string;\n\n  constructor(name: string, options: { scope?: string } = {}) {\n    this.name = name;\n    this.scope = options.scope;\n  }\n}\n\nexport function Injectable(_options: { scope?: string; deps?: unknown[] } = {}) {\n  return () => {};\n}\n\nexport function Inject(_token: unknown) {\n  return () => {};\n}\n\nexport function Module(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function defineModule(_options: Record<string, unknown>) {\n  return class DefinedModule {};\n}\n\nexport function Command(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function Job(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function Query(_options: Record<string, unknown>) {\n  return () => {};\n}\n\nexport function InfraResource(_options: { name: string; kind: string }) {\n  return () => {};\n}\n\nexport function Controller(_path: string) {\n  return () => {};\n}\n\nfunction routeDecorator(_method: string) {\n  return (_path: string, _options?: Record<string, unknown>) => () => {};\n}\n\nexport const Get = routeDecorator(\"GET\");\nexport const Post = routeDecorator(\"POST\");\nexport const Put = routeDecorator(\"PUT\");\nexport const Patch = routeDecorator(\"PATCH\");\nexport const Delete = routeDecorator(\"DELETE\");\nexport const Head = routeDecorator(\"HEAD\");\nexport const Options = routeDecorator(\"OPTIONS\");\n\nexport const REQUEST_CONTEXT = new InjectionToken(\"supacloud.request-context\", {\n  scope: \"request\",\n});\nexport const JOB_CONTEXT = new InjectionToken(\"supacloud.job-context\", {\n  scope: \"job\",\n});\n";
 export declare const FIXTURE_TSCONFIG = "{\n  \"compilerOptions\": {\n    \"target\": \"ES2022\",\n    \"module\": \"ESNext\",\n    \"moduleResolution\": \"bundler\",\n    \"experimentalDecorators\": true,\n    \"strict\": true\n  }\n}\n";

package/dist/index.d.ts

@@ -10,7 +10,15 @@ export type { DeliveryOptions, DeliveryPlan, DeliveryPlanResult, DeliveryTarget,
 export { generateFeatureSource, validateFeatureSpec } from "./feature";
 export { applyDiagnosticFix } from "./fixes";
 export { createExecutionContextPack, readExecutionMetadata, EXECUTION_CONTEXT_LIMITS, ExecutionContextError } from "./execution-context";
-export type { ExecutionContextPack } from "./execution-context";
+export type { ExecutionContextPack, ExecutionTimelineStage, ExecutionTimelineAttempt, ExecutionTimelineEntry } from "./execution-context";
+export { readApplicationDevelopmentContext, DeliveryContextError } from "./delivery-context";
+export type { DeliveredApplicationDevelopmentContext, DeliveryExecutionContextPack } from "./delivery-context";
+export { createApplicationDevelopmentContext, parseApplicationDevelopmentContext, formatApplicationDevelopmentContext, APPLICATION_DEVELOPMENT_LIMITS, APPLICATION_DEVELOPMENT_ARCHIVE_MAX_BYTES, APPLICATION_DEVELOPMENT_SCHEMA, ApplicationDevelopmentError, } from "./application-development";
+export type { ApplicationDevelopmentContext, ApplicationDevelopmentOptions, ApplicationDevelopmentModule, ApplicationDevelopmentRoute, ApplicationDevelopmentCommand, ApplicationDevelopmentJob, ApplicationDevelopmentResource, ApplicationDevelopmentResourceUse, ApplicationDevelopmentResourceUseEntry, ApplicationDevelopmentDiagnostic, DevelopmentSchemaKind, } from "./application-development";
+export { parseEnvironmentBindings, resolveEnvironmentBindings, resolveRuntimeBindings, formatEnvironmentBindings, formatRuntimeBindings, EnvironmentBindingError, ENVIRONMENT_BINDINGS_SCHEMA, ENVIRONMENT_BINDINGS_PROJECTION_SCHEMA, ENVIRONMENT_BINDING_REFERENCE_PATTERN, ENVIRONMENT_BINDINGS_LIMITS, RUNTIME_BINDINGS_SCHEMA, } from "./environment-bindings";
+export type { EnvironmentBindingsDocument, EnvironmentBindingsProjection, EnvironmentBindingsResult, EnvironmentBindingEntry, EnvironmentBindingDiagnostic, EnvironmentBindingDiagnosticCode, EnvironmentBindingErrorCode, RuntimeBindingProfile, RuntimeBindingMode, RuntimeBindingEntry, RuntimeBindingsProjection, RuntimeBindingsResult, } from "./environment-bindings";
+export { createReleaseEvidence, formatReleaseEvidence, RELEASE_EVIDENCE_SCHEMA, ReleaseEvidenceError, } from "./release-evidence";
+export type { ReleaseEvidence, ReleaseEvidenceErrorCode } from "./release-evidence";
 export type { AppliedDiagnosticFix, ApplyDiagnosticFixOptions } from "./fixes";
 export { createDiagnosticRepairPlan } from "./repair-plan";
 export type { DiagnosticRepair } from "./repair-plan";