@xplane/core 1.0.1 → 1.2.0

package/dist/index.d.mts

@@ -31,12 +31,24 @@ interface CompositionInput {
 interface CompositionResult {
   /** Resources to emit to Crossplane as desired composed resources. */
   resources: DesiredResource[];
+  /**
+   * Resources that are blocked (pending resolution). The handler uses these
+   * to preserve any previously-observed documents in desired state (preventing
+   * accidental deletion), to prevent premature XR readiness, and to populate
+   * `status.xplane.blockedResources` on the XR.
+   */
+  blockedResources: BlockedResource[];
   /** External resources that need to be fetched via requireResource. */
   externalResources: ExternalResourceRequest[];
   /** Desired XR status patches (from this.xr.status assignments). */
   xrStatus: Record<string, unknown>;
   /** Diagnostic reports for blocked/unresolved resources. */
   diagnostics: Diagnostic[];
+  /**
+   * When `true`, the runtime should inject a structured `status.xplane`
+   * payload on the XR. Controlled by `Composition.emitXplaneStatus`.
+   */
+  emitXplaneStatus: boolean;
 }
 /** A desired composed resource ready for emission. */
 interface DesiredResource {
@@ -46,6 +58,12 @@ interface DesiredResource {
   document: Record<string, unknown>;
   /** Whether this resource is ready (readiness already evaluated). */
   ready: boolean;
+  /**
+   * True when this resource is blocked (pending dependencies) and is being emitted
+   * as its previously-observed state to prevent Crossplane from deleting it.
+   * The handler must mark it as READY_FALSE and must not evaluate readiness.
+   */
+  preserved?: boolean;
 }
 /** A request to fetch an external (existing) resource. */
 interface ExternalResourceRequest {
@@ -58,6 +76,22 @@ interface ExternalResourceRequest {
   /** Optional namespace. */
   namespace?: string;
 }
+/**
+ * A blocked composed resource. Surfaced on the XR as
+ * `status.xplane.blockedResources` for visibility.
+ */
+interface BlockedResource {
+  /** Construct path name (also used as the Crossplane composed resource name). */
+  name: string;
+  /** The desired resource's apiVersion. */
+  apiVersion: string;
+  /** The desired resource's kind. */
+  kind: string;
+  /** The desired resource's metadata.name (if resolved). */
+  resourceName?: string;
+  /** Human-readable list of things this resource is waiting for. */
+  waitingFor?: string[];
+}
 /** A diagnostic report for a blocked resource. */
 interface Diagnostic {
   /** The resource name (construct path). */
@@ -126,6 +160,37 @@ interface ReadProxyMeta {
   readonly owner: ResourceRef;
   readonly path: string;
 }
+/**
+ * A Pending-like marker for strings produced by template literals that
+ * interpolate one or more unresolved ReadProxy values.
+ *
+ * Holds the template structure so the resolve phase can reconstruct the
+ * final string once all dependency slots are available.
+ *
+ * Invariant: parts.length === slots.length + 1
+ *   result = parts[0] + resolved[0] + parts[1] + … + resolved[n-1] + parts[n]
+ */
+declare const PENDING_TEMPLATE_TAG: unique symbol;
+declare class PendingTemplate {
+  /** Literal text segments between (and around) pending slots. */
+  readonly parts: readonly string[];
+  /** The pending slots — each maps to an entry in a resource's observed state. */
+  readonly slots: ReadonlyArray<{
+    source: ResourceRef;
+    path: string;
+  }>;
+  static readonly TAG: symbol;
+  readonly [PENDING_TEMPLATE_TAG] = true;
+  constructor(/** Literal text segments between (and around) pending slots. */
+
+  parts: readonly string[], /** The pending slots — each maps to an entry in a resource's observed state. */
+
+  slots: ReadonlyArray<{
+    source: ResourceRef;
+    path: string;
+  }>);
+  static is(value: unknown): value is PendingTemplate;
+}
 //#endregion
 //#region src/tracking/dependency-graph.d.ts
 /**
@@ -181,6 +246,19 @@ declare function createReadProxy<T extends object>(target: T, owner: ResourceRef
  */
 declare function createPrimitiveReadProxy(value: string | number | boolean, owner: ResourceRef, path: string): object;
 //#endregion
+//#region src/tracking/token-registry.d.ts
+interface TokenRegistry {
+  readonly byToken: Map<string, ReadProxyMeta>;
+  readonly byKey: Map<string, string>;
+  counter: number;
+}
+/**
+ * Per-run AsyncLocalStorage for the template-literal token registry.
+ * Kept separate from compositionStorage (core/) to avoid circular deps.
+ */
+declare const tokenRegistryStorage: AsyncLocalStorage<TokenRegistry>;
+declare function createTokenRegistry(): TokenRegistry;
+//#endregion
 //#region src/tracking/write-proxy.d.ts
 /**
  * Collector that accumulates dependency edges discovered during
@@ -253,6 +331,30 @@ declare class Composition<TSpec = Record<string, unknown>, TStatus = Record<stri
   readonly graph: DependencyGraph;
   /** The edge collector accumulating dependency edges. */
   readonly collector: EdgeCollector;
+  /**
+   * When `true`, the runtime injects a structured `status.xplane` payload on
+   * the XR containing `emittedResources` and `blockedResources`. Defaults to
+   * `false` because writing this field requires the XRD's `openAPIV3Schema`
+   * to declare `status.xplane` (or `status` to allow unknown fields) — typed
+   * patches will otherwise be rejected by Crossplane.
+   *
+   * To enable, set in your composition's constructor:
+   *
+   * ```ts
+   * this.emitXplaneStatus = true;
+   * ```
+   *
+   * and add the following to your XRD's status schema:
+   *
+   * ```yaml
+   * status:
+   *   properties:
+   *     xplane:
+   *       type: object
+   *       x-kubernetes-preserve-unknown-fields: true
+   * ```
+   */
+  emitXplaneStatus: boolean;
   constructor();
   /**
    * Read-only accessor for Crossplane function pipeline context.
@@ -285,6 +387,8 @@ interface CompositionContext {
   pipelineContext: ReadonlyMap<string, unknown>;
   /** Pre-populated data for existing resources (from prior iterations). */
   requiredResources: ReadonlyMap<string, Record<string, unknown>>;
+  /** Pre-populated data for composed resources (from prior iterations), keyed by `Composition/{path}`. */
+  observedComposed: ReadonlyMap<string, Record<string, unknown>>;
   /** The dependency graph for this composition run. */
   graph: DependencyGraph;
   /** The edge collector for this composition run. */
@@ -434,6 +538,15 @@ declare class Resource extends Construct$1 {
     allowedPattern?: RegExp;
     extra?: string;
   }): string;
+  /**
+   * Like {@link uniqueName} but produces names compliant with RFC 1123 DNS labels:
+   * lowercase alphanumeric characters and hyphens only, starting and ending with
+   * an alphanumeric character. Suitable for use as Kubernetes resource names.
+   */
+  static uniqueNameRfc1123(scope: Construct$1, options?: {
+    maxLength?: number;
+    extra?: string;
+  }): string;
 }
 declare function getResourceInternals(resource: Resource): ResourceInternals;
 declare function getResourceRef(resource: Resource): ResourceRef;
@@ -512,6 +625,12 @@ interface EmittedResource {
   autoReady: boolean;
   /** Custom readiness checks registered by the composition author. */
   readyChecks: ReadyCheck[];
+  /**
+   * True when this resource is blocked (pending dependencies) but has previously-observed
+   * state that is being emitted as-is to prevent Crossplane from deleting it.
+   * The handler must mark it as READY_FALSE.
+   */
+  preserved?: boolean;
 }
 //#endregion
 //#region src/pipeline/diagnose.d.ts
@@ -533,6 +652,10 @@ declare function diagnose(state: PipelineState): PipelineState;
  * Kubernetes resource document ready for Crossplane.
  *
  * Also extracts the XR desired status from this.xr.status assignments.
+ *
+ * For resources classified as 'blocked' that have previously-observed state,
+ * emits the observed document as-is (marked `preserved: true`) so that
+ * Crossplane does not delete them while their dependencies are still resolving.
  */
 declare function emit(state: PipelineState): PipelineState;
 //#endregion
@@ -604,5 +727,5 @@ declare function runPipeline(input: PipelineInput): PipelineState;
  */
 declare function runComposition<TSpec, TStatus, TContext extends object>(CompositionClass: new () => Composition<TSpec, TStatus, TContext>, input: CompositionInput): CompositionResult;
 //#endregion
-export { Composition, type CompositionContext, type CompositionInput, type CompositionModule, type CompositionResult, Construct, DEFAULT_CHECKS, type DependencyEdge, DependencyGraph, type DesiredResource, type Diagnostic, type DiagnosticReport, EdgeCollector, type EmittedResource, type ExternalResourceRef, type ExternalResourceRequest, type KubernetesResource, Pending, type PipelineContextAccessor, type PipelineInput, type PipelineState, type ReadProxyMeta, type ReadyCheck, type ReadyCheckFn, Resource, type ResourceClassification, type ResourceConfig, type ResourceProps, type ResourceRef, type XplaneLogger, type XrProxy, compositionStorage, createPrimitiveReadProxy, createReadProxy, createWriteProxy, diagnose, emit, evaluateReadiness, getCompositionContext, getDesiredDocument, getExternalRef, getLogger, getObservedDocument, getReadProxyMeta, getReadyChecks, getResourceInternals, getResourceRef, getXrDesiredStatus, hydrate, hydrateObserved, isExternal, isReadProxy, resolve, runComposition, runPipeline, sequence, withLogger };
+export { type BlockedResource, Composition, type CompositionContext, type CompositionInput, type CompositionModule, type CompositionResult, Construct, DEFAULT_CHECKS, type DependencyEdge, DependencyGraph, type DesiredResource, type Diagnostic, type DiagnosticReport, EdgeCollector, type EmittedResource, type ExternalResourceRef, type ExternalResourceRequest, type KubernetesResource, Pending, PendingTemplate, type PipelineContextAccessor, type PipelineInput, type PipelineState, type ReadProxyMeta, type ReadyCheck, type ReadyCheckFn, Resource, type ResourceClassification, type ResourceConfig, type ResourceProps, type ResourceRef, type XplaneLogger, type XrProxy, compositionStorage, createPrimitiveReadProxy, createReadProxy, createTokenRegistry, createWriteProxy, diagnose, emit, evaluateReadiness, getCompositionContext, getDesiredDocument, getExternalRef, getLogger, getObservedDocument, getReadProxyMeta, getReadyChecks, getResourceInternals, getResourceRef, getXrDesiredStatus, hydrate, hydrateObserved, isExternal, isReadProxy, resolve, runComposition, runPipeline, sequence, tokenRegistryStorage, withLogger };
 //# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","names":[],"sources":["../src/contract.ts","../src/tracking/types.ts","../src/tracking/dependency-graph.ts","../src/tracking/read-proxy.ts","../src/tracking/write-proxy.ts","../src/core/composition.ts","../src/core/context.ts","../src/readiness/types.ts","../src/readiness/defaults.ts","../src/readiness/evaluate.ts","../src/core/resource.ts","../src/logging/types.ts","../src/logging/context.ts","../src/pipeline/types.ts","../src/pipeline/diagnose.ts","../src/pipeline/emit.ts","../src/pipeline/hydrate.ts","../src/pipeline/resolve.ts","../src/pipeline/sequence.ts","../src/pipeline/index.ts","../src/run.ts"],"mappings":"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"}
+{"version":3,"file":"index.d.mts","names":[],"sources":["../src/contract.ts","../src/tracking/types.ts","../src/tracking/dependency-graph.ts","../src/tracking/read-proxy.ts","../src/tracking/token-registry.ts","../src/tracking/write-proxy.ts","../src/core/composition.ts","../src/core/context.ts","../src/readiness/types.ts","../src/readiness/defaults.ts","../src/readiness/evaluate.ts","../src/core/resource.ts","../src/logging/types.ts","../src/logging/context.ts","../src/pipeline/types.ts","../src/pipeline/diagnose.ts","../src/pipeline/emit.ts","../src/pipeline/hydrate.ts","../src/pipeline/resolve.ts","../src/pipeline/sequence.ts","../src/pipeline/index.ts","../src/run.ts"],"mappings":"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"}