@hasna/mementos 0.14.75 → 0.14.79

package/dist/project-registration/types.d.ts

@@ -0,0 +1,168 @@
+export declare const MEMENTOS_PROJECT_REGISTRATION_ROUTE: "mementos.project-registration.v1";
+export declare const MEMENTOS_PROJECT_REGISTRATION_CALLER_ROUTE: "projects.full-registration.v1";
+export declare const MEMENTOS_PROJECT_REGISTRATION_SCHEMA_VERSION: 1;
+export declare const MEMENTOS_PROJECT_GUARDED_UPDATE_ROUTE: "mementos.project-guarded-update.v1";
+export type MementosProjectRegistrationResourceKind = "project";
+export type MementosProjectRegistrationDirection = "forward" | "inverse";
+export type MementosProjectRegistrationOutcome = "accepted" | "duplicate_of_accepted" | "terminal_nonacceptance";
+export interface MementosProjectRegistrationBounds {
+    response_byte_limit: number;
+    time_budget_ms: number;
+}
+export interface MementosProjectRegistrationResponseControl extends MementosProjectRegistrationBounds {
+    response_bytes: number;
+    elapsed_ms: number;
+    complete: true;
+    truncated: false;
+}
+export interface MementosProjectRegistrationCapability {
+    authority: "mementos";
+    route: typeof MEMENTOS_PROJECT_REGISTRATION_ROUTE;
+    package_version: string;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    supported_resources: ["project"];
+    conditional_create: true;
+    immutable_receipts: true;
+    exact_terminal_lookup: true;
+    exact_readback: true;
+    conditional_inverse: true;
+    ambiguous_outcome_reconciliation: true;
+    guarded_update: true;
+    no_write_dry_run: true;
+    expected_revision_compare_and_swap: true;
+    caller_idempotency: true;
+    exact_inverse_rollback: true;
+}
+export interface MementosProjectRegistrationReceipt {
+    receipt_id: string;
+    authority: "mementos";
+    route: typeof MEMENTOS_PROJECT_REGISTRATION_ROUTE;
+    package_version: string;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    operation_id: string;
+    step_id: string;
+    resource_kind: "project";
+    direction: MementosProjectRegistrationDirection;
+    idempotency_key: string;
+    request_digest: string;
+    precondition_digest: string;
+    outcome: MementosProjectRegistrationOutcome;
+    reason: string | null;
+    target_id: string | null;
+    result_revision: string | null;
+    result_digest: string | null;
+    duplicate_of_receipt_id: string | null;
+    accepted_receipt_id: string | null;
+    created_by_operation: boolean;
+    created_at: string;
+}
+export interface MementosProjectRegistrationRecord {
+    target_id: string;
+    revision: string;
+    digest: string;
+}
+/**
+ * Structural handle implemented by @hasna/projects. The absolute path can be
+ * consumed by this authority but is never returned in a capability, receipt,
+ * lookup, or exact-read response.
+ */
+export interface MementosProjectRegistrationPathHandle {
+    withOwnedPath<T>(consumer: (absolutePath: string) => T): T;
+}
+export interface MementosProjectRegistrationRequest extends MementosProjectRegistrationBounds {
+    operation_id: string;
+    step_id: string;
+    resource_kind: "project";
+    direction: MementosProjectRegistrationDirection;
+    authority_route: string;
+    package_version: string;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    target_selector: string;
+    idempotency_key: string;
+    request_digest: string;
+    precondition_digest: string;
+    project_id: string;
+    project_slug: string;
+    project_name: string;
+    desired: Record<string, unknown>;
+    target: MementosProjectRegistrationPathHandle;
+    accepted_receipt?: MementosProjectRegistrationReceipt;
+}
+export interface MementosProjectRegistrationLookupRequest extends MementosProjectRegistrationBounds {
+    operation_id: string;
+    step_id: string;
+    resource_kind: "project";
+    direction: MementosProjectRegistrationDirection;
+    authority: "mementos";
+    authority_route: string;
+    package_version: string;
+    authority_id: string;
+    tenant_id: string;
+    corpus_id: string;
+    target_selector: string;
+    idempotency_key: string;
+    target_id?: string;
+    max_items: 1;
+}
+export interface MementosProjectRegistrationLookupResult {
+    receipt: MementosProjectRegistrationReceipt;
+    response_control: MementosProjectRegistrationResponseControl;
+}
+export interface MementosProjectRegistrationInverseVerification {
+    target_id: string;
+    accepted_receipt_id: string;
+    absent: true;
+    digest: string;
+}
+export interface MementosProjectRegistrationAuthority {
+    readonly authority: "mementos";
+    capability(): Promise<MementosProjectRegistrationCapability>;
+    create(request: MementosProjectRegistrationRequest): Promise<MementosProjectRegistrationReceipt>;
+    readExact(request: {
+        resource_kind: "project";
+        target_id: string;
+        target: MementosProjectRegistrationPathHandle;
+        response_byte_limit: number;
+        time_budget_ms: number;
+    }): Promise<MementosProjectRegistrationRecord>;
+    lookupReceipt(request: MementosProjectRegistrationLookupRequest): Promise<MementosProjectRegistrationLookupResult>;
+    compensate(request: MementosProjectRegistrationRequest): Promise<MementosProjectRegistrationReceipt>;
+    verifyInverse(request: MementosProjectRegistrationRequest): Promise<MementosProjectRegistrationInverseVerification>;
+}
+export type MementosProjectRegistrationFaultPoint = "before_object_write" | "after_object_write" | "before_receipt_write" | "after_receipt_write" | "after_commit";
+export interface MementosProjectRegistrationAuthorityOptions {
+    packageVersion?: string;
+    authorityId?: string;
+    tenantId?: string;
+    corpusId?: string;
+    now?: () => string;
+    faultInjector?: (point: MementosProjectRegistrationFaultPoint, context: {
+        operation_id: string;
+        step_id: string;
+        resource_kind: "project";
+        direction: MementosProjectRegistrationDirection;
+    }) => void;
+}
+export type MementosProjectRegistrationErrorCode = "MEMENTOS_PROJECT_REGISTRATION_INVALID_INPUT" | "MEMENTOS_PROJECT_REGISTRATION_INVALID_BOUNDS" | "MEMENTOS_PROJECT_REGISTRATION_RESPONSE_TOO_LARGE" | "MEMENTOS_PROJECT_REGISTRATION_TIME_BUDGET_EXCEEDED" | "MEMENTOS_PROJECT_REGISTRATION_CAPABILITY_MISMATCH" | "MEMENTOS_PROJECT_REGISTRATION_DIGEST_MISMATCH" | "MEMENTOS_PROJECT_REGISTRATION_IDEMPOTENCY_MISMATCH" | "MEMENTOS_PROJECT_REGISTRATION_EXACT_ID_REQUIRED" | "MEMENTOS_PROJECT_REGISTRATION_RECEIPT_NOT_FOUND" | "MEMENTOS_PROJECT_REGISTRATION_RECORD_NOT_FOUND" | "MEMENTOS_PROJECT_REGISTRATION_ACCEPTED_RECEIPT_NOT_FOUND" | "MEMENTOS_PROJECT_REGISTRATION_ATOMICITY_UNAVAILABLE" | "MEMENTOS_PROJECT_REGISTRATION_CONFLICT";
+export declare class MementosProjectRegistrationError extends Error {
+    readonly code: MementosProjectRegistrationErrorCode;
+    readonly details: Record<string, unknown>;
+    constructor(code: MementosProjectRegistrationErrorCode, message: string, details?: Record<string, unknown>);
+}
+export interface MementosProjectRegistrationHttpClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+    fetch?: typeof globalThis.fetch;
+    headers?: Record<string, string>;
+}
+/** Private wire request used only between the package-owned HTTP client/server. */
+export interface MementosProjectRegistrationWireRequest extends Omit<MementosProjectRegistrationRequest, "target"> {
+    canonical_path: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/project-registration/types.d.ts.map

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

package/dist/project-registration.d.ts

@@ -0,0 +1,2 @@
+export * from "./project-registration/index.js";
+//# sourceMappingURL=project-registration.d.ts.map

package/dist/project-registration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-registration.d.ts","sourceRoot":"","sources":["../src/project-registration.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAC"}