@layervai/qurl 0.6.0 → 2.0.0

package/dist/esm/crid.js.map

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

package/dist/esm/errors.d.ts

@@ -14,8 +14,18 @@ export declare const ERROR_CODE_UNEXPECTED_RESPONSE = "unexpected_response";
 export declare const ERROR_CODE_NETWORK = "network_error";
 export declare const ERROR_CODE_TIMEOUT = "timeout";
 export declare const ERROR_CODE_RUNTIME = "runtime_error";
+/** A share response omitted the CRID required for delivered-key verification. */
+export declare const ERROR_CODE_MISSING_CRID = "missing_crid";
+/** A held CRID failed the local CRID v1 validation gate. */
+export declare const ERROR_CODE_INVALID_CRID = "invalid_crid";
+/** A caller supplied a non-binary runtime value where DER SPKI bytes are required. */
+export declare const ERROR_CODE_INVALID_CRID_KEY = "invalid_crid_key";
+/** A delivered key does not derive the held CRID. */
+export declare const ERROR_CODE_CRID_MISMATCH = "crid_mismatch";
 /** A dispatched Connector resource mutation could have committed and must be reconciled. */
 export declare const ERROR_CODE_CONNECTOR_RESOURCE_OUTCOME_UNKNOWN = "connector_resource_outcome_unknown";
+/** A delegated batch create was dispatched but no valid acceptance was received. */
+export declare const ERROR_CODE_DELEGATED_BATCH_OUTCOME_UNKNOWN = "delegated_batch_outcome_unknown";
 /** A by-ID Connector resource lookup found a revoked lifecycle row. */
 export declare const ERROR_CODE_CONNECTOR_RESOURCE_REVOKED = "connector_resource_revoked";
 /** A Connector slug lookup found no active resource (client-detected, `status: 0`). */
@@ -28,8 +38,8 @@ export declare const ERROR_CODE_UNKNOWN = "unknown";
  * Base error thrown by the qURL API client. Catch this to handle all SDK errors.
  *
  * **`status: 0` convention:** Client-only validation, runtime, network, and
- * timeout failures use `status: 0` because no HTTP status applies. Logical
- * response-shape guards can also use zero. An `unexpected_response` tied to a
+ * timeout failures and local CRID verification failures use `status: 0`
+ * because no HTTP status applies. Logical response-shape guards can also use zero. An `unexpected_response` tied to a
  * concrete HTTP contract violation (redirect, oversized body, wrong
  * no-content status/body) instead preserves the observed status. Branch on
  * `.code` first and then `.status`; see {@link ValidationError}.
@@ -57,6 +67,8 @@ export declare class QURLError extends Error {
     readonly invalidFields?: Record<string, string>;
     readonly requestId?: string;
     readonly retryAfter?: number;
+    /** Known minted IDs from a rejected terminal batch, for bounded cleanup. No bearer links. */
+    readonly partialQurlIds?: readonly string[];
     constructor(data: QURLErrorData);
 }
 /** 401 Unauthorized — invalid or missing API key. */
@@ -84,9 +96,10 @@ export declare class NotFoundError extends QURLError {
  *
  * `instanceof ValidationError` catches both on ordinary client/response
  * paths. A Connector mutation wraps a post-dispatch `unexpected_response`
- * in {@link ConnectorResourceOutcomeUnknownError}; inspect that error's
- * typed `cause` before deciding whether to retry. To distinguish them, check
- * `.code` rather than using `instanceof` alone.
+ * in {@link ConnectorResourceOutcomeUnknownError} or
+ * {@link DelegatedBatchOutcomeUnknownError}; inspect the wrapper's typed
+ * `cause` before deciding whether to retry. To distinguish them, check `.code`
+ * rather than using `instanceof` alone.
  *
  * **`.status` asymmetry within `code: "unexpected_response"`:**
  * - Shape-guard failure on a parsed JSON body (wrong field types,
@@ -128,6 +141,18 @@ export declare class ConnectorResourceOutcomeUnknownError extends QURLError {
     readonly cause: QURLError;
     constructor(cause: QURLError);
 }
+/**
+ * A delegated batch create may have committed. Retry only with the same
+ * idempotency key and semantic body. The original typed failure is in `cause`.
+ * The wrapper uses `status: 0` so generic HTTP retry code cannot replay it.
+ */
+export declare class DelegatedBatchOutcomeUnknownError extends QURLError {
+    readonly code: typeof ERROR_CODE_DELEGATED_BATCH_OUTCOME_UNKNOWN;
+    readonly cause: QURLError;
+    /** Valid accepted batch identity, when the response body provided one. */
+    readonly batchId?: string;
+    constructor(cause: QURLError, batchId?: string);
+}
 /** Transport-level error — DNS failure, connection refused, etc. */
 export declare class NetworkError extends QURLError {
     constructor(message: string, options?: {

package/dist/esm/errors.d.ts.map

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

package/dist/esm/errors.js

@@ -13,8 +13,18 @@ export const ERROR_CODE_UNEXPECTED_RESPONSE = "unexpected_response";
 export const ERROR_CODE_NETWORK = "network_error";
 export const ERROR_CODE_TIMEOUT = "timeout";
 export const ERROR_CODE_RUNTIME = "runtime_error";
+/** A share response omitted the CRID required for delivered-key verification. */
+export const ERROR_CODE_MISSING_CRID = "missing_crid";
+/** A held CRID failed the local CRID v1 validation gate. */
+export const ERROR_CODE_INVALID_CRID = "invalid_crid";
+/** A caller supplied a non-binary runtime value where DER SPKI bytes are required. */
+export const ERROR_CODE_INVALID_CRID_KEY = "invalid_crid_key";
+/** A delivered key does not derive the held CRID. */
+export const ERROR_CODE_CRID_MISMATCH = "crid_mismatch";
 /** A dispatched Connector resource mutation could have committed and must be reconciled. */
 export const ERROR_CODE_CONNECTOR_RESOURCE_OUTCOME_UNKNOWN = "connector_resource_outcome_unknown";
+/** A delegated batch create was dispatched but no valid acceptance was received. */
+export const ERROR_CODE_DELEGATED_BATCH_OUTCOME_UNKNOWN = "delegated_batch_outcome_unknown";
 /** A by-ID Connector resource lookup found a revoked lifecycle row. */
 export const ERROR_CODE_CONNECTOR_RESOURCE_REVOKED = "connector_resource_revoked";
 /** A Connector slug lookup found no active resource (client-detected, `status: 0`). */
@@ -27,8 +37,8 @@ export const ERROR_CODE_UNKNOWN = "unknown";
  * Base error thrown by the qURL API client. Catch this to handle all SDK errors.
  *
  * **`status: 0` convention:** Client-only validation, runtime, network, and
- * timeout failures use `status: 0` because no HTTP status applies. Logical
- * response-shape guards can also use zero. An `unexpected_response` tied to a
+ * timeout failures and local CRID verification failures use `status: 0`
+ * because no HTTP status applies. Logical response-shape guards can also use zero. An `unexpected_response` tied to a
  * concrete HTTP contract violation (redirect, oversized body, wrong
  * no-content status/body) instead preserves the observed status. Branch on
  * `.code` first and then `.status`; see {@link ValidationError}.
@@ -56,6 +66,8 @@ export class QURLError extends Error {
     invalidFields;
     requestId;
     retryAfter;
+    /** Known minted IDs from a rejected terminal batch, for bounded cleanup. No bearer links. */
+    partialQurlIds;
     constructor(data) {
         // RFC 7807 leaves `detail` optional; the API can legitimately omit it and
         // `title` is required, so falling back to title keeps the Error.message
@@ -107,9 +119,10 @@ export class NotFoundError extends QURLError {
  *
  * `instanceof ValidationError` catches both on ordinary client/response
  * paths. A Connector mutation wraps a post-dispatch `unexpected_response`
- * in {@link ConnectorResourceOutcomeUnknownError}; inspect that error's
- * typed `cause` before deciding whether to retry. To distinguish them, check
- * `.code` rather than using `instanceof` alone.
+ * in {@link ConnectorResourceOutcomeUnknownError} or
+ * {@link DelegatedBatchOutcomeUnknownError}; inspect the wrapper's typed
+ * `cause` before deciding whether to retry. To distinguish them, check `.code`
+ * rather than using `instanceof` alone.
  *
  * **`.status` asymmetry within `code: "unexpected_response"`:**
  * - Shape-guard failure on a parsed JSON body (wrong field types,
@@ -179,6 +192,27 @@ export class ConnectorResourceOutcomeUnknownError extends QURLError {
         attachErrorCause(this, { cause });
     }
 }
+/**
+ * A delegated batch create may have committed. Retry only with the same
+ * idempotency key and semantic body. The original typed failure is in `cause`.
+ * The wrapper uses `status: 0` so generic HTTP retry code cannot replay it.
+ */
+export class DelegatedBatchOutcomeUnknownError extends QURLError {
+    /** Valid accepted batch identity, when the response body provided one. */
+    batchId;
+    constructor(cause, batchId) {
+        super({
+            status: 0,
+            code: ERROR_CODE_DELEGATED_BATCH_OUTCOME_UNKNOWN,
+            title: "Delegated Batch Outcome Unknown",
+            detail: `Mutation outcome is unknown; retry only with the same idempotency key and body. ${cause.detail}`,
+            request_id: cause.requestId,
+        });
+        this.name = "DelegatedBatchOutcomeUnknownError";
+        this.batchId = batchId;
+        attachErrorCause(this, { cause });
+    }
+}
 /** Transport-level error — DNS failure, connection refused, etc. */
 export class NetworkError extends QURLError {
     constructor(message, options) {

package/dist/esm/errors.js.map

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

package/dist/esm/index.d.ts

@@ -1,6 +1,8 @@
-export { ConnectorResource, ProtectedResource, QURLClient } from "./client.js";
+export { ConnectorResource, isApiKeyRequestScope, ProtectedResource, QURLClient, } from "./client.js";
 export type { EnsureConnectorResourceResult } from "./client.js";
-export { AuthenticationError, AuthorizationError, ConnectorResourceOutcomeUnknownError, createError, ERROR_CODE_AMBIGUOUS_RESOURCE, ERROR_CODE_CLIENT_VALIDATION, ERROR_CODE_CONNECTOR_RESOURCE_OUTCOME_UNKNOWN, ERROR_CODE_CONNECTOR_RESOURCE_REVOKED, ERROR_CODE_NETWORK, ERROR_CODE_RESOURCE_NOT_FOUND, ERROR_CODE_RUNTIME, ERROR_CODE_TIMEOUT, ERROR_CODE_UNEXPECTED_RESPONSE, ERROR_CODE_UNKNOWN, NetworkError, NotFoundError, QURLError, RateLimitError, RuntimeError, ServerError, TimeoutError, ValidationError, } from "./errors.js";
+export { CRIDVerificationError, ShareLink } from "./share.js";
+export type { CRIDVerificationErrorCode, ShareLinkInit, ShareLinkJSON } from "./share.js";
+export { AuthenticationError, AuthorizationError, ConnectorResourceOutcomeUnknownError, createError, DelegatedBatchOutcomeUnknownError, ERROR_CODE_AMBIGUOUS_RESOURCE, ERROR_CODE_CLIENT_VALIDATION, ERROR_CODE_CONNECTOR_RESOURCE_OUTCOME_UNKNOWN, ERROR_CODE_CONNECTOR_RESOURCE_REVOKED, ERROR_CODE_CRID_MISMATCH, ERROR_CODE_DELEGATED_BATCH_OUTCOME_UNKNOWN, ERROR_CODE_INVALID_CRID, ERROR_CODE_INVALID_CRID_KEY, ERROR_CODE_MISSING_CRID, ERROR_CODE_NETWORK, ERROR_CODE_RESOURCE_NOT_FOUND, ERROR_CODE_RUNTIME, ERROR_CODE_TIMEOUT, ERROR_CODE_UNEXPECTED_RESPONSE, ERROR_CODE_UNKNOWN, NetworkError, NotFoundError, QURLError, RateLimitError, RuntimeError, ServerError, TimeoutError, ValidationError, } from "./errors.js";
 export { VERSION } from "./version.js";
-export type { AccessCode, AccessCodeListOutput, AccessGrant, AccessPolicy, AccessToken, AIAgentCategory, AIAgentPolicy, ApiKey, ApiKeyListOutput, ApiKeyScope, BatchCreateInput, BatchCreateOutput, BatchItemFailure, BatchItemResult, BatchItemSuccess, BillingInvoiceListOutput, ClientOptions, ConnectorInstallation, ConnectorInstallationCapabilities, ConnectorInstallationListOutput, ConnectorInstallationStats, CreateAccessCodeInput, CreateAccessCodeOutput, CreateApiKeyInput, CreateApiKeyOutput, CreateBillingCheckoutInput, CreateInput, CreateOutput, CreatePortalOptions, CreateQurlForResourceInput, CreateResourceInput, CreateWebhookInput, Customer, CheckoutSession, DnsRecord, Domain, DomainCheckDetail, DomainListOutput, DomainVerifyResult, ExtendInput, Invoice, ListApiKeysInput, ListBillingInvoicesInput, ListConnectorInstallationsInput, ListDomainsInput, ListInput, ListOutput, ListWebhooksInput, ListWebhookDeliveriesInput, Meta, MintInput, MintOutput, PaginatedOutput, Portal, PortalSession, ProtectUrlOptions, QURL, QURLErrorData, QurlSummary, Quota, RedeemAccessCodeInput, RedeemAccessCodeOutput, RegisterDomainInput, Resource, ResourceDetail, ResourceHandle, ResourceListInput, ResourceListOutput, ResourceType, RequestOptions, ResolveInput, ResolveOutput, Session, SessionListOutput, SessionTerminateOutput, TombstoneInfo, UnpaginatedOutput, UpdateApiKeyInput, UpdateCustomerInput, UpdateInput, UpdateResourceInput, UpdateResourceQurlInput, UpdateWebhookInput, UsageCostEstimate, UsageCurrentPeriod, UsageDaily, UsageDailyEntry, Webhook, WebhookDelivery, WebhookDeliveryListOutput, WebhookEventType, WebhookEventTypeInfo, WebhookListOutput, WebhookPayload, WebhookWithSecret, } from "./types.js";
+export type { AccessCode, AccessCodeListOutput, AccessGrant, AccessPolicy, AccessToken, AIAgentCategory, AIAgentPolicy, ApiKey, ApiKeyListOutput, ApiKeyRequestScope, ApiKeyScope, BatchCreateInput, BatchCreateOutput, BatchItemFailure, BatchItemResult, BatchItemSuccess, BillingInvoiceListOutput, ClientOptions, ConnectorInstallation, ConnectorInstallationCapabilities, ConnectorInstallationListOutput, ConnectorInstallationStats, CreateAccessCodeInput, CreateAccessCodeOutput, CreateApiKeyInput, CreateApiKeyOutput, CreateDurableApiKeyInput, CreateEnrollmentTokenInput, CreateBillingCheckoutInput, CreateDelegatedQurlBatchInput, CreateDelegatedQurlBatchOptions, CreateInput, CreateOutput, CreatePortalOptions, CreateQurlForResourceInput, CreateResourceInput, CreateWebhookInput, CredentialClaim, CredentialClaimInput, CredentialKind, CredentialTarget, CredentialTargetInput, Customer, CheckoutSession, DnsRecord, Domain, DomainCheckDetail, DomainListOutput, DomainVerifyResult, DelegatedQurl, DelegatedQurlBatchAccepted, DelegatedQurlBatchItemFailure, DelegatedQurlBatchItemResult, DelegatedQurlBatchItemSuccess, DelegatedQurlBatchNotModified, DelegatedQurlBatchPending, DelegatedQurlBatchStatus, DelegatedQurlBatchTerminal, DelegatedQurlCreatedData, DelegatedQurlGrant, ExtendInput, Invoice, GetDelegatedQurlBatchOptions, GetDelegatedQurlBatchOutput, ListApiKeysInput, ListBillingInvoicesInput, ListConnectorInstallationsInput, ListDomainsInput, ListInput, ListOutput, ListWebhooksInput, ListWebhookDeliveriesInput, Meta, MintInput, MintOutput, PaginatedOutput, Portal, PortalSession, ProtectUrlOptions, QURL, QURLErrorData, QurlSummary, Quota, RedeemAccessCodeInput, RedeemAccessCodeOutput, RegisterDomainInput, Resource, ResourceDetail, ResourceHandle, ResourceListInput, ResourceListOutput, ResourceType, RequestOptions, ResolveInput, ResolveOutput, Session, SessionListOutput, SessionTerminateOutput, ShareResourceOptions, TombstoneInfo, UnpaginatedOutput, UpdateApiKeyInput, UpdateCustomerInput, UpdateInput, UpdateResourceInput, UpdateResourceQurlInput, UpdateWebhookInput, UsageCostEstimate, UsageCurrentPeriod, UsageDaily, UsageDailyEntry, Webhook, WebhookDelivery, WebhookDeliveryListOutput, WebhookEventType, WebhookEventTypeInfo, WebhookListOutput, WebhookPayload, WebhookWithSecret, } from "./types.js";
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC/E,YAAY,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,WAAW,EACX,6BAA6B,EAC7B,4BAA4B,EAC5B,6CAA6C,EAC7C,qCAAqC,EACrC,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACvC,YAAY,EACV,UAAU,EACV,oBAAoB,EACpB,WAAW,EACX,YAAY,EACZ,WAAW,EACX,eAAe,EACf,aAAa,EACb,MAAM,EACN,gBAAgB,EAChB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,aAAa,EACb,qBAAqB,EACrB,iCAAiC,EACjC,+BAA+B,EAC/B,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,0BAA0B,EAC1B,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,0BAA0B,EAC1B,mBAAmB,EACnB,kBAAkB,EAClB,QAAQ,EACR,eAAe,EACf,SAAS,EACT,MAAM,EACN,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,OAAO,EACP,gBAAgB,EAChB,wBAAwB,EACxB,+BAA+B,EAC/B,gBAAgB,EAChB,SAAS,EACT,UAAU,EACV,iBAAiB,EACjB,0BAA0B,EAC1B,IAAI,EACJ,SAAS,EACT,UAAU,EACV,eAAe,EACf,MAAM,EACN,aAAa,EACb,iBAAiB,EACjB,IAAI,EACJ,aAAa,EACb,WAAW,EACX,KAAK,EACL,qBAAqB,EACrB,sBAAsB,EACtB,mBAAmB,EACnB,QAAQ,EACR,cAAc,EACd,cAAc,EACd,iBAAiB,EACjB,kBAAkB,EAClB,YAAY,EACZ,cAAc,EACd,YAAY,EACZ,aAAa,EACb,OAAO,EACP,iBAAiB,EACjB,sBAAsB,EACtB,aAAa,EACb,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,WAAW,EACX,mBAAmB,EACnB,uBAAuB,EACvB,kBAAkB,EAClB,iBAAiB,EACjB,kBAAkB,EAClB,UAAU,EACV,eAAe,EACf,OAAO,EACP,eAAe,EACf,yBAAyB,EACzB,gBAAgB,EAChB,oBAAoB,EACpB,iBAAiB,EACjB,cAAc,EACd,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.js

@@ -1,4 +1,5 @@
-export { ConnectorResource, ProtectedResource, QURLClient } from "./client.js";
-export { AuthenticationError, AuthorizationError, ConnectorResourceOutcomeUnknownError, createError, ERROR_CODE_AMBIGUOUS_RESOURCE, ERROR_CODE_CLIENT_VALIDATION, ERROR_CODE_CONNECTOR_RESOURCE_OUTCOME_UNKNOWN, ERROR_CODE_CONNECTOR_RESOURCE_REVOKED, ERROR_CODE_NETWORK, ERROR_CODE_RESOURCE_NOT_FOUND, ERROR_CODE_RUNTIME, ERROR_CODE_TIMEOUT, ERROR_CODE_UNEXPECTED_RESPONSE, ERROR_CODE_UNKNOWN, NetworkError, NotFoundError, QURLError, RateLimitError, RuntimeError, ServerError, TimeoutError, ValidationError, } from "./errors.js";
+export { ConnectorResource, isApiKeyRequestScope, ProtectedResource, QURLClient, } from "./client.js";
+export { CRIDVerificationError, ShareLink } from "./share.js";
+export { AuthenticationError, AuthorizationError, ConnectorResourceOutcomeUnknownError, createError, DelegatedBatchOutcomeUnknownError, ERROR_CODE_AMBIGUOUS_RESOURCE, ERROR_CODE_CLIENT_VALIDATION, ERROR_CODE_CONNECTOR_RESOURCE_OUTCOME_UNKNOWN, ERROR_CODE_CONNECTOR_RESOURCE_REVOKED, ERROR_CODE_CRID_MISMATCH, ERROR_CODE_DELEGATED_BATCH_OUTCOME_UNKNOWN, ERROR_CODE_INVALID_CRID, ERROR_CODE_INVALID_CRID_KEY, ERROR_CODE_MISSING_CRID, ERROR_CODE_NETWORK, ERROR_CODE_RESOURCE_NOT_FOUND, ERROR_CODE_RUNTIME, ERROR_CODE_TIMEOUT, ERROR_CODE_UNEXPECTED_RESPONSE, ERROR_CODE_UNKNOWN, NetworkError, NotFoundError, QURLError, RateLimitError, RuntimeError, ServerError, TimeoutError, ValidationError, } from "./errors.js";
 export { VERSION } from "./version.js";
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE/E,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,WAAW,EACX,6BAA6B,EAC7B,4BAA4B,EAC5B,6CAA6C,EAC7C,qCAAqC,EACrC,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,qBAAqB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE9D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,oCAAoC,EACpC,WAAW,EACX,iCAAiC,EACjC,6BAA6B,EAC7B,4BAA4B,EAC5B,6CAA6C,EAC7C,qCAAqC,EACrC,wBAAwB,EACxB,0CAA0C,EAC1C,uBAAuB,EACvB,2BAA2B,EAC3B,uBAAuB,EACvB,kBAAkB,EAClB,6BAA6B,EAC7B,kBAAkB,EAClB,kBAAkB,EAClB,8BAA8B,EAC9B,kBAAkB,EAClB,YAAY,EACZ,aAAa,EACb,SAAS,EACT,cAAc,EACd,YAAY,EACZ,WAAW,EACX,YAAY,EACZ,eAAe,GAChB,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/esm/node/agent-runtime.d.ts

@@ -0,0 +1,109 @@
+import { QURLClient } from "../client.js";
+import { type StrictJsonValue } from "./strict-json.js";
+import { type AgentAssignment, type AgentState, type AgentStateStore, type NHPUDPEndpoint } from "./agent-state.js";
+import { type AgentTransport } from "./agent-transport.js";
+export interface AgentOTPChallenge {
+    agentID: string;
+    cellID: string;
+    assignmentTicketExpiresAt: string;
+    pendingActivationRecovery: boolean;
+}
+export interface AgentRuntimeOptions {
+    hub?: NHPUDPEndpoint;
+    agentID?: string;
+    enrollmentCredential?: string;
+    enrollmentCredentialProvider?: (request: {
+        agentID: string;
+        pendingActivationRecovery: boolean;
+    }, signal: AbortSignal) => Promise<string>;
+    otpProvider?: (challenge: AgentOTPChallenge, signal: AbortSignal) => Promise<string>;
+    headless?: boolean;
+    offline?: boolean;
+    hostname?: string;
+    version?: string;
+    signal?: AbortSignal;
+    baseUrl?: string;
+    fetch?: typeof globalThis.fetch;
+}
+export declare class AgentLifecycleError extends Error {
+    readonly code: string;
+    readonly retryAfterMs?: number | undefined;
+    constructor(code: string, retryAfterMs?: number | undefined, options?: ErrorOptions);
+}
+declare function fingerprint(kind: "activation-enrollment" | "credential-recovery", credential: string): string;
+/** One driver per producer operation. Persistence failures never enter the network retry loop. */
+declare class Lifecycle {
+    readonly store: AgentStateStore;
+    readonly options: AgentRuntimeOptions;
+    readonly transport: AgentTransport;
+    readonly replacement?: {
+        anchor: string;
+        deadline: string;
+    } | undefined;
+    constructor(store: AgentStateStore, options: AgentRuntimeOptions, transport: AgentTransport, replacement?: {
+        anchor: string;
+        deadline: string;
+    } | undefined);
+    hub(): NHPUDPEndpoint;
+    exchange(state: AgentState, endpoint: NHPUDPEndpoint, type: 1 | 5 | 12 | 13 | 16, value: unknown, phase: "assignment" | "assignment-refresh" | "registration" | "completion" | "recovery-issue" | "recovery-completion" | "session", expires?: string, reknock?: unknown, detachedSignal?: AbortSignal): Promise<Record<string, StrictJsonValue>>;
+    assignment(state: AgentState, mode: "enroll" | "refresh", enrollment?: string): Promise<{
+        list: Record<string, StrictJsonValue>;
+        assignment: AgentAssignment;
+    }>;
+    refresh(state: AgentState, allowRecovered?: boolean): Promise<AgentState>;
+    complete(state: AgentState): Promise<AgentState>;
+    enroll(state: AgentState): Promise<AgentState>;
+}
+export interface NativeAgentKnockOptions {
+    runID: string;
+    runAttempt: bigint;
+    protectedResourceID: string;
+    signal?: AbortSignal;
+}
+export interface NativeSessionReceipt {
+    readonly cellID: string;
+    readonly sessionID: bigint;
+    readonly sessionIssuedAtMillis: bigint;
+    readonly runID: string;
+    readonly runAttempt: bigint;
+}
+export interface NativeAgentGrant {
+    token: string;
+    resourceHost: string;
+    openTime: number;
+    agentAddress: string;
+    receipt: NativeSessionReceipt;
+}
+export declare class AgentRuntime {
+    #private;
+    readonly store: AgentStateStore;
+    readonly transport: AgentTransport;
+    readonly client: QURLClient;
+    constructor(state: AgentState, store: AgentStateStore, options: AgentRuntimeOptions, transport: AgentTransport);
+    get agentID(): string;
+    assignment(): AgentAssignment;
+    refresh(signal?: AbortSignal): Promise<void>;
+    knock(knockResourceID: string, options: NativeAgentKnockOptions): Promise<NativeAgentGrant>;
+    retire(receipt: NativeSessionReceipt, signal?: AbortSignal): Promise<{
+        closeEventID: string;
+        state: "closing" | "closed";
+    }>;
+    close(): Promise<void>;
+    toJSON(): {
+        agentID: string | undefined;
+        closed: boolean;
+    };
+}
+export declare function connectAgentRuntime(store: AgentStateStore, options?: AgentRuntimeOptions): Promise<AgentRuntime>;
+export type AgentRecoveryOptions = Pick<AgentRuntimeOptions, "hub" | "agentID" | "signal" | "baseUrl" | "fetch">;
+export declare function recoverAgentRuntime(store: AgentStateStore, recoveryCredential: string | ((signal: AbortSignal) => Promise<string>), options?: AgentRecoveryOptions): Promise<AgentRuntime>;
+declare function recoverWithTransport(store: AgentStateStore, provider: string | ((signal: AbortSignal) => Promise<string>), options: AgentRecoveryOptions, transport: AgentTransport): Promise<AgentRuntime>;
+declare function connectWithTransport(store: AgentStateStore, options: AgentRuntimeOptions, transport: AgentTransport): Promise<AgentRuntime>;
+export declare const agentRuntimeTesting: {
+    connectWithTransport: typeof connectWithTransport;
+    recoverWithTransport: typeof recoverWithTransport;
+    Lifecycle: typeof Lifecycle;
+    fingerprint: typeof fingerprint;
+};
+export {};
+//# sourceMappingURL=agent-runtime.d.ts.map

package/dist/esm/node/agent-runtime.d.ts.map

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