@cross-deck/node 1.1.1 → 1.3.1

package/dist/index.d.mts

@@ -1,6 +1,25 @@
-export { A as AliasIdentityInput, a as AliasResult, b as AuditDecision, c as AuditEntry, B as Breadcrumb, d as BreadcrumbCategory, e as BreadcrumbLevel, C as CROSSDECK_API_VERSION, f as CapturedError, g as CrossdeckAuthenticationError, h as CrossdeckConfigurationError, i as CrossdeckError, j as CrossdeckErrorPayload, k as CrossdeckErrorType, l as CrossdeckInternalError, m as CrossdeckNetworkError, n as CrossdeckPermissionError, o as CrossdeckRateLimitError, p as CrossdeckServer, q as CrossdeckServerOptions, r as CrossdeckValidationError, D as DEFAULT_BASE_URL, s as DEFAULT_TIMEOUT_MS, t as Diagnostics, E as EntitlementCacheOptions, u as EntitlementMutationResult, v as EntitlementsListResponse, w as EntitlementsListener, x as Environment, y as ErrorCaptureConfig, z as ErrorLevel, F as EventProperties, G as ForgetResult, H as GrantDuration, I as GrantEntitlementInput, J as GroupMembership, K as HeartbeatResponse, L as HttpRequestInfo, M as HttpResponseInfo, N as HttpRetriesConfig, O as IdentifyOptions, P as IdentityHints, Q as IngestOptions, R as IngestResponse, S as PublicEntitlement, T as PurchaseResult, U as RequestOptions, V as RevokeEntitlementInput, W as RuntimeHost, X as RuntimeInfo, Y as SDK_NAME, Z as SDK_VERSION, _ as ServerEvent, $ as StackFrame, a0 as SyncPurchaseInput, a1 as makeCrossdeckError } from './crossdeck-server-BXQaFjVx.mjs';
+export { A as AliasIdentityInput, a as AliasResult, b as AuditDecision, c as AuditEntry, B as Breadcrumb, d as BreadcrumbCategory, e as BreadcrumbLevel, C as CROSSDECK_API_VERSION, f as CapturedError, g as CrossdeckAuthenticationError, h as CrossdeckConfigurationError, i as CrossdeckError, j as CrossdeckErrorPayload, k as CrossdeckErrorType, l as CrossdeckInternalError, m as CrossdeckNetworkError, n as CrossdeckPermissionError, o as CrossdeckRateLimitError, p as CrossdeckServer, q as CrossdeckServerOptions, r as CrossdeckValidationError, D as DEFAULT_BASE_URL, s as DEFAULT_TIMEOUT_MS, t as Diagnostics, E as EntitlementCacheOptions, u as EntitlementMutationResult, v as EntitlementStore, w as EntitlementsListResponse, x as EntitlementsListener, y as Environment, z as ErrorCaptureConfig, F as ErrorLevel, G as EventProperties, H as ForgetResult, I as GrantDuration, J as GrantEntitlementInput, K as GroupMembership, L as HeartbeatResponse, M as HttpRequestInfo, N as HttpResponseInfo, O as HttpRetriesConfig, P as IdentifyOptions, Q as IdentityHints, R as IngestOptions, S as IngestResponse, T as PublicEntitlement, U as PurchaseResult, V as RequestOptions, W as RevokeEntitlementInput, X as RuntimeHost, Y as RuntimeInfo, Z as ServerEvent, _ as StackFrame, $ as StoredEntitlements, a0 as SyncPurchaseInput, a1 as makeCrossdeckError } from './crossdeck-server-DhnHvUhh.mjs';
 import 'node:events';
 
+/**
+ * SDK version constant — generated by `scripts/sync-sdk-versions.mjs`.
+ *
+ * Single source of truth: the `version` field in this package's
+ * package.json. The sync script writes this file so that
+ * `SDK_VERSION` is a plain TypeScript literal at runtime — no
+ * runtime JSON-import gotcha (Node ESM requires
+ * `with { type: "json" }` to import JSON as ESM, and the published
+ * dist file would otherwise fail to load).
+ *
+ * Drift protection: `node scripts/sync-sdk-versions.mjs --check` (the
+ * CI gate) flags this file when it falls out of sync with package.json.
+ * Bumping `package.json` without re-running the sync script fails CI.
+ *
+ * Do NOT edit by hand — `node scripts/sync-sdk-versions.mjs`.
+ */
+declare const SDK_VERSION = "1.3.1";
+declare const SDK_NAME = "@cross-deck/node";
+
 /**
  * Machine-readable index of every error code `@cross-deck/node` can
  * throw, with a short description and a hint on what action to take.
@@ -289,16 +308,24 @@ declare function signWebhookPayload(payload: string, secret: string, timestampSe
  *     name: "checkout.started",
  *     developerUserId: userId,
  *     properties: scrubPiiFromProperties({
- *       url: req.url, // might contain "/users/wes@…/" — gets [email]
+ *       url: req.url, // might contain "/users/wes@…/" — gets <email>
  *       lastError: e.message, // might contain card numbers
  *     }),
  *   });
  */
 /**
  * Scrub a single string value: replace email-shaped substrings with
- * `[email]` and card-number-shaped substrings with `[card]`. Returns
- * the original string (===) when nothing matched, so callers can do
- * an identity-check to skip allocating a new event copy.
+ * `<email>` and card-number-shaped substrings with `<card>`. Returns
+ * the original string (===) when nothing matched.
+ *
+ * Implementation note: we call `.replace()` unconditionally rather than
+ * gating on `.test()`. The /g regexes are module-level so `.test()`
+ * carries `lastIndex` state between calls — a prior match leaves
+ * `lastIndex` mid-string and the next `.test()` can falsely return
+ * false on a string that DOES match. `.replace(/g)` always scans the
+ * full string regardless of `lastIndex`, so dropping the test-guard
+ * removes the sharp edge at zero cost (when nothing matches, replace
+ * returns the same `(===)` string).
  */
 declare function scrubPii(value: string): string;
 /**
@@ -334,9 +361,12 @@ declare function scrubPiiFromProperties(properties: Record<string, unknown>): Re
  *   - `sdk.webhook_verified`
  *   - `sdk.runtime_detected`
  *   - `sdk.entitlement_cache_warm`
+ *   - `sdk.entitlement_cache_stale`
+ *   - `sdk.entitlement_store_recovered`
+ *   - `sdk.no_durable_store`
  *   - `sdk.super_property_registered`
  */
-type DebugSignal = "sdk.configured" | "sdk.first_event_sent" | "sdk.invalid_key" | "sdk.no_identity" | "sdk.entitlement_cache_used" | "sdk.entitlement_cache_warm" | "sdk.purchase_evidence_sent" | "sdk.environment_mismatch" | "sdk.sensitive_property_warning" | "sdk.property_coerced" | "sdk.flush_retry_scheduled" | "sdk.flush_on_exit_started" | "sdk.flush_on_exit_completed" | "sdk.webhook_verified" | "sdk.runtime_detected" | "sdk.super_property_registered" | "sdk.boot_heartbeat_failed";
+type DebugSignal = "sdk.configured" | "sdk.first_event_sent" | "sdk.invalid_key" | "sdk.no_identity" | "sdk.entitlement_cache_used" | "sdk.entitlement_cache_warm" | "sdk.entitlement_cache_stale" | "sdk.entitlement_store_recovered" | "sdk.no_durable_store" | "sdk.purchase_evidence_sent" | "sdk.environment_mismatch" | "sdk.sensitive_property_warning" | "sdk.property_coerced" | "sdk.flush_retry_scheduled" | "sdk.flush_permanent_failure" | "sdk.flush_on_exit_started" | "sdk.flush_on_exit_completed" | "sdk.webhook_verified" | "sdk.runtime_detected" | "sdk.super_property_registered" | "sdk.boot_heartbeat_failed";
 interface DebugContext {
     [key: string]: unknown;
 }
@@ -345,4 +375,4 @@ interface DebugLogger {
     emit(signal: DebugSignal, message: string, context?: DebugContext): void;
 }
 
-export { CROSSDECK_ERROR_CODES, type CrossdeckErrorCode, type DebugContext, type DebugLogger, type DebugSignal, type ErrorCodeEntry, type VerifyWebhookOptions, getErrorCode, isCrossdeckErrorCode, scrubPii, scrubPiiFromProperties, signWebhookPayload, verifyWebhookSignature };
+export { CROSSDECK_ERROR_CODES, type CrossdeckErrorCode, type DebugContext, type DebugLogger, type DebugSignal, type ErrorCodeEntry, SDK_NAME, SDK_VERSION, type VerifyWebhookOptions, getErrorCode, isCrossdeckErrorCode, scrubPii, scrubPiiFromProperties, signWebhookPayload, verifyWebhookSignature };

package/dist/index.d.ts

@@ -1,6 +1,25 @@
-export { A as AliasIdentityInput, a as AliasResult, b as AuditDecision, c as AuditEntry, B as Breadcrumb, d as BreadcrumbCategory, e as BreadcrumbLevel, C as CROSSDECK_API_VERSION, f as CapturedError, g as CrossdeckAuthenticationError, h as CrossdeckConfigurationError, i as CrossdeckError, j as CrossdeckErrorPayload, k as CrossdeckErrorType, l as CrossdeckInternalError, m as CrossdeckNetworkError, n as CrossdeckPermissionError, o as CrossdeckRateLimitError, p as CrossdeckServer, q as CrossdeckServerOptions, r as CrossdeckValidationError, D as DEFAULT_BASE_URL, s as DEFAULT_TIMEOUT_MS, t as Diagnostics, E as EntitlementCacheOptions, u as EntitlementMutationResult, v as EntitlementsListResponse, w as EntitlementsListener, x as Environment, y as ErrorCaptureConfig, z as ErrorLevel, F as EventProperties, G as ForgetResult, H as GrantDuration, I as GrantEntitlementInput, J as GroupMembership, K as HeartbeatResponse, L as HttpRequestInfo, M as HttpResponseInfo, N as HttpRetriesConfig, O as IdentifyOptions, P as IdentityHints, Q as IngestOptions, R as IngestResponse, S as PublicEntitlement, T as PurchaseResult, U as RequestOptions, V as RevokeEntitlementInput, W as RuntimeHost, X as RuntimeInfo, Y as SDK_NAME, Z as SDK_VERSION, _ as ServerEvent, $ as StackFrame, a0 as SyncPurchaseInput, a1 as makeCrossdeckError } from './crossdeck-server-BXQaFjVx.js';
+export { A as AliasIdentityInput, a as AliasResult, b as AuditDecision, c as AuditEntry, B as Breadcrumb, d as BreadcrumbCategory, e as BreadcrumbLevel, C as CROSSDECK_API_VERSION, f as CapturedError, g as CrossdeckAuthenticationError, h as CrossdeckConfigurationError, i as CrossdeckError, j as CrossdeckErrorPayload, k as CrossdeckErrorType, l as CrossdeckInternalError, m as CrossdeckNetworkError, n as CrossdeckPermissionError, o as CrossdeckRateLimitError, p as CrossdeckServer, q as CrossdeckServerOptions, r as CrossdeckValidationError, D as DEFAULT_BASE_URL, s as DEFAULT_TIMEOUT_MS, t as Diagnostics, E as EntitlementCacheOptions, u as EntitlementMutationResult, v as EntitlementStore, w as EntitlementsListResponse, x as EntitlementsListener, y as Environment, z as ErrorCaptureConfig, F as ErrorLevel, G as EventProperties, H as ForgetResult, I as GrantDuration, J as GrantEntitlementInput, K as GroupMembership, L as HeartbeatResponse, M as HttpRequestInfo, N as HttpResponseInfo, O as HttpRetriesConfig, P as IdentifyOptions, Q as IdentityHints, R as IngestOptions, S as IngestResponse, T as PublicEntitlement, U as PurchaseResult, V as RequestOptions, W as RevokeEntitlementInput, X as RuntimeHost, Y as RuntimeInfo, Z as ServerEvent, _ as StackFrame, $ as StoredEntitlements, a0 as SyncPurchaseInput, a1 as makeCrossdeckError } from './crossdeck-server-DhnHvUhh.js';
 import 'node:events';
 
+/**
+ * SDK version constant — generated by `scripts/sync-sdk-versions.mjs`.
+ *
+ * Single source of truth: the `version` field in this package's
+ * package.json. The sync script writes this file so that
+ * `SDK_VERSION` is a plain TypeScript literal at runtime — no
+ * runtime JSON-import gotcha (Node ESM requires
+ * `with { type: "json" }` to import JSON as ESM, and the published
+ * dist file would otherwise fail to load).
+ *
+ * Drift protection: `node scripts/sync-sdk-versions.mjs --check` (the
+ * CI gate) flags this file when it falls out of sync with package.json.
+ * Bumping `package.json` without re-running the sync script fails CI.
+ *
+ * Do NOT edit by hand — `node scripts/sync-sdk-versions.mjs`.
+ */
+declare const SDK_VERSION = "1.3.1";
+declare const SDK_NAME = "@cross-deck/node";
+
 /**
  * Machine-readable index of every error code `@cross-deck/node` can
  * throw, with a short description and a hint on what action to take.
@@ -289,16 +308,24 @@ declare function signWebhookPayload(payload: string, secret: string, timestampSe
  *     name: "checkout.started",
  *     developerUserId: userId,
  *     properties: scrubPiiFromProperties({
- *       url: req.url, // might contain "/users/wes@…/" — gets [email]
+ *       url: req.url, // might contain "/users/wes@…/" — gets <email>
  *       lastError: e.message, // might contain card numbers
  *     }),
  *   });
  */
 /**
  * Scrub a single string value: replace email-shaped substrings with
- * `[email]` and card-number-shaped substrings with `[card]`. Returns
- * the original string (===) when nothing matched, so callers can do
- * an identity-check to skip allocating a new event copy.
+ * `<email>` and card-number-shaped substrings with `<card>`. Returns
+ * the original string (===) when nothing matched.
+ *
+ * Implementation note: we call `.replace()` unconditionally rather than
+ * gating on `.test()`. The /g regexes are module-level so `.test()`
+ * carries `lastIndex` state between calls — a prior match leaves
+ * `lastIndex` mid-string and the next `.test()` can falsely return
+ * false on a string that DOES match. `.replace(/g)` always scans the
+ * full string regardless of `lastIndex`, so dropping the test-guard
+ * removes the sharp edge at zero cost (when nothing matches, replace
+ * returns the same `(===)` string).
  */
 declare function scrubPii(value: string): string;
 /**
@@ -334,9 +361,12 @@ declare function scrubPiiFromProperties(properties: Record<string, unknown>): Re
  *   - `sdk.webhook_verified`
  *   - `sdk.runtime_detected`
  *   - `sdk.entitlement_cache_warm`
+ *   - `sdk.entitlement_cache_stale`
+ *   - `sdk.entitlement_store_recovered`
+ *   - `sdk.no_durable_store`
  *   - `sdk.super_property_registered`
  */
-type DebugSignal = "sdk.configured" | "sdk.first_event_sent" | "sdk.invalid_key" | "sdk.no_identity" | "sdk.entitlement_cache_used" | "sdk.entitlement_cache_warm" | "sdk.purchase_evidence_sent" | "sdk.environment_mismatch" | "sdk.sensitive_property_warning" | "sdk.property_coerced" | "sdk.flush_retry_scheduled" | "sdk.flush_on_exit_started" | "sdk.flush_on_exit_completed" | "sdk.webhook_verified" | "sdk.runtime_detected" | "sdk.super_property_registered" | "sdk.boot_heartbeat_failed";
+type DebugSignal = "sdk.configured" | "sdk.first_event_sent" | "sdk.invalid_key" | "sdk.no_identity" | "sdk.entitlement_cache_used" | "sdk.entitlement_cache_warm" | "sdk.entitlement_cache_stale" | "sdk.entitlement_store_recovered" | "sdk.no_durable_store" | "sdk.purchase_evidence_sent" | "sdk.environment_mismatch" | "sdk.sensitive_property_warning" | "sdk.property_coerced" | "sdk.flush_retry_scheduled" | "sdk.flush_permanent_failure" | "sdk.flush_on_exit_started" | "sdk.flush_on_exit_completed" | "sdk.webhook_verified" | "sdk.runtime_detected" | "sdk.super_property_registered" | "sdk.boot_heartbeat_failed";
 interface DebugContext {
     [key: string]: unknown;
 }
@@ -345,4 +375,4 @@ interface DebugLogger {
     emit(signal: DebugSignal, message: string, context?: DebugContext): void;
 }
 
-export { CROSSDECK_ERROR_CODES, type CrossdeckErrorCode, type DebugContext, type DebugLogger, type DebugSignal, type ErrorCodeEntry, type VerifyWebhookOptions, getErrorCode, isCrossdeckErrorCode, scrubPii, scrubPiiFromProperties, signWebhookPayload, verifyWebhookSignature };
+export { CROSSDECK_ERROR_CODES, type CrossdeckErrorCode, type DebugContext, type DebugLogger, type DebugSignal, type ErrorCodeEntry, SDK_NAME, SDK_VERSION, type VerifyWebhookOptions, getErrorCode, isCrossdeckErrorCode, scrubPii, scrubPiiFromProperties, signWebhookPayload, verifyWebhookSignature };