@apollo-deploy/schemas 0.4.4

package/dist/definitions/policies/domain.schema.d.ts

@@ -0,0 +1,421 @@
+/**
+ * Policies Domain - Domain Schemas
+ *
+ * Zod schemas for the Store Policy & Compliance Engine domain models and enums.
+ * These schemas define the core types for policy rules, conditions, and evaluation.
+ */
+import { z } from 'zod';
+/**
+ * Failure behavior enum
+ *
+ * Determines how the policy engine handles evaluation errors.
+ * - fail_open: Errors are excluded from status calculation
+ * - fail_closed: Errors result in aggregate 'fail' status
+ */
+export declare const FailureBehaviorSchema: z.ZodEnum<{
+    fail_open: "fail_open";
+    fail_closed: "fail_closed";
+}>;
+/**
+ * Policy domain enum
+ *
+ * Separates system-managed store compliance rules from org-specific rules.
+ * - store_compliance: Apollo-owned, read-only to users
+ * - release_readiness: org-scoped, user-customizable
+ */
+export declare const PolicyDomainSchema: z.ZodEnum<{
+    store_compliance: "store_compliance";
+    release_readiness: "release_readiness";
+}>;
+/**
+ * Evaluation scope enum
+ *
+ * Defines the context boundary for rule evaluation.
+ * - single_artifact: Evaluate independently without external references
+ * - cross_artifact: Compare against other artifacts (future)
+ * - historical: Compare against historical data (future)
+ */
+export declare const EvaluationScopeSchema: z.ZodEnum<{
+    single_artifact: "single_artifact";
+    cross_artifact: "cross_artifact";
+    historical: "historical";
+}>;
+/**
+ * Severity enum
+ *
+ * Impact level of a rule outcome, used for conflict resolution.
+ */
+export declare const SeveritySchema: z.ZodEnum<{
+    info: "info";
+    warning: "warning";
+    high: "high";
+    critical: "critical";
+}>;
+/**
+ * Outcome enum
+ *
+ * Result of a rule evaluation.
+ */
+export declare const OutcomeSchema: z.ZodEnum<{
+    fail: "fail";
+    pass: "pass";
+    warn: "warn";
+}>;
+/**
+ * Evaluation outcome enum (includes error state)
+ *
+ * Extended outcome for rule evaluation results.
+ */
+export declare const EvaluationOutcomeSchema: z.ZodEnum<{
+    error: "error";
+    fail: "fail";
+    pass: "pass";
+    warn: "warn";
+}>;
+/**
+ * Store impact enum
+ *
+ * Predicted impact on store submission.
+ */
+export declare const StoreImpactSchema: z.ZodEnum<{
+    allowed: "allowed";
+    likely_manual_review: "likely_manual_review";
+    likely_rejection: "likely_rejection";
+}>;
+/**
+ * Store submission status enum
+ *
+ * Final recommendation for store submission.
+ */
+export declare const StoreSubmissionStatusSchema: z.ZodEnum<{
+    ready: "ready";
+    review_likely: "review_likely";
+    rejection_likely: "rejection_likely";
+    blocked: "blocked";
+}>;
+/**
+ * Comparison operator enum
+ *
+ * Operators for leaf conditions.
+ */
+export declare const ComparisonOperatorSchema: z.ZodEnum<{
+    in: "in";
+    regex: "regex";
+    eq: "eq";
+    neq: "neq";
+    gt: "gt";
+    gte: "gte";
+    lt: "lt";
+    lte: "lte";
+    nin: "nin";
+    contains: "contains";
+}>;
+/**
+ * Condition operator enum
+ *
+ * Logical operators for composite conditions.
+ */
+export declare const ConditionOperatorSchema: z.ZodEnum<{
+    AND: "AND";
+    OR: "OR";
+    NOT: "NOT";
+}>;
+/**
+ * Field type enum
+ *
+ * Types for metadata fields used in validation.
+ */
+export declare const FieldTypeSchema: z.ZodEnum<{
+    string: "string";
+    number: "number";
+    boolean: "boolean";
+    "string[]": "string[]";
+    "number[]": "number[]";
+}>;
+/**
+ * Operator-type compatibility matrix
+ *
+ * Defines which operators are valid for each field type.
+ * Used for validation at rule creation time.
+ */
+export declare const OPERATOR_TYPE_COMPATIBILITY: {
+    readonly string: readonly ["eq", "neq", "in", "nin", "contains", "regex"];
+    readonly number: readonly ["eq", "neq", "gt", "gte", "lt", "lte", "in", "nin"];
+    readonly boolean: readonly ["eq", "neq"];
+    readonly 'string[]': readonly ["eq", "neq", "in", "nin", "contains"];
+    readonly 'number[]': readonly ["eq", "neq", "in", "nin"];
+};
+/**
+ * Leaf condition schema
+ *
+ * A single comparison against a metadata field.
+ */
+export declare const LeafConditionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"leaf">;
+    field: z.ZodString;
+    operator: z.ZodEnum<{
+        in: "in";
+        regex: "regex";
+        eq: "eq";
+        neq: "neq";
+        gt: "gt";
+        gte: "gte";
+        lt: "lt";
+        lte: "lte";
+        nin: "nin";
+        contains: "contains";
+    }>;
+    value: z.ZodUnknown;
+}, z.core.$strip>;
+/**
+ * Condition schema (recursive union type)
+ *
+ * A condition can be either a leaf condition or a composite condition.
+ * Composite conditions contain an array of conditions (recursive).
+ */
+export declare const ConditionSchema: z.ZodType<Condition>;
+/**
+ * Composite condition schema (with conditions array)
+ */
+export declare const CompositeConditionSchema: z.ZodObject<{
+    type: z.ZodLiteral<"composite">;
+    operator: z.ZodEnum<{
+        AND: "AND";
+        OR: "OR";
+        NOT: "NOT";
+    }>;
+    conditions: z.ZodArray<z.ZodType<Condition, unknown, z.core.$ZodTypeInternals<Condition, unknown>>>;
+}, z.core.$strip>;
+/**
+ * Policy store schema
+ *
+ * Represents a distribution platform (e.g., Google Play, App Store).
+ */
+export declare const PolicyStoreSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    failureBehavior: z.ZodDefault<z.ZodEnum<{
+        fail_open: "fail_open";
+        fail_closed: "fail_closed";
+    }>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    config: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+/**
+ * Policy platform schema
+ *
+ * Represents an operating system target (e.g., android, ios, macos).
+ */
+export declare const PolicyPlatformSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    metadataSchema: z.ZodNullable<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    fieldTypeRegistry: z.ZodDefault<z.ZodRecord<z.ZodString, z.ZodEnum<{
+        string: "string";
+        number: "number";
+        boolean: "boolean";
+        "string[]": "string[]";
+        "number[]": "number[]";
+    }>>>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+/**
+ * Policy version schema
+ *
+ * Represents a versioned snapshot of store compliance requirements.
+ */
+export declare const PolicyVersionSchema: z.ZodObject<{
+    id: z.ZodString;
+    storeId: z.ZodString;
+    version: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    effectiveDate: z.ZodCoercedDate<unknown>;
+    deprecatedAt: z.ZodNullable<z.ZodUnion<readonly [z.ZodDate, z.ZodString]>>;
+    sourceUrl: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+/**
+ * Policy rule template schema
+ *
+ * Reusable rule templates that can be instantiated for specific stores.
+ */
+export declare const PolicyRuleTemplateSchema: z.ZodObject<{
+    id: z.ZodString;
+    code: z.ZodString;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    conditionTemplate: z.ZodType<Condition, unknown, z.core.$ZodTypeInternals<Condition, unknown>>;
+    defaultSeverity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        high: "high";
+        critical: "critical";
+    }>;
+    defaultOutcome: z.ZodEnum<{
+        fail: "fail";
+        pass: "pass";
+        warn: "warn";
+    }>;
+    defaultStoreImpact: z.ZodEnum<{
+        allowed: "allowed";
+        likely_manual_review: "likely_manual_review";
+        likely_rejection: "likely_rejection";
+    }>;
+    explanationTemplate: z.ZodString;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+/**
+ * Policy rule schema
+ *
+ * A database-stored compliance check definition.
+ */
+export declare const PolicyRuleSchema: z.ZodObject<{
+    id: z.ZodString;
+    ruleId: z.ZodString;
+    version: z.ZodDefault<z.ZodNumber>;
+    policyDomain: z.ZodDefault<z.ZodEnum<{
+        store_compliance: "store_compliance";
+        release_readiness: "release_readiness";
+    }>>;
+    orgId: z.ZodNullable<z.ZodString>;
+    storeId: z.ZodString;
+    platformId: z.ZodString;
+    policyVersionId: z.ZodNullable<z.ZodString>;
+    name: z.ZodString;
+    description: z.ZodNullable<z.ZodString>;
+    condition: z.ZodType<Condition, unknown, z.core.$ZodTypeInternals<Condition, unknown>>;
+    evaluationScope: z.ZodDefault<z.ZodEnum<{
+        single_artifact: "single_artifact";
+        cross_artifact: "cross_artifact";
+        historical: "historical";
+    }>>;
+    evaluationWindow: z.ZodNullable<z.ZodNumber>;
+    lookbackDays: z.ZodNullable<z.ZodNumber>;
+    severity: z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        high: "high";
+        critical: "critical";
+    }>;
+    outcome: z.ZodEnum<{
+        fail: "fail";
+        pass: "pass";
+        warn: "warn";
+    }>;
+    storeImpact: z.ZodEnum<{
+        allowed: "allowed";
+        likely_manual_review: "likely_manual_review";
+        likely_rejection: "likely_rejection";
+    }>;
+    reasonCode: z.ZodString;
+    explanation: z.ZodString;
+    documentationUrl: z.ZodNullable<z.ZodString>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    effectiveFrom: z.ZodCoercedDate<unknown>;
+    effectiveUntil: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    templateId: z.ZodNullable<z.ZodString>;
+    conditionDepth: z.ZodDefault<z.ZodNumber>;
+    conditionCount: z.ZodDefault<z.ZodNumber>;
+    createdBy: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+/**
+ * Policy status mapping schema
+ *
+ * Store-specific configuration for mapping aggregate results to submission status.
+ */
+export declare const PolicyStatusMappingSchema: z.ZodObject<{
+    id: z.ZodString;
+    storeId: z.ZodString;
+    warningThreshold: z.ZodDefault<z.ZodNumber>;
+    highSeverityBlocks: z.ZodDefault<z.ZodBoolean>;
+    criticalSeverityBlocks: z.ZodDefault<z.ZodBoolean>;
+    customRules: z.ZodDefault<z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>>;
+    isActive: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    updatedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+/**
+ * Policy evaluation audit schema
+ *
+ * Immutable record of a policy evaluation.
+ */
+export declare const PolicyEvaluationAuditSchema: z.ZodObject<{
+    id: z.ZodString;
+    orgId: z.ZodString;
+    artifactId: z.ZodString;
+    storeId: z.ZodString;
+    platformId: z.ZodString;
+    metadataSnapshot: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    metadataSchemaVersion: z.ZodNullable<z.ZodString>;
+    isSimulation: z.ZodDefault<z.ZodBoolean>;
+    evaluationMode: z.ZodDefault<z.ZodString>;
+    aggregateStatus: z.ZodEnum<{
+        fail: "fail";
+        pass: "pass";
+        warn: "warn";
+    }>;
+    storeSubmissionStatus: z.ZodEnum<{
+        ready: "ready";
+        review_likely: "review_likely";
+        rejection_likely: "rejection_likely";
+        blocked: "blocked";
+    }>;
+    highestSeverity: z.ZodNullable<z.ZodEnum<{
+        info: "info";
+        warning: "warning";
+        high: "high";
+        critical: "critical";
+    }>>;
+    rulesEvaluated: z.ZodNumber;
+    rulesPassed: z.ZodNumber;
+    rulesWarned: z.ZodNumber;
+    rulesFailed: z.ZodNumber;
+    rulesErrored: z.ZodNumber;
+    ruleResults: z.ZodArray<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    policyVersionsApplied: z.ZodArray<z.ZodString>;
+    evaluationStartedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    evaluationCompletedAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+    evaluationDurationMs: z.ZodNumber;
+    timedOut: z.ZodDefault<z.ZodBoolean>;
+    createdAt: z.ZodUnion<readonly [z.ZodDate, z.ZodString]>;
+}, z.core.$strip>;
+export type FailureBehavior = z.infer<typeof FailureBehaviorSchema>;
+export type PolicyDomain = z.infer<typeof PolicyDomainSchema>;
+export type EvaluationScope = z.infer<typeof EvaluationScopeSchema>;
+export type Severity = z.infer<typeof SeveritySchema>;
+export type Outcome = z.infer<typeof OutcomeSchema>;
+export type EvaluationOutcome = z.infer<typeof EvaluationOutcomeSchema>;
+export type StoreImpact = z.infer<typeof StoreImpactSchema>;
+export type StoreSubmissionStatus = z.infer<typeof StoreSubmissionStatusSchema>;
+export type ComparisonOperator = z.infer<typeof ComparisonOperatorSchema>;
+export type ConditionOperator = z.infer<typeof ConditionOperatorSchema>;
+export type FieldType = z.infer<typeof FieldTypeSchema>;
+export type LeafCondition = z.infer<typeof LeafConditionSchema>;
+export type CompositeCondition = {
+    type: 'composite';
+    operator: ConditionOperator;
+    conditions: Condition[];
+};
+export type Condition = LeafCondition | CompositeCondition;
+export type PolicyStore = z.infer<typeof PolicyStoreSchema>;
+export type PolicyPlatform = z.infer<typeof PolicyPlatformSchema>;
+export type PolicyVersion = z.infer<typeof PolicyVersionSchema>;
+export type PolicyRuleTemplate = z.infer<typeof PolicyRuleTemplateSchema>;
+export type PolicyRule = z.infer<typeof PolicyRuleSchema>;
+export type PolicyStatusMapping = z.infer<typeof PolicyStatusMappingSchema>;
+export type PolicyEvaluationAudit = z.infer<typeof PolicyEvaluationAuditSchema>;
+//# sourceMappingURL=domain.schema.d.ts.map

package/dist/definitions/policies/domain.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"domain.schema.d.ts","sourceRoot":"","sources":["../../../src/definitions/policies/domain.schema.ts"],"names":[],"mappings":"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"}