@spottoai/types-package 1.0.2-dev1138.3 → 1.0.2-dev1138.5

package/dist/environment/contracts.d.ts

@@ -0,0 +1,196 @@
+/** Phase-one environment-memory contract constants shared by producers and consumers. */
+export declare const ENVIRONMENT_CONTRACT_LIMITS_V1: Readonly<{
+    readonly completedPointerBytes: number;
+    readonly projectionBytes: number;
+    readonly environmentIndexBytes: number;
+    readonly costPillarBytes: number;
+    readonly boundedListItems: 50;
+    readonly customerStringScalars: 4096;
+    readonly safeLabelScalars: 512;
+    readonly scopeIdentifierScalars: 2048;
+    readonly environmentRunIdAsciiCharacters: 128;
+    readonly sourceIdentityScalars: 256;
+    readonly logicalReferencePayloadBytes: number;
+    readonly validatedContainerDepth: 8;
+}>;
+export declare const ENVIRONMENT_DOCUMENT_NAMES_V1: readonly ["projection.json", "environment-index.md", "pillars/cost.md"];
+export declare const ENVIRONMENT_ARTIFACT_KINDS_V1: readonly ["subscription-summary", "subscription-resources", "subscription-recommendations"];
+export type EnvironmentDocumentNameV1 = (typeof ENVIRONMENT_DOCUMENT_NAMES_V1)[number];
+export type EnvironmentArtifactKindV1 = (typeof ENVIRONMENT_ARTIFACT_KINDS_V1)[number];
+export type EnvironmentMoneyBasisV1 = 'billed' | 'amortized';
+export type EnvironmentSavingsAdditivityV1 = 'additive' | 'scenario-non-additive';
+export type EnvironmentMoneyProvenanceV1 = 'subscription-summary' | 'subscription-resources' | 'cost-savings-summary' | 'savings-aggregate' | 'recommendation';
+export interface EnvironmentScopeV1 {
+    kind: 'azure-subscription';
+    tenantId: string;
+    companyId: string;
+    subscriptionId: string;
+}
+export interface EnvironmentSourceGenerationV1 {
+    viewSetSchemaVersion: 1;
+    publicationId: string;
+    portalRunId: string;
+    pluginRunId: string;
+    economicsGenerationId: string;
+    economicsFingerprint: string;
+    completedAt: string;
+}
+export interface EnvironmentSourceBindingV1 extends EnvironmentSourceGenerationV1 {
+    kind: 'azure-subscription-view-set';
+    scope: EnvironmentScopeV1;
+}
+export type EnvironmentLogicalArtifactReferenceV1 = `spotto://artifact/v1/${EnvironmentArtifactKindV1}/${string}`;
+export type EnvironmentLogicalResourceReferenceV1 = `spotto://resource/v1/${string}`;
+export type EnvironmentLogicalEvidenceReferenceV1 = EnvironmentLogicalArtifactReferenceV1 | EnvironmentLogicalResourceReferenceV1;
+export interface ParsedEnvironmentLogicalArtifactReferenceV1 {
+    kind: 'artifact';
+    artifactKind: EnvironmentArtifactKindV1;
+    subject: string;
+}
+export interface ParsedEnvironmentLogicalResourceReferenceV1 {
+    kind: 'resource';
+    resourceId: string;
+}
+export type ParsedEnvironmentLogicalEvidenceReferenceV1 = ParsedEnvironmentLogicalArtifactReferenceV1 | ParsedEnvironmentLogicalResourceReferenceV1;
+export interface EnvironmentMoneyValueV1 {
+    amount: string;
+    currencyCode: string;
+    basis: EnvironmentMoneyBasisV1;
+    period: string;
+    provenance: EnvironmentMoneyProvenanceV1;
+    savingsAdditivity?: EnvironmentSavingsAdditivityV1;
+}
+interface EnvironmentCoverageBaseV1 {
+    observedAt?: string;
+    completeThrough?: string;
+}
+export interface EnvironmentCompleteCoverageStateV1 extends EnvironmentCoverageBaseV1 {
+    status: 'complete';
+    reason?: never;
+}
+export interface EnvironmentPartialCoverageStateV1 extends EnvironmentCoverageBaseV1 {
+    status: 'partial';
+    reason: string;
+}
+export interface EnvironmentUnavailableCoverageStateV1 {
+    status: 'unavailable';
+    reason: string;
+    observedAt?: never;
+    completeThrough?: never;
+}
+export interface EnvironmentStaleCoverageStateV1 extends EnvironmentCoverageBaseV1 {
+    status: 'stale';
+    reason: string;
+    observedAt: string;
+}
+export interface EnvironmentNotCollectedCoverageStateV1 {
+    status: 'not-collected';
+    reason: string;
+    observedAt?: never;
+    completeThrough?: never;
+}
+export type EnvironmentCoverageStateV1 = EnvironmentCompleteCoverageStateV1 | EnvironmentPartialCoverageStateV1 | EnvironmentUnavailableCoverageStateV1 | EnvironmentStaleCoverageStateV1 | EnvironmentNotCollectedCoverageStateV1;
+export interface EnvironmentBoundedListV1<T> {
+    items: T[];
+    totalCount: number;
+    includedCount: number;
+    truncated: boolean;
+    continuationReference?: EnvironmentLogicalEvidenceReferenceV1;
+}
+export interface EnvironmentSubscriptionSummaryV1 {
+    safeLabel: string;
+    portalRoute: string;
+}
+export interface EnvironmentSourceCoverageV1 {
+    subscriptionSummary: EnvironmentCoverageStateV1;
+    resources: EnvironmentCoverageStateV1;
+    recommendations: EnvironmentCoverageStateV1;
+    costs: EnvironmentCoverageStateV1;
+    savings: EnvironmentCoverageStateV1;
+}
+export interface EnvironmentCostSummaryV1 {
+    observedCost?: EnvironmentMoneyValueV1;
+    potentialSavings?: EnvironmentMoneyValueV1;
+    resourceCount?: number;
+    recommendationCount?: number;
+}
+export interface EnvironmentCostRollupV1 {
+    key: string;
+    safeLabel: string;
+    resourceCount: number;
+    observedCost?: EnvironmentMoneyValueV1;
+    potentialSavings?: EnvironmentMoneyValueV1;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentCostDriverV1 {
+    key: string;
+    safeLabel: string;
+    description?: string;
+    observedCost?: EnvironmentMoneyValueV1;
+    portalRoute?: string;
+    resourceReference?: EnvironmentLogicalResourceReferenceV1;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentCostRecommendationV1 {
+    recommendationId: string;
+    safeLabel: string;
+    description?: string;
+    potentialSavings?: EnvironmentMoneyValueV1;
+    portalRoute: string;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentCostChangeV1 {
+    key: string;
+    safeLabel: string;
+    description: string;
+    direction: 'increase' | 'decrease' | 'unchanged' | 'unknown';
+    amount?: EnvironmentMoneyValueV1;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentProjectionWarningV1 {
+    code: string;
+    safeLabel: string;
+    detail?: string;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentSubscriptionCostProjectionV1 {
+    schemaVersion: 1;
+    scope: EnvironmentScopeV1;
+    sourceBinding: EnvironmentSourceBindingV1;
+    generatedAt: string;
+    subscription: EnvironmentSubscriptionSummaryV1;
+    sourceCoverage: EnvironmentSourceCoverageV1;
+    costSummary: EnvironmentCostSummaryV1;
+    serviceFamilyRollups: EnvironmentBoundedListV1<EnvironmentCostRollupV1>;
+    estateCostRollups: EnvironmentBoundedListV1<EnvironmentCostRollupV1>;
+    costDrivers: EnvironmentBoundedListV1<EnvironmentCostDriverV1>;
+    recommendations: EnvironmentBoundedListV1<EnvironmentCostRecommendationV1>;
+    changes: EnvironmentBoundedListV1<EnvironmentCostChangeV1>;
+    warnings: EnvironmentBoundedListV1<EnvironmentProjectionWarningV1>;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export type EnvironmentDocumentDescriptorV1 = {
+    name: 'projection.json';
+    mediaType: 'application/json';
+    byteCount: number;
+    contentSha256: string;
+    approximateTokenCount: number;
+} | {
+    name: 'environment-index.md' | 'pillars/cost.md';
+    mediaType: 'text/markdown; charset=utf-8';
+    byteCount: number;
+    contentSha256: string;
+    approximateTokenCount: number;
+};
+export interface EnvironmentCompiledGenerationPointerV1 {
+    schemaVersion: 1;
+    status: 'completed';
+    environmentRunId: string;
+    scope: EnvironmentScopeV1;
+    sourceBinding: EnvironmentSourceBindingV1;
+    treeDigestSha256: string;
+    fileCount: 3;
+    generatedAt: string;
+}
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/environment/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../../src/environment/contracts.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;EAahC,CAAC;AAEZ,eAAO,MAAM,6BAA6B,yEAA0E,CAAC;AAErH,eAAO,MAAM,6BAA6B,6FAA8F,CAAC;AAEzI,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,yBAAyB,GAAG,CAAC,OAAO,6BAA6B,CAAC,CAAC,MAAM,CAAC,CAAC;AACvF,MAAM,MAAM,uBAAuB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC7D,MAAM,MAAM,8BAA8B,GAAG,UAAU,GAAG,uBAAuB,CAAC;AAClF,MAAM,MAAM,4BAA4B,GACpC,sBAAsB,GACtB,wBAAwB,GACxB,sBAAsB,GACtB,mBAAmB,GACnB,gBAAgB,CAAC;AAErB,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,6BAA6B;IAC5C,oBAAoB,EAAE,CAAC,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,qBAAqB,EAAE,MAAM,CAAC;IAC9B,oBAAoB,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,0BAA2B,SAAQ,6BAA6B;IAC/E,IAAI,EAAE,6BAA6B,CAAC;IACpC,KAAK,EAAE,kBAAkB,CAAC;CAC3B;AAED,MAAM,MAAM,qCAAqC,GAAG,wBAAwB,yBAAyB,IAAI,MAAM,EAAE,CAAC;AAClH,MAAM,MAAM,qCAAqC,GAAG,wBAAwB,MAAM,EAAE,CAAC;AACrF,MAAM,MAAM,qCAAqC,GAAG,qCAAqC,GAAG,qCAAqC,CAAC;AAElI,MAAM,WAAW,2CAA2C;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB,YAAY,EAAE,yBAAyB,CAAC;IACxC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,2CAA2C;IAC1D,IAAI,EAAE,UAAU,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,2CAA2C,GAAG,2CAA2C,GAAG,2CAA2C,CAAC;AAEpJ,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,uBAAuB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,4BAA4B,CAAC;IACzC,iBAAiB,CAAC,EAAE,8BAA8B,CAAC;CACpD;AAED,UAAU,yBAAyB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kCAAmC,SAAQ,yBAAyB;IACnF,MAAM,EAAE,UAAU,CAAC;IACnB,MAAM,CAAC,EAAE,KAAK,CAAC;CAChB;AAED,MAAM,WAAW,iCAAkC,SAAQ,yBAAyB;IAClF,MAAM,EAAE,SAAS,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,qCAAqC;IACpD,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB;AAED,MAAM,WAAW,+BAAgC,SAAQ,yBAAyB;IAChF,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sCAAsC;IACrD,MAAM,EAAE,eAAe,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;IACnB,eAAe,CAAC,EAAE,KAAK,CAAC;CACzB;AAED,MAAM,MAAM,0BAA0B,GAClC,kCAAkC,GAClC,iCAAiC,GACjC,qCAAqC,GACrC,+BAA+B,GAC/B,sCAAsC,CAAC;AAE3C,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,KAAK,EAAE,CAAC,EAAE,CAAC;IACX,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,qBAAqB,CAAC,EAAE,qCAAqC,CAAC;CAC/D;AAED,MAAM,WAAW,gCAAgC;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,2BAA2B;IAC1C,mBAAmB,EAAE,0BAA0B,CAAC;IAChD,SAAS,EAAE,0BAA0B,CAAC;IACtC,eAAe,EAAE,0BAA0B,CAAC;IAC5C,KAAK,EAAE,0BAA0B,CAAC;IAClC,OAAO,EAAE,0BAA0B,CAAC;CACrC;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,mBAAmB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,gBAAgB,EAAE,qCAAqC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,uBAAuB,CAAC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,qCAAqC,CAAC;IAC1D,gBAAgB,EAAE,qCAAqC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,+BAA+B;IAC9C,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,qCAAqC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,uBAAuB;IACtC,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,CAAC;IAC7D,MAAM,CAAC,EAAE,uBAAuB,CAAC;IACjC,gBAAgB,EAAE,qCAAqC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,EAAE,qCAAqC,EAAE,CAAC;CAC3D;AAED,MAAM,WAAW,uCAAuC;IACtD,aAAa,EAAE,CAAC,CAAC;IACjB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,EAAE,0BAA0B,CAAC;IAC1C,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,gCAAgC,CAAC;IAC/C,cAAc,EAAE,2BAA2B,CAAC;IAC5C,WAAW,EAAE,wBAAwB,CAAC;IACtC,oBAAoB,EAAE,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;IACxE,iBAAiB,EAAE,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;IACrE,WAAW,EAAE,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;IAC/D,eAAe,EAAE,wBAAwB,CAAC,+BAA+B,CAAC,CAAC;IAC3E,OAAO,EAAE,wBAAwB,CAAC,uBAAuB,CAAC,CAAC;IAC3D,QAAQ,EAAE,wBAAwB,CAAC,8BAA8B,CAAC,CAAC;IACnE,gBAAgB,EAAE,qCAAqC,EAAE,CAAC;CAC3D;AAED,MAAM,MAAM,+BAA+B,GACvC;IACE,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,kBAAkB,CAAC;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,GACD;IACE,IAAI,EAAE,sBAAsB,GAAG,iBAAiB,CAAC;IACjD,SAAS,EAAE,8BAA8B,CAAC;IAC1C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,CAAC;IACtB,qBAAqB,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEN,MAAM,WAAW,sCAAsC;IACrD,aAAa,EAAE,CAAC,CAAC;IACjB,MAAM,EAAE,WAAW,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,aAAa,EAAE,0BAA0B,CAAC;IAC1C,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,CAAC,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB"}

package/dist/environment/contracts.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENVIRONMENT_ARTIFACT_KINDS_V1 = exports.ENVIRONMENT_DOCUMENT_NAMES_V1 = exports.ENVIRONMENT_CONTRACT_LIMITS_V1 = void 0;
+/** Phase-one environment-memory contract constants shared by producers and consumers. */
+exports.ENVIRONMENT_CONTRACT_LIMITS_V1 = Object.freeze({
+    completedPointerBytes: 16 * 1024,
+    projectionBytes: 64 * 1024,
+    environmentIndexBytes: 4 * 1024,
+    costPillarBytes: 8 * 1024,
+    boundedListItems: 50,
+    customerStringScalars: 4096,
+    safeLabelScalars: 512,
+    scopeIdentifierScalars: 2048,
+    environmentRunIdAsciiCharacters: 128,
+    sourceIdentityScalars: 256,
+    logicalReferencePayloadBytes: 4 * 1024,
+    validatedContainerDepth: 8,
+});
+exports.ENVIRONMENT_DOCUMENT_NAMES_V1 = ['projection.json', 'environment-index.md', 'pillars/cost.md'];
+exports.ENVIRONMENT_ARTIFACT_KINDS_V1 = ['subscription-summary', 'subscription-resources', 'subscription-recommendations'];
+//# sourceMappingURL=contracts.js.map

package/dist/environment/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../../src/environment/contracts.ts"],"names":[],"mappings":";;;AAAA,yFAAyF;AAC5E,QAAA,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1D,qBAAqB,EAAE,EAAE,GAAG,IAAI;IAChC,eAAe,EAAE,EAAE,GAAG,IAAI;IAC1B,qBAAqB,EAAE,CAAC,GAAG,IAAI;IAC/B,eAAe,EAAE,CAAC,GAAG,IAAI;IACzB,gBAAgB,EAAE,EAAE;IACpB,qBAAqB,EAAE,IAAI;IAC3B,gBAAgB,EAAE,GAAG;IACrB,sBAAsB,EAAE,IAAI;IAC5B,+BAA+B,EAAE,GAAG;IACpC,qBAAqB,EAAE,GAAG;IAC1B,4BAA4B,EAAE,CAAC,GAAG,IAAI;IACtC,uBAAuB,EAAE,CAAC;CAClB,CAAC,CAAC;AAEC,QAAA,6BAA6B,GAAG,CAAC,iBAAiB,EAAE,sBAAsB,EAAE,iBAAiB,CAAU,CAAC;AAExG,QAAA,6BAA6B,GAAG,CAAC,sBAAsB,EAAE,wBAAwB,EAAE,8BAA8B,CAAU,CAAC"}

package/dist/environment/index.d.ts

@@ -0,0 +1,5 @@
+export * from './contracts.js';
+export * from './references.js';
+export * from './validation.js';
+export * from './canonicalization.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/environment/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/environment/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC"}

package/dist/environment/index.js

@@ -0,0 +1,21 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./contracts.js"), exports);
+__exportStar(require("./references.js"), exports);
+__exportStar(require("./validation.js"), exports);
+__exportStar(require("./canonicalization.js"), exports);
+//# sourceMappingURL=index.js.map

package/dist/environment/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/environment/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,iDAA+B;AAC/B,kDAAgC;AAChC,kDAAgC;AAChC,wDAAsC"}

package/dist/environment/internal.d.ts

@@ -0,0 +1,21 @@
+export declare const SHA256_PATTERN: RegExp;
+export declare const ENVIRONMENT_RUN_ID_PATTERN: RegExp;
+export declare const DECIMAL_PATTERN: RegExp;
+export declare const CURRENCY_PATTERN: RegExp;
+export declare const PROTOTYPE_KEYS: Set<string>;
+export declare const hasControlCharacter: (value: string) => boolean;
+export declare const isRecord: (value: unknown) => value is Record<string, unknown>;
+export declare const hasExactKeys: (value: Record<string, unknown>, required: readonly string[], optional?: readonly string[]) => boolean;
+export declare const isBoundedString: (value: unknown, maximumScalars: number, options?: {
+    trimmed?: boolean;
+    controls?: boolean;
+}) => value is string;
+export declare const isCustomerString: (value: unknown) => value is string;
+export declare const isSafeLabel: (value: unknown) => value is string;
+export declare const isScopeIdentifier: (value: unknown) => value is string;
+export declare const isSourceIdentity: (value: unknown) => value is string;
+export declare const isNonNegativeInteger: (value: unknown) => value is number;
+export declare const isCanonicalUtcTimestamp: (value: unknown) => value is string;
+export declare const utf8ByteLength: (value: string) => number;
+export declare const hasSafeContainerShape: (value: unknown, depth?: number, seen?: Set<object>) => boolean;
+//# sourceMappingURL=internal.d.ts.map

package/dist/environment/internal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../../src/environment/internal.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,QAAoB,CAAC;AAChD,eAAO,MAAM,0BAA0B,QAAuB,CAAC;AAC/D,eAAO,MAAM,eAAe,QAAgC,CAAC;AAC7D,eAAO,MAAM,gBAAgB,QAAgB,CAAC;AAC9C,eAAO,MAAM,cAAc,aAAqD,CAAC;AAEjF,eAAO,MAAM,mBAAmB,GAAI,OAAO,MAAM,KAAG,OAMnD,CAAC;AAEF,eAAO,MAAM,QAAQ,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAIxE,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,SAAS,MAAM,EAAE,EAAE,WAAU,SAAS,MAAM,EAAO,KAAG,OAI5H,CAAC;AAkBF,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,gBAAgB,MAAM,EAAE,UAAS;IAAE,OAAO,CAAC,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,EAAE,OAAO,CAAA;CAAO,KAAG,KAAK,IAAI,MAM1I,CAAC;AAEF,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACuC,CAAC;AAEnG,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACsD,CAAC;AAE7G,eAAO,MAAM,iBAAiB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACsD,CAAC;AAEnH,eAAO,MAAM,gBAAgB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MACsD,CAAC;AAElH,eAAO,MAAM,oBAAoB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAA+D,CAAC;AAE/H,eAAO,MAAM,uBAAuB,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,MAIjE,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,KAAG,MAU9C,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,OAAO,OAAO,EAAE,cAAS,EAAE,kBAAwB,KAAG,OAe3F,CAAC"}

package/dist/environment/internal.js

@@ -0,0 +1,113 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hasSafeContainerShape = exports.utf8ByteLength = exports.isCanonicalUtcTimestamp = exports.isNonNegativeInteger = exports.isSourceIdentity = exports.isScopeIdentifier = exports.isSafeLabel = exports.isCustomerString = exports.isBoundedString = exports.hasExactKeys = exports.isRecord = exports.hasControlCharacter = exports.PROTOTYPE_KEYS = exports.CURRENCY_PATTERN = exports.DECIMAL_PATTERN = exports.ENVIRONMENT_RUN_ID_PATTERN = exports.SHA256_PATTERN = void 0;
+const contracts_js_1 = require("./contracts.js");
+exports.SHA256_PATTERN = /^[a-f0-9]{64}$/u;
+exports.ENVIRONMENT_RUN_ID_PATTERN = /^[A-Za-z0-9._-]+$/u;
+exports.DECIMAL_PATTERN = /^(?:0|[1-9]\d*)(?:\.\d+)?$/u;
+exports.CURRENCY_PATTERN = /^[A-Z]{3}$/u;
+exports.PROTOTYPE_KEYS = new Set(['__proto__', 'prototype', 'constructor']);
+const hasControlCharacter = (value) => {
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint <= 0x1f || (codePoint >= 0x7f && codePoint <= 0x9f))
+            return true;
+    }
+    return false;
+};
+exports.hasControlCharacter = hasControlCharacter;
+const isRecord = (value) => {
+    if (typeof value !== 'object' || value === null || Array.isArray(value))
+        return false;
+    const prototype = Object.getPrototypeOf(value);
+    return prototype === Object.prototype || prototype === null;
+};
+exports.isRecord = isRecord;
+const hasExactKeys = (value, required, optional = []) => {
+    const allowed = new Set([...required, ...optional]);
+    const keys = Object.keys(value);
+    return required.every(key => Object.prototype.hasOwnProperty.call(value, key)) && keys.every(key => allowed.has(key) && !exports.PROTOTYPE_KEYS.has(key));
+};
+exports.hasExactKeys = hasExactKeys;
+const scalarLength = (value) => {
+    let count = 0;
+    for (let index = 0; index < value.length; index += 1) {
+        const codeUnit = value.charCodeAt(index);
+        if (codeUnit >= 0xd800 && codeUnit <= 0xdbff) {
+            const trailing = value.charCodeAt(index + 1);
+            if (!(trailing >= 0xdc00 && trailing <= 0xdfff))
+                return null;
+            index += 1;
+        }
+        else if (codeUnit >= 0xdc00 && codeUnit <= 0xdfff) {
+            return null;
+        }
+        count += 1;
+    }
+    return count;
+};
+const isBoundedString = (value, maximumScalars, options = {}) => {
+    if (typeof value !== 'string')
+        return false;
+    if (options.trimmed && (value.length === 0 || value.trim() !== value))
+        return false;
+    if (options.controls && (0, exports.hasControlCharacter)(value))
+        return false;
+    const length = scalarLength(value);
+    return length !== null && length <= maximumScalars;
+};
+exports.isBoundedString = isBoundedString;
+const isCustomerString = (value) => (0, exports.isBoundedString)(value, contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.customerStringScalars, { controls: true });
+exports.isCustomerString = isCustomerString;
+const isSafeLabel = (value) => (0, exports.isBoundedString)(value, contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.safeLabelScalars, { trimmed: true, controls: true });
+exports.isSafeLabel = isSafeLabel;
+const isScopeIdentifier = (value) => (0, exports.isBoundedString)(value, contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.scopeIdentifierScalars, { trimmed: true, controls: true });
+exports.isScopeIdentifier = isScopeIdentifier;
+const isSourceIdentity = (value) => (0, exports.isBoundedString)(value, contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.sourceIdentityScalars, { trimmed: true, controls: true });
+exports.isSourceIdentity = isSourceIdentity;
+const isNonNegativeInteger = (value) => Number.isSafeInteger(value) && value >= 0;
+exports.isNonNegativeInteger = isNonNegativeInteger;
+const isCanonicalUtcTimestamp = (value) => {
+    if (typeof value !== 'string' || !/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{3}Z$/u.test(value))
+        return false;
+    const milliseconds = Date.parse(value);
+    return Number.isFinite(milliseconds) && new Date(milliseconds).toISOString() === value;
+};
+exports.isCanonicalUtcTimestamp = isCanonicalUtcTimestamp;
+const utf8ByteLength = (value) => {
+    let bytes = 0;
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint <= 0x7f)
+            bytes += 1;
+        else if (codePoint <= 0x7ff)
+            bytes += 2;
+        else if (codePoint <= 0xffff)
+            bytes += 3;
+        else
+            bytes += 4;
+    }
+    return bytes;
+};
+exports.utf8ByteLength = utf8ByteLength;
+const hasSafeContainerShape = (value, depth = 0, seen = new Set()) => {
+    if (depth > contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.validatedContainerDepth)
+        return false;
+    if (typeof value !== 'object' || value === null)
+        return true;
+    if (seen.has(value))
+        return false;
+    seen.add(value);
+    if (Array.isArray(value)) {
+        const valid = value.length <= contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.boundedListItems && value.every(item => (0, exports.hasSafeContainerShape)(item, depth + 1, seen));
+        seen.delete(value);
+        return valid;
+    }
+    if (!(0, exports.isRecord)(value))
+        return false;
+    const valid = Object.keys(value).every(key => !exports.PROTOTYPE_KEYS.has(key) && (0, exports.hasSafeContainerShape)(value[key], depth + 1, seen));
+    seen.delete(value);
+    return valid;
+};
+exports.hasSafeContainerShape = hasSafeContainerShape;
+//# sourceMappingURL=internal.js.map

package/dist/environment/internal.js.map

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

package/dist/environment/references.d.ts

@@ -0,0 +1,18 @@
+import { type EnvironmentArtifactKindV1, type EnvironmentLogicalArtifactReferenceV1, type EnvironmentLogicalEvidenceReferenceV1, type EnvironmentLogicalResourceReferenceV1, type ParsedEnvironmentLogicalArtifactReferenceV1, type ParsedEnvironmentLogicalEvidenceReferenceV1, type ParsedEnvironmentLogicalResourceReferenceV1 } from './contracts.js';
+/** Builds an opaque logical artifact reference. The decoded subject is never a storage path. */
+export declare const buildEnvironmentLogicalArtifactReferenceV1: (artifactKind: EnvironmentArtifactKindV1, canonicalScopeQualifiedSubject: string) => EnvironmentLogicalArtifactReferenceV1;
+/** Parses a V1 logical artifact reference into its allowlisted kind and opaque subject. */
+export declare const parseEnvironmentLogicalArtifactReferenceV1: (value: unknown) => ParsedEnvironmentLogicalArtifactReferenceV1 | null;
+/** Builds an opaque logical Azure resource reference from a canonical resource ID. */
+export declare const buildEnvironmentLogicalResourceReferenceV1: (canonicalAzureResourceId: string) => EnvironmentLogicalResourceReferenceV1;
+/** Parses a V1 logical resource reference into a canonical Azure resource ID. */
+export declare const parseEnvironmentLogicalResourceReferenceV1: (value: unknown) => ParsedEnvironmentLogicalResourceReferenceV1 | null;
+/** Parses either closed V1 logical evidence-reference kind. */
+export declare const parseEnvironmentLogicalEvidenceReferenceV1: (value: unknown) => ParsedEnvironmentLogicalEvidenceReferenceV1 | null;
+/** Returns true when a value is a canonical V1 logical artifact reference. */
+export declare const isEnvironmentLogicalArtifactReferenceV1: (value: unknown) => value is EnvironmentLogicalArtifactReferenceV1;
+/** Returns true when a value is a canonical V1 logical resource reference. */
+export declare const isEnvironmentLogicalResourceReferenceV1: (value: unknown) => value is EnvironmentLogicalResourceReferenceV1;
+/** Returns true when a value is one of the closed V1 logical evidence-reference kinds. */
+export declare const isEnvironmentLogicalEvidenceReferenceV1: (value: unknown) => value is EnvironmentLogicalEvidenceReferenceV1;
+//# sourceMappingURL=references.d.ts.map

package/dist/environment/references.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"references.d.ts","sourceRoot":"","sources":["../../src/environment/references.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,yBAAyB,EAC9B,KAAK,qCAAqC,EAC1C,KAAK,qCAAqC,EAC1C,KAAK,qCAAqC,EAC1C,KAAK,2CAA2C,EAChD,KAAK,2CAA2C,EAChD,KAAK,2CAA2C,EACjD,MAAM,gBAAgB,CAAC;AA2IxB,gGAAgG;AAChG,eAAO,MAAM,0CAA0C,GACrD,cAAc,yBAAyB,EACvC,gCAAgC,MAAM,KACrC,qCAOF,CAAC;AAEF,2FAA2F;AAC3F,eAAO,MAAM,0CAA0C,GAAI,OAAO,OAAO,KAAG,2CAA2C,GAAG,IAYzH,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,0CAA0C,GAAI,0BAA0B,MAAM,KAAG,qCAI7F,CAAC;AAEF,iFAAiF;AACjF,eAAO,MAAM,0CAA0C,GAAI,OAAO,OAAO,KAAG,2CAA2C,GAAG,IAKzH,CAAC;AAEF,+DAA+D;AAC/D,eAAO,MAAM,0CAA0C,GAAI,OAAO,OAAO,KAAG,2CAA2C,GAAG,IAClB,CAAC;AAEzG,8EAA8E;AAC9E,eAAO,MAAM,uCAAuC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qCACtB,CAAC;AAE7D,8EAA8E;AAC9E,eAAO,MAAM,uCAAuC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qCACtB,CAAC;AAE7D,0FAA0F;AAC1F,eAAO,MAAM,uCAAuC,GAAI,OAAO,OAAO,KAAG,KAAK,IAAI,qCACtB,CAAC"}

package/dist/environment/references.js

@@ -0,0 +1,206 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isEnvironmentLogicalEvidenceReferenceV1 = exports.isEnvironmentLogicalResourceReferenceV1 = exports.isEnvironmentLogicalArtifactReferenceV1 = exports.parseEnvironmentLogicalEvidenceReferenceV1 = exports.parseEnvironmentLogicalResourceReferenceV1 = exports.buildEnvironmentLogicalResourceReferenceV1 = exports.parseEnvironmentLogicalArtifactReferenceV1 = exports.buildEnvironmentLogicalArtifactReferenceV1 = void 0;
+const contracts_js_1 = require("./contracts.js");
+const internal_js_1 = require("./internal.js");
+const BASE64URL_ALPHABET = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_';
+const ARTIFACT_PREFIX = 'spotto://artifact/v1/';
+const RESOURCE_PREFIX = 'spotto://resource/v1/';
+const ARTIFACT_KINDS = new Set(contracts_js_1.ENVIRONMENT_ARTIFACT_KINDS_V1);
+const isCanonicalScopeQualifiedSubject = (value) => {
+    try {
+        const parsed = JSON.parse(value);
+        return (Array.isArray(parsed) &&
+            parsed.length === 4 &&
+            parsed[0] === 'azure-subscription' &&
+            parsed
+                .slice(1)
+                .every(item => (0, internal_js_1.isBoundedString)(item, contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.scopeIdentifierScalars, { trimmed: true, controls: true })) &&
+            JSON.stringify(parsed) === value);
+    }
+    catch {
+        return false;
+    }
+};
+const encodeUtf8 = (value) => {
+    const bytes = [];
+    for (const character of value) {
+        const codePoint = character.codePointAt(0);
+        if (codePoint <= 0x7f)
+            bytes.push(codePoint);
+        else if (codePoint <= 0x7ff)
+            bytes.push(0xc0 | (codePoint >> 6), 0x80 | (codePoint & 0x3f));
+        else if (codePoint <= 0xffff)
+            bytes.push(0xe0 | (codePoint >> 12), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+        else
+            bytes.push(0xf0 | (codePoint >> 18), 0x80 | ((codePoint >> 12) & 0x3f), 0x80 | ((codePoint >> 6) & 0x3f), 0x80 | (codePoint & 0x3f));
+    }
+    return bytes;
+};
+const encodeBase64Url = (bytes) => {
+    let output = '';
+    for (let index = 0; index < bytes.length; index += 3) {
+        const first = bytes[index];
+        const second = bytes[index + 1];
+        const third = bytes[index + 2];
+        output += BASE64URL_ALPHABET[first >> 2];
+        output += BASE64URL_ALPHABET[((first & 0x03) << 4) | ((second ?? 0) >> 4)];
+        if (second !== undefined)
+            output += BASE64URL_ALPHABET[((second & 0x0f) << 2) | ((third ?? 0) >> 6)];
+        if (third !== undefined)
+            output += BASE64URL_ALPHABET[third & 0x3f];
+    }
+    return output;
+};
+const decodeBase64Url = (value) => {
+    if (!/^[A-Za-z0-9_-]+$/u.test(value) || value.length % 4 === 1)
+        return null;
+    const bytes = [];
+    for (let index = 0; index < value.length; index += 4) {
+        const first = BASE64URL_ALPHABET.indexOf(value[index]);
+        const second = BASE64URL_ALPHABET.indexOf(value[index + 1]);
+        const thirdCharacter = value[index + 2];
+        const fourthCharacter = value[index + 3];
+        const third = thirdCharacter === undefined ? 0 : BASE64URL_ALPHABET.indexOf(thirdCharacter);
+        const fourth = fourthCharacter === undefined ? 0 : BASE64URL_ALPHABET.indexOf(fourthCharacter);
+        if (first < 0 || second < 0 || third < 0 || fourth < 0)
+            return null;
+        bytes.push((first << 2) | (second >> 4));
+        if (thirdCharacter !== undefined)
+            bytes.push(((second & 0x0f) << 4) | (third >> 2));
+        if (fourthCharacter !== undefined)
+            bytes.push(((third & 0x03) << 6) | fourth);
+    }
+    return encodeBase64Url(bytes) === value ? bytes : null;
+};
+const decodeUtf8 = (bytes) => {
+    let output = '';
+    for (let index = 0; index < bytes.length;) {
+        const first = bytes[index];
+        let codePoint;
+        let continuationCount;
+        if (first <= 0x7f) {
+            codePoint = first;
+            continuationCount = 0;
+        }
+        else if (first >= 0xc2 && first <= 0xdf) {
+            codePoint = first & 0x1f;
+            continuationCount = 1;
+        }
+        else if (first >= 0xe0 && first <= 0xef) {
+            codePoint = first & 0x0f;
+            continuationCount = 2;
+        }
+        else if (first >= 0xf0 && first <= 0xf4) {
+            codePoint = first & 0x07;
+            continuationCount = 3;
+        }
+        else
+            return null;
+        if (index + continuationCount >= bytes.length)
+            return null;
+        for (let offset = 1; offset <= continuationCount; offset += 1) {
+            const next = bytes[index + offset];
+            if ((next & 0xc0) !== 0x80)
+                return null;
+            codePoint = (codePoint << 6) | (next & 0x3f);
+        }
+        if ((continuationCount === 2 && codePoint < 0x800) ||
+            (continuationCount === 3 && codePoint < 0x10000) ||
+            (codePoint >= 0xd800 && codePoint <= 0xdfff) ||
+            codePoint > 0x10ffff) {
+            return null;
+        }
+        output += String.fromCodePoint(codePoint);
+        index += continuationCount + 1;
+    }
+    return output;
+};
+const decodePayload = (value) => {
+    const bytes = decodeBase64Url(value);
+    if (bytes === null || bytes.length > contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.logicalReferencePayloadBytes)
+        return null;
+    const decoded = decodeUtf8(bytes);
+    if (decoded === null || encodeBase64Url(encodeUtf8(decoded)) !== value)
+        return null;
+    return decoded;
+};
+const assertReferencePayload = (value, label, maximumScalars) => {
+    if (!(0, internal_js_1.isBoundedString)(value, maximumScalars, { trimmed: true, controls: true })) {
+        throw new TypeError(`${label} must be a non-empty, trimmed, bounded Unicode string without control characters.`);
+    }
+    if ((0, internal_js_1.utf8ByteLength)(value) > contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.logicalReferencePayloadBytes) {
+        throw new RangeError(`${label} exceeds the V1 logical-reference payload limit.`);
+    }
+};
+const isCanonicalAzureResourceId = (value) => {
+    if (!/^\/subscriptions\/[^/]+\/(?:resourceGroups\/[^/]+\/)?providers\/[^/]+\/[^/]+\/[^/]+(?:\/[^/]+\/[^/]+)*$/iu.test(value) ||
+        value.includes('\\') ||
+        value.includes('?') ||
+        value.includes('#') ||
+        value.includes('%') ||
+        (0, internal_js_1.hasControlCharacter)(value)) {
+        return false;
+    }
+    return value.split('/').every(segment => segment !== '.' && segment !== '..');
+};
+/** Builds an opaque logical artifact reference. The decoded subject is never a storage path. */
+const buildEnvironmentLogicalArtifactReferenceV1 = (artifactKind, canonicalScopeQualifiedSubject) => {
+    if (!ARTIFACT_KINDS.has(artifactKind))
+        throw new TypeError('Unsupported V1 environment artifact kind.');
+    assertReferencePayload(canonicalScopeQualifiedSubject, 'Artifact subject', contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.customerStringScalars);
+    if (!isCanonicalScopeQualifiedSubject(canonicalScopeQualifiedSubject)) {
+        throw new TypeError('Artifact subject is not a canonical V1 scope-qualified subject.');
+    }
+    return `${ARTIFACT_PREFIX}${artifactKind}/${encodeBase64Url(encodeUtf8(canonicalScopeQualifiedSubject))}`;
+};
+exports.buildEnvironmentLogicalArtifactReferenceV1 = buildEnvironmentLogicalArtifactReferenceV1;
+/** Parses a V1 logical artifact reference into its allowlisted kind and opaque subject. */
+const parseEnvironmentLogicalArtifactReferenceV1 = (value) => {
+    if (typeof value !== 'string' || !value.startsWith(ARTIFACT_PREFIX))
+        return null;
+    const remainder = value.slice(ARTIFACT_PREFIX.length);
+    const separator = remainder.indexOf('/');
+    if (separator <= 0 || remainder.indexOf('/', separator + 1) >= 0)
+        return null;
+    const artifactKind = remainder.slice(0, separator);
+    if (!ARTIFACT_KINDS.has(artifactKind))
+        return null;
+    const subject = decodePayload(remainder.slice(separator + 1));
+    if (subject === null || !isCanonicalScopeQualifiedSubject(subject)) {
+        return null;
+    }
+    return { kind: 'artifact', artifactKind: artifactKind, subject };
+};
+exports.parseEnvironmentLogicalArtifactReferenceV1 = parseEnvironmentLogicalArtifactReferenceV1;
+/** Builds an opaque logical Azure resource reference from a canonical resource ID. */
+const buildEnvironmentLogicalResourceReferenceV1 = (canonicalAzureResourceId) => {
+    assertReferencePayload(canonicalAzureResourceId, 'Azure resource ID', contracts_js_1.ENVIRONMENT_CONTRACT_LIMITS_V1.scopeIdentifierScalars);
+    if (!isCanonicalAzureResourceId(canonicalAzureResourceId))
+        throw new TypeError('Azure resource ID is not canonical or safe.');
+    return `${RESOURCE_PREFIX}${encodeBase64Url(encodeUtf8(canonicalAzureResourceId))}`;
+};
+exports.buildEnvironmentLogicalResourceReferenceV1 = buildEnvironmentLogicalResourceReferenceV1;
+/** Parses a V1 logical resource reference into a canonical Azure resource ID. */
+const parseEnvironmentLogicalResourceReferenceV1 = (value) => {
+    if (typeof value !== 'string' || !value.startsWith(RESOURCE_PREFIX))
+        return null;
+    const resourceId = decodePayload(value.slice(RESOURCE_PREFIX.length));
+    if (resourceId === null || !isCanonicalAzureResourceId(resourceId))
+        return null;
+    return { kind: 'resource', resourceId };
+};
+exports.parseEnvironmentLogicalResourceReferenceV1 = parseEnvironmentLogicalResourceReferenceV1;
+/** Parses either closed V1 logical evidence-reference kind. */
+const parseEnvironmentLogicalEvidenceReferenceV1 = (value) => (0, exports.parseEnvironmentLogicalArtifactReferenceV1)(value) ?? (0, exports.parseEnvironmentLogicalResourceReferenceV1)(value);
+exports.parseEnvironmentLogicalEvidenceReferenceV1 = parseEnvironmentLogicalEvidenceReferenceV1;
+/** Returns true when a value is a canonical V1 logical artifact reference. */
+const isEnvironmentLogicalArtifactReferenceV1 = (value) => (0, exports.parseEnvironmentLogicalArtifactReferenceV1)(value) !== null;
+exports.isEnvironmentLogicalArtifactReferenceV1 = isEnvironmentLogicalArtifactReferenceV1;
+/** Returns true when a value is a canonical V1 logical resource reference. */
+const isEnvironmentLogicalResourceReferenceV1 = (value) => (0, exports.parseEnvironmentLogicalResourceReferenceV1)(value) !== null;
+exports.isEnvironmentLogicalResourceReferenceV1 = isEnvironmentLogicalResourceReferenceV1;
+/** Returns true when a value is one of the closed V1 logical evidence-reference kinds. */
+const isEnvironmentLogicalEvidenceReferenceV1 = (value) => (0, exports.parseEnvironmentLogicalEvidenceReferenceV1)(value) !== null;
+exports.isEnvironmentLogicalEvidenceReferenceV1 = isEnvironmentLogicalEvidenceReferenceV1;
+//# sourceMappingURL=references.js.map