@spottoai/types-package 1.0.2-beta.39 → 1.0.2-beta.391

package/dist/environment/contracts.d.ts

@@ -0,0 +1,259 @@
+/** Single pre-release multi-pillar environment contract shared by producers and consumers. */
+export declare const ENVIRONMENT_CONTRACT_LIMITS_V1: Readonly<{
+    readonly completedPointerBytes: number;
+    readonly projectionBytes: number;
+    readonly environmentIndexBytes: number;
+    readonly pillarDocumentBytes: number;
+    readonly boundedListItems: 50;
+    readonly customerStringScalars: 4096;
+    readonly safeLabelScalars: 512;
+    readonly scopeIdentifierScalars: 2048;
+    readonly environmentRunIdAsciiCharacters: 128;
+    readonly sourceIdentityScalars: 256;
+    readonly logicalReferencePayloadBytes: number;
+    readonly validatedContainerDepth: 10;
+}>;
+export declare const ENVIRONMENT_PILLARS_V1: readonly ["cost", "security", "governance", "reliability", "performance", "operations"];
+export declare const ENVIRONMENT_DOCUMENT_NAMES_V1: readonly ["projection.json", "environment-index.md", "pillars/cost.md", "pillars/security.md", "pillars/governance.md", "pillars/reliability.md", "pillars/performance.md", "pillars/operations.md"];
+export declare const ENVIRONMENT_ARTIFACT_KINDS_V1: readonly ["subscription-summary", "subscription-resources", "subscription-recommendations", "subscription-service-retirements", "subscription-monitor-alerts", "subscription-system-tracks", "subscription-metrics"];
+export declare const ENVIRONMENT_FINDING_KINDS_V1: readonly ["recommendation", "security-posture", "public-exposure", "governance", "compliance", "service-retirement", "data-protection", "health", "performance", "scaling", "operations", "monitoring", "topology"];
+export declare const ENVIRONMENT_SEVERITIES_V1: readonly ["critical", "high", "medium", "low", "informational", "unknown"];
+export declare const ENVIRONMENT_IMPACTS_V1: readonly ["high", "medium", "low", "unknown"];
+export declare const ENVIRONMENT_EFFORTS_V1: readonly ["high", "medium", "low", "unknown"];
+export type EnvironmentPillarV1 = (typeof ENVIRONMENT_PILLARS_V1)[number];
+export type EnvironmentDocumentNameV1 = (typeof ENVIRONMENT_DOCUMENT_NAMES_V1)[number];
+export type EnvironmentMarkdownDocumentNameV1 = Exclude<EnvironmentDocumentNameV1, 'projection.json'>;
+export type EnvironmentArtifactKindV1 = (typeof ENVIRONMENT_ARTIFACT_KINDS_V1)[number];
+export type EnvironmentFindingKindV1 = (typeof ENVIRONMENT_FINDING_KINDS_V1)[number];
+export type EnvironmentSeverityV1 = (typeof ENVIRONMENT_SEVERITIES_V1)[number];
+export type EnvironmentImpactV1 = (typeof ENVIRONMENT_IMPACTS_V1)[number];
+export type EnvironmentEffortV1 = (typeof ENVIRONMENT_EFFORTS_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 {
+    completedViewSet: EnvironmentCoverageStateV1;
+    subscriptionSummary: EnvironmentCoverageStateV1;
+    resources: EnvironmentCoverageStateV1;
+    recommendations: EnvironmentCoverageStateV1;
+    serviceRetirements: EnvironmentCoverageStateV1;
+    monitorAlerts: EnvironmentCoverageStateV1;
+    pluginMetrics: EnvironmentCoverageStateV1;
+}
+export interface EnvironmentEstateSummaryV1 {
+    resourceCount: number;
+    serviceFamilyCount: number;
+    locationCount: number;
+}
+export interface EnvironmentCostSummaryV1 {
+    observedCost?: EnvironmentMoneyValueV1;
+    potentialSavings?: EnvironmentMoneyValueV1;
+    costRecommendationCount?: 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 EnvironmentPillarScoreV1 {
+    value: string;
+    maximum: '100';
+    safeLabel: string;
+}
+export interface EnvironmentPillarSummaryV1 {
+    pillar: EnvironmentPillarV1;
+    coverage: EnvironmentCoverageStateV1;
+    findingCount: number;
+    recommendationCount: number;
+    affectedResourceCount: number;
+    portalRoute: string;
+    score?: EnvironmentPillarScoreV1;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export type EnvironmentPillarSummariesV1 = {
+    [Pillar in EnvironmentPillarV1]: EnvironmentPillarSummaryV1 & {
+        pillar: Pillar;
+    };
+};
+export interface EnvironmentFindingV1 {
+    findingId: string;
+    pillar: EnvironmentPillarV1;
+    kind: EnvironmentFindingKindV1;
+    safeLabel: string;
+    severity: EnvironmentSeverityV1;
+    description?: string;
+    impact?: EnvironmentImpactV1;
+    effort?: EnvironmentEffortV1;
+    confidencePercentage?: string;
+    affectedResourceCount?: number;
+    portalRoute?: string;
+    resourceReferences: EnvironmentLogicalResourceReferenceV1[];
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentRecommendationV1 {
+    recommendationId: string;
+    pillar: EnvironmentPillarV1;
+    safeLabel: string;
+    portalRoute: string;
+    description?: string;
+    impact?: EnvironmentImpactV1;
+    effort?: EnvironmentEffortV1;
+    confidencePercentage?: string;
+    affectedResourceCount?: number;
+    potentialSavings?: EnvironmentMoneyValueV1;
+    resourceReferences: EnvironmentLogicalResourceReferenceV1[];
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentChangeV1 {
+    key: string;
+    pillars: EnvironmentPillarV1[];
+    safeLabel: string;
+    description: string;
+    direction: 'increase' | 'decrease' | 'unchanged' | 'unknown';
+    amount?: EnvironmentMoneyValueV1;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentProjectionWarningV1 {
+    code: string;
+    safeLabel: string;
+    pillar?: EnvironmentPillarV1;
+    detail?: string;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export interface EnvironmentSubscriptionProjectionV1 {
+    schemaVersion: 1;
+    scope: EnvironmentScopeV1;
+    sourceBinding: EnvironmentSourceBindingV1;
+    generatedAt: string;
+    subscription: EnvironmentSubscriptionSummaryV1;
+    sourceCoverage: EnvironmentSourceCoverageV1;
+    estateSummary: EnvironmentEstateSummaryV1;
+    costSummary: EnvironmentCostSummaryV1;
+    serviceFamilyRollups: EnvironmentBoundedListV1<EnvironmentCostRollupV1>;
+    estateCostRollups: EnvironmentBoundedListV1<EnvironmentCostRollupV1>;
+    costDrivers: EnvironmentBoundedListV1<EnvironmentCostDriverV1>;
+    pillars: EnvironmentPillarSummariesV1;
+    findings: EnvironmentBoundedListV1<EnvironmentFindingV1>;
+    recommendations: EnvironmentBoundedListV1<EnvironmentRecommendationV1>;
+    changes: EnvironmentBoundedListV1<EnvironmentChangeV1>;
+    warnings: EnvironmentBoundedListV1<EnvironmentProjectionWarningV1>;
+    sourceReferences: EnvironmentLogicalEvidenceReferenceV1[];
+}
+export type EnvironmentDocumentDescriptorV1 = {
+    name: 'projection.json';
+    mediaType: 'application/json';
+    byteCount: number;
+    contentSha256: string;
+    approximateTokenCount: number;
+} | {
+    name: EnvironmentMarkdownDocumentNameV1;
+    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: (typeof ENVIRONMENT_DOCUMENT_NAMES_V1)['length'];
+    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":"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"}

package/dist/environment/contracts.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ENVIRONMENT_EFFORTS_V1 = exports.ENVIRONMENT_IMPACTS_V1 = exports.ENVIRONMENT_SEVERITIES_V1 = exports.ENVIRONMENT_FINDING_KINDS_V1 = exports.ENVIRONMENT_ARTIFACT_KINDS_V1 = exports.ENVIRONMENT_DOCUMENT_NAMES_V1 = exports.ENVIRONMENT_PILLARS_V1 = exports.ENVIRONMENT_CONTRACT_LIMITS_V1 = void 0;
+/** Single pre-release multi-pillar environment contract shared by producers and consumers. */
+exports.ENVIRONMENT_CONTRACT_LIMITS_V1 = Object.freeze({
+    completedPointerBytes: 16 * 1024,
+    projectionBytes: 256 * 1024,
+    environmentIndexBytes: 8 * 1024,
+    pillarDocumentBytes: 8 * 1024,
+    boundedListItems: 50,
+    customerStringScalars: 4096,
+    safeLabelScalars: 512,
+    scopeIdentifierScalars: 2048,
+    environmentRunIdAsciiCharacters: 128,
+    sourceIdentityScalars: 256,
+    logicalReferencePayloadBytes: 4 * 1024,
+    validatedContainerDepth: 10,
+});
+exports.ENVIRONMENT_PILLARS_V1 = ['cost', 'security', 'governance', 'reliability', 'performance', 'operations'];
+exports.ENVIRONMENT_DOCUMENT_NAMES_V1 = [
+    'projection.json',
+    'environment-index.md',
+    'pillars/cost.md',
+    'pillars/security.md',
+    'pillars/governance.md',
+    'pillars/reliability.md',
+    'pillars/performance.md',
+    'pillars/operations.md',
+];
+exports.ENVIRONMENT_ARTIFACT_KINDS_V1 = [
+    'subscription-summary',
+    'subscription-resources',
+    'subscription-recommendations',
+    'subscription-service-retirements',
+    'subscription-monitor-alerts',
+    'subscription-system-tracks',
+    'subscription-metrics',
+];
+exports.ENVIRONMENT_FINDING_KINDS_V1 = [
+    'recommendation',
+    'security-posture',
+    'public-exposure',
+    'governance',
+    'compliance',
+    'service-retirement',
+    'data-protection',
+    'health',
+    'performance',
+    'scaling',
+    'operations',
+    'monitoring',
+    'topology',
+];
+exports.ENVIRONMENT_SEVERITIES_V1 = ['critical', 'high', 'medium', 'low', 'informational', 'unknown'];
+exports.ENVIRONMENT_IMPACTS_V1 = ['high', 'medium', 'low', 'unknown'];
+exports.ENVIRONMENT_EFFORTS_V1 = ['high', 'medium', 'low', 'unknown'];
+//# 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,8FAA8F;AACjF,QAAA,8BAA8B,GAAG,MAAM,CAAC,MAAM,CAAC;IAC1D,qBAAqB,EAAE,EAAE,GAAG,IAAI;IAChC,eAAe,EAAE,GAAG,GAAG,IAAI;IAC3B,qBAAqB,EAAE,CAAC,GAAG,IAAI;IAC/B,mBAAmB,EAAE,CAAC,GAAG,IAAI;IAC7B,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,EAAE;CACnB,CAAC,CAAC;AAEC,QAAA,sBAAsB,GAAG,CAAC,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,YAAY,CAAU,CAAC;AAEjH,QAAA,6BAA6B,GAAG;IAC3C,iBAAiB;IACjB,sBAAsB;IACtB,iBAAiB;IACjB,qBAAqB;IACrB,uBAAuB;IACvB,wBAAwB;IACxB,wBAAwB;IACxB,uBAAuB;CACf,CAAC;AAEE,QAAA,6BAA6B,GAAG;IAC3C,sBAAsB;IACtB,wBAAwB;IACxB,8BAA8B;IAC9B,kCAAkC;IAClC,6BAA6B;IAC7B,4BAA4B;IAC5B,sBAAsB;CACd,CAAC;AAEE,QAAA,4BAA4B,GAAG;IAC1C,gBAAgB;IAChB,kBAAkB;IAClB,iBAAiB;IACjB,YAAY;IACZ,YAAY;IACZ,oBAAoB;IACpB,iBAAiB;IACjB,QAAQ;IACR,aAAa;IACb,SAAS;IACT,YAAY;IACZ,YAAY;IACZ,UAAU;CACF,CAAC;AAEE,QAAA,yBAAyB,GAAG,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,EAAE,SAAS,CAAU,CAAC;AACvG,QAAA,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,CAAU,CAAC;AACvE,QAAA,sBAAsB,GAAG,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,SAAS,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"}