@devtrack-solution/codesdd 1.2.3 → 1.2.4

package/dist/core/sdd/artifact-id-allocator.d.ts

@@ -0,0 +1,368 @@
+import { z } from 'zod';
+export declare const artifactIdAllocatorTypeSchema: z.ZodEnum<{
+    INS: "INS";
+    DEB: "DEB";
+    EPIC: "EPIC";
+    FEAT: "FEAT";
+    FGAP: "FGAP";
+    TD: "TD";
+}>;
+export type ArtifactIdAllocatorType = z.infer<typeof artifactIdAllocatorTypeSchema>;
+export declare const allocatorActorSchema: z.ZodObject<{
+    agent_id: z.ZodString;
+    agent_kind: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const artifactIdReserveRequestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    artifact_type: z.ZodEnum<{
+        INS: "INS";
+        DEB: "DEB";
+        EPIC: "EPIC";
+        FEAT: "FEAT";
+        FGAP: "FGAP";
+        TD: "TD";
+    }>;
+    title_canonical: z.ZodOptional<z.ZodString>;
+    origin_ref: z.ZodOptional<z.ZodString>;
+    requested_by: z.ZodObject<{
+        agent_id: z.ZodString;
+        agent_kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    client_request_id: z.ZodOptional<z.ZodString>;
+    idempotency_key: z.ZodString;
+}, z.core.$strip>;
+export type ArtifactIdReserveRequest = z.infer<typeof artifactIdReserveRequestSchema>;
+export declare const artifactIdReservationSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    artifact_id: z.ZodString;
+    artifact_type: z.ZodEnum<{
+        INS: "INS";
+        DEB: "DEB";
+        EPIC: "EPIC";
+        FEAT: "FEAT";
+        FGAP: "FGAP";
+        TD: "TD";
+    }>;
+    sequence: z.ZodNumber;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    idempotency_key: z.ZodString;
+    request_fingerprint: z.ZodString;
+    revision: z.ZodNumber;
+    reserved_at: z.ZodString;
+}, z.core.$strip>;
+export type ArtifactIdReservation = z.infer<typeof artifactIdReservationSchema>;
+export declare const artifactIdReserveResponseSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    status: z.ZodEnum<{
+        reserved: "reserved";
+        replayed: "replayed";
+    }>;
+    reservation: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        artifact_id: z.ZodString;
+        artifact_type: z.ZodEnum<{
+            INS: "INS";
+            DEB: "DEB";
+            EPIC: "EPIC";
+            FEAT: "FEAT";
+            FGAP: "FGAP";
+            TD: "TD";
+        }>;
+        sequence: z.ZodNumber;
+        project_id: z.ZodString;
+        tenant_id: z.ZodOptional<z.ZodString>;
+        idempotency_key: z.ZodString;
+        request_fingerprint: z.ZodString;
+        revision: z.ZodNumber;
+        reserved_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ArtifactIdReserveResponse = z.infer<typeof artifactIdReserveResponseSchema>;
+export declare const artifactAllocatorLeaseRequestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    artifact_type: z.ZodEnum<{
+        INS: "INS";
+        DEB: "DEB";
+        EPIC: "EPIC";
+        FEAT: "FEAT";
+        FGAP: "FGAP";
+        TD: "TD";
+    }>;
+    holder: z.ZodObject<{
+        agent_id: z.ZodString;
+        agent_kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    ttl_ms: z.ZodNumber;
+    idempotency_key: z.ZodString;
+}, z.core.$strip>;
+export type ArtifactAllocatorLeaseRequest = z.infer<typeof artifactAllocatorLeaseRequestSchema>;
+export declare const artifactAllocatorLeaseSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    lease_id: z.ZodString;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    artifact_type: z.ZodEnum<{
+        INS: "INS";
+        DEB: "DEB";
+        EPIC: "EPIC";
+        FEAT: "FEAT";
+        FGAP: "FGAP";
+        TD: "TD";
+    }>;
+    holder: z.ZodObject<{
+        agent_id: z.ZodString;
+        agent_kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    fencing_token: z.ZodNumber;
+    idempotency_key: z.ZodString;
+    request_fingerprint: z.ZodString;
+    acquired_at: z.ZodString;
+    expires_at: z.ZodString;
+}, z.core.$strip>;
+export type ArtifactAllocatorLease = z.infer<typeof artifactAllocatorLeaseSchema>;
+export declare const artifactAllocatorLeaseResponseSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    status: z.ZodEnum<{
+        replayed: "replayed";
+        acquired: "acquired";
+    }>;
+    lease: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        lease_id: z.ZodString;
+        project_id: z.ZodString;
+        tenant_id: z.ZodOptional<z.ZodString>;
+        artifact_type: z.ZodEnum<{
+            INS: "INS";
+            DEB: "DEB";
+            EPIC: "EPIC";
+            FEAT: "FEAT";
+            FGAP: "FGAP";
+            TD: "TD";
+        }>;
+        holder: z.ZodObject<{
+            agent_id: z.ZodString;
+            agent_kind: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        fencing_token: z.ZodNumber;
+        idempotency_key: z.ZodString;
+        request_fingerprint: z.ZodString;
+        acquired_at: z.ZodString;
+        expires_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type ArtifactAllocatorLeaseResponse = z.infer<typeof artifactAllocatorLeaseResponseSchema>;
+export declare const artifactAllocatorAuditEventSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    event_id: z.ZodString;
+    event_type: z.ZodEnum<{
+        lease_acquired: "lease_acquired";
+        lease_replayed: "lease_replayed";
+        lease_conflict: "lease_conflict";
+        reservation_created: "reservation_created";
+        reservation_replayed: "reservation_replayed";
+        canonical_write_committed: "canonical_write_committed";
+        canonical_write_replayed: "canonical_write_replayed";
+        canonical_write_rejected: "canonical_write_rejected";
+    }>;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    artifact_type: z.ZodEnum<{
+        INS: "INS";
+        DEB: "DEB";
+        EPIC: "EPIC";
+        FEAT: "FEAT";
+        FGAP: "FGAP";
+        TD: "TD";
+    }>;
+    actor: z.ZodObject<{
+        agent_id: z.ZodString;
+        agent_kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    idempotency_key: z.ZodString;
+    lease_id: z.ZodOptional<z.ZodString>;
+    fencing_token: z.ZodOptional<z.ZodNumber>;
+    occurred_at: z.ZodString;
+    result: z.ZodEnum<{
+        blocked: "blocked";
+        accepted: "accepted";
+        replayed: "replayed";
+    }>;
+}, z.core.$strip>;
+export type ArtifactAllocatorAuditEvent = z.infer<typeof artifactAllocatorAuditEventSchema>;
+export declare const canonicalArtifactWriteRequestSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    artifact_id: z.ZodString;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    actor: z.ZodObject<{
+        agent_id: z.ZodString;
+        agent_kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    lease_id: z.ZodString;
+    fencing_token: z.ZodNumber;
+    expected_revision: z.ZodNumber;
+    idempotency_key: z.ZodString;
+}, z.core.$strip>;
+export type CanonicalArtifactWriteRequest = z.infer<typeof canonicalArtifactWriteRequestSchema>;
+export declare const canonicalArtifactWriteRecordSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    artifact_id: z.ZodString;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    revision: z.ZodNumber;
+    previous_revision: z.ZodNumber;
+    lease_id: z.ZodString;
+    fencing_token: z.ZodNumber;
+    idempotency_key: z.ZodString;
+    request_fingerprint: z.ZodString;
+    committed_at: z.ZodString;
+}, z.core.$strip>;
+export type CanonicalArtifactWriteRecord = z.infer<typeof canonicalArtifactWriteRecordSchema>;
+export declare const canonicalArtifactWriteResponseSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    status: z.ZodEnum<{
+        replayed: "replayed";
+        committed: "committed";
+    }>;
+    write: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        artifact_id: z.ZodString;
+        project_id: z.ZodString;
+        tenant_id: z.ZodOptional<z.ZodString>;
+        revision: z.ZodNumber;
+        previous_revision: z.ZodNumber;
+        lease_id: z.ZodString;
+        fencing_token: z.ZodNumber;
+        idempotency_key: z.ZodString;
+        request_fingerprint: z.ZodString;
+        committed_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type CanonicalArtifactWriteResponse = z.infer<typeof canonicalArtifactWriteResponseSchema>;
+export declare const noncanonicalDraftSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    draft_id: z.ZodString;
+    artifact_type: z.ZodEnum<{
+        INS: "INS";
+        DEB: "DEB";
+        EPIC: "EPIC";
+        FEAT: "FEAT";
+        FGAP: "FGAP";
+        TD: "TD";
+    }>;
+    project_id: z.ZodString;
+    tenant_id: z.ZodOptional<z.ZodString>;
+    title_canonical: z.ZodString;
+    created_by: z.ZodObject<{
+        agent_id: z.ZodString;
+        agent_kind: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    created_at: z.ZodString;
+    converted_artifact_id: z.ZodOptional<z.ZodString>;
+    converted_at: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type NoncanonicalDraft = z.infer<typeof noncanonicalDraftSchema>;
+export declare const draftConversionResponseSchema: z.ZodObject<{
+    schema_version: z.ZodLiteral<1>;
+    status: z.ZodEnum<{
+        converted: "converted";
+        replayed: "replayed";
+    }>;
+    draft: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        draft_id: z.ZodString;
+        artifact_type: z.ZodEnum<{
+            INS: "INS";
+            DEB: "DEB";
+            EPIC: "EPIC";
+            FEAT: "FEAT";
+            FGAP: "FGAP";
+            TD: "TD";
+        }>;
+        project_id: z.ZodString;
+        tenant_id: z.ZodOptional<z.ZodString>;
+        title_canonical: z.ZodString;
+        created_by: z.ZodObject<{
+            agent_id: z.ZodString;
+            agent_kind: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        created_at: z.ZodString;
+        converted_artifact_id: z.ZodOptional<z.ZodString>;
+        converted_at: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    reservation: z.ZodObject<{
+        schema_version: z.ZodLiteral<1>;
+        artifact_id: z.ZodString;
+        artifact_type: z.ZodEnum<{
+            INS: "INS";
+            DEB: "DEB";
+            EPIC: "EPIC";
+            FEAT: "FEAT";
+            FGAP: "FGAP";
+            TD: "TD";
+        }>;
+        sequence: z.ZodNumber;
+        project_id: z.ZodString;
+        tenant_id: z.ZodOptional<z.ZodString>;
+        idempotency_key: z.ZodString;
+        request_fingerprint: z.ZodString;
+        revision: z.ZodNumber;
+        reserved_at: z.ZodString;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type DraftConversionResponse = z.infer<typeof draftConversionResponseSchema>;
+export interface ArtifactIdAllocatorState {
+    counters: Partial<Record<ArtifactIdAllocatorType, number>>;
+    reservations: ArtifactIdReservation[];
+    leases: ArtifactAllocatorLease[];
+    audit_log: ArtifactAllocatorAuditEvent[];
+    next_fencing_token: number;
+    canonical_revisions: Record<string, number>;
+    canonical_writes: CanonicalArtifactWriteRecord[];
+    drafts: NoncanonicalDraft[];
+}
+export declare function createEmptyArtifactIdAllocatorState(): ArtifactIdAllocatorState;
+export declare function buildArtifactIdAllocatorIdempotencyKey(input: Omit<ArtifactIdReserveRequest, 'schema_version' | 'idempotency_key'>): string;
+export declare function reserveArtifactId(state: ArtifactIdAllocatorState, requestInput: ArtifactIdReserveRequest, options?: {
+    now?: string;
+}): ArtifactIdReserveResponse;
+export declare function acquireArtifactAllocatorLease(state: ArtifactIdAllocatorState, requestInput: ArtifactAllocatorLeaseRequest, options?: {
+    now?: string;
+}): ArtifactAllocatorLeaseResponse;
+export declare function isAllocatorLeaseActive(lease: ArtifactAllocatorLease, now: string): boolean;
+export declare function validateAllocatorFencingToken(lease: ArtifactAllocatorLease, input: {
+    fencing_token: number;
+    now: string;
+}): {
+    valid: boolean;
+    reason: 'valid' | 'expired' | 'stale-token';
+};
+export declare function commitCanonicalArtifactWrite(state: ArtifactIdAllocatorState, requestInput: CanonicalArtifactWriteRequest, options?: {
+    now?: string;
+}): CanonicalArtifactWriteResponse;
+export declare function createNoncanonicalDraft(state: ArtifactIdAllocatorState, input: {
+    project_id: string;
+    tenant_id?: string;
+    artifact_type: ArtifactIdAllocatorType;
+    title_canonical: string;
+    created_by: z.infer<typeof allocatorActorSchema>;
+}, options?: {
+    now?: string;
+}): NoncanonicalDraft;
+export declare function convertDraftToCanonicalArtifact(state: ArtifactIdAllocatorState, input: {
+    draft_id: string;
+    reservation: ArtifactIdReservation;
+    converted_by: z.infer<typeof allocatorActorSchema>;
+}, options?: {
+    now?: string;
+}): DraftConversionResponse;
+export declare function buildReserveRequestFingerprint(request: ArtifactIdReserveRequest): string;
+export declare function buildArtifactAllocatorLeaseIdempotencyKey(input: Omit<ArtifactAllocatorLeaseRequest, 'schema_version' | 'idempotency_key'>): string;
+export declare function buildLeaseRequestFingerprint(request: ArtifactAllocatorLeaseRequest): string;
+export declare function buildCanonicalWriteRequestFingerprint(request: CanonicalArtifactWriteRequest): string;
+//# sourceMappingURL=artifact-id-allocator.d.ts.map