@cross-deck/node 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,187 @@
+type Environment = "production" | "sandbox";
+type AuditRail = "apple" | "stripe" | "google" | "manual";
+interface PublicEntitlement {
+    object: "entitlement";
+    key: string;
+    isActive: boolean;
+    validUntil?: number | null;
+    source: {
+        rail: AuditRail;
+        productId: string;
+        subscriptionId: string;
+    };
+    updatedAt: number;
+}
+interface EntitlementsListResponse {
+    object: "list";
+    data: PublicEntitlement[];
+    crossdeckCustomerId: string;
+    env: Environment;
+}
+interface AliasResult {
+    object: "alias_result";
+    crossdeckCustomerId: string;
+    linked: Array<{
+        type: "developer";
+        id: string;
+    } | {
+        type: "anonymous";
+        id: string;
+    }>;
+    mergePending: boolean;
+    env: Environment;
+}
+interface IngestResponse {
+    object: "list";
+    received: number;
+    env: Environment;
+    throttled?: {
+        dropped: number;
+        sampleRate: number;
+        retryAfterMs: number;
+    };
+}
+interface PurchaseResult {
+    object: "purchase_result";
+    crossdeckCustomerId: string;
+    env: Environment;
+    entitlements: PublicEntitlement[];
+}
+interface ForgetResult {
+    object: "forgot";
+    crossdeckCustomerId: string | null;
+    queuedAt: number;
+    env: Environment;
+}
+interface CrossdeckServerOptions {
+    secretKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    sdkVersion?: string;
+    /**
+     * Optional informational appId stamped onto event batches. The server
+     * ultimately trusts the API key's resolved app routing, so this is
+     * best-effort metadata only.
+     */
+    appId?: string;
+}
+interface IdentityHints {
+    customerId?: string;
+    userId?: string;
+    anonymousId?: string;
+}
+interface IdentifyOptions {
+    email?: string;
+    traits?: Record<string, unknown>;
+}
+interface AliasIdentityInput extends IdentifyOptions {
+    userId: string;
+    anonymousId: string;
+}
+type ErrorLevel = "error" | "warning" | "info";
+interface ServerEvent {
+    eventId?: string;
+    name: string;
+    timestamp?: number;
+    properties?: Record<string, unknown>;
+    developerUserId?: string;
+    anonymousId?: string;
+    crossdeckCustomerId?: string;
+    level?: ErrorLevel;
+    tags?: Record<string, string>;
+    categoryTags?: string[];
+}
+interface IngestOptions {
+    idempotencyKey?: string;
+}
+interface SyncPurchaseInput {
+    rail?: "apple";
+    signedTransactionInfo: string;
+    signedRenewalInfo?: string;
+    appAccountToken?: string;
+}
+type GrantDuration = "P30D" | "P90D" | "P1Y" | "lifetime";
+interface GrantEntitlementInput {
+    customerId: string;
+    entitlementKey: string;
+    duration: GrantDuration;
+    reason: string;
+}
+interface RevokeEntitlementInput {
+    customerId: string;
+    entitlementKey: string;
+    reason: string;
+}
+interface EntitlementMutationResult {
+    object: "entitlement_mutation";
+    action: "grant" | "revoke";
+    crossdeckCustomerId: string;
+    entitlement: PublicEntitlement;
+    env: Environment;
+}
+type AuditDecision = "applied" | "no_op" | "rejected";
+interface AuditEntry {
+    eventId: string;
+    rail: AuditRail;
+    env: Environment;
+    eventType: string;
+    projectId: string;
+    subscriptionId?: string;
+    customerId?: string;
+    fromState?: string;
+    toState?: string;
+    decision: AuditDecision;
+    reason?: string;
+    derivedSignal?: string;
+    signatureVerified: boolean;
+    reconciledWithProvider: boolean;
+    rawEventReceivedAt: number;
+    processedAt: number;
+}
+
+declare class CrossdeckServer {
+    private readonly http;
+    private readonly sdkVersion;
+    private readonly appId?;
+    constructor(options: CrossdeckServerOptions);
+    identify(userId: string, anonymousId: string, options?: IdentifyOptions): Promise<AliasResult>;
+    aliasIdentity(input: AliasIdentityInput): Promise<AliasResult>;
+    forget(hints: IdentityHints): Promise<ForgetResult>;
+    getEntitlements(hints: IdentityHints): Promise<EntitlementsListResponse>;
+    getCustomerEntitlements(customerId: string): Promise<EntitlementsListResponse>;
+    track(event: ServerEvent, options?: IngestOptions): Promise<IngestResponse>;
+    ingest(events: ServerEvent[], options?: IngestOptions): Promise<IngestResponse>;
+    syncPurchases(input: SyncPurchaseInput): Promise<PurchaseResult>;
+    grantEntitlement(input: GrantEntitlementInput): Promise<EntitlementMutationResult>;
+    revokeEntitlement(input: RevokeEntitlementInput): Promise<EntitlementMutationResult>;
+    getAuditEntry(eventId: string): Promise<AuditEntry>;
+    private identityPayload;
+    private normalizeEvent;
+    private mintEventId;
+    private mintBatchId;
+}
+
+type CrossdeckErrorType = "authentication_error" | "permission_error" | "invalid_request_error" | "rate_limit_error" | "internal_error" | "network_error" | "configuration_error";
+interface CrossdeckErrorPayload {
+    type: CrossdeckErrorType;
+    code: string;
+    message: string;
+    requestId?: string;
+    status?: number;
+    retryAfterMs?: number;
+}
+declare class CrossdeckError extends Error {
+    readonly type: CrossdeckErrorType;
+    readonly code: string;
+    readonly requestId?: string;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    constructor(payload: CrossdeckErrorPayload);
+}
+
+declare const SDK_NAME = "@cross-deck/node";
+declare const SDK_VERSION = "0.1.0";
+declare const DEFAULT_BASE_URL = "https://api.cross-deck.com/v1";
+declare const DEFAULT_TIMEOUT_MS = 15000;
+
+export { type AliasIdentityInput, type AliasResult, type AuditDecision, type AuditEntry, CrossdeckError, type CrossdeckErrorPayload, type CrossdeckErrorType, CrossdeckServer, type CrossdeckServerOptions, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type EntitlementMutationResult, type EntitlementsListResponse, type Environment, type ErrorLevel, type ForgetResult, type GrantDuration, type GrantEntitlementInput, type IdentifyOptions, type IdentityHints, type IngestOptions, type IngestResponse, type PublicEntitlement, type RevokeEntitlementInput, SDK_NAME, SDK_VERSION, type ServerEvent, type SyncPurchaseInput };

package/dist/index.d.ts

@@ -0,0 +1,187 @@
+type Environment = "production" | "sandbox";
+type AuditRail = "apple" | "stripe" | "google" | "manual";
+interface PublicEntitlement {
+    object: "entitlement";
+    key: string;
+    isActive: boolean;
+    validUntil?: number | null;
+    source: {
+        rail: AuditRail;
+        productId: string;
+        subscriptionId: string;
+    };
+    updatedAt: number;
+}
+interface EntitlementsListResponse {
+    object: "list";
+    data: PublicEntitlement[];
+    crossdeckCustomerId: string;
+    env: Environment;
+}
+interface AliasResult {
+    object: "alias_result";
+    crossdeckCustomerId: string;
+    linked: Array<{
+        type: "developer";
+        id: string;
+    } | {
+        type: "anonymous";
+        id: string;
+    }>;
+    mergePending: boolean;
+    env: Environment;
+}
+interface IngestResponse {
+    object: "list";
+    received: number;
+    env: Environment;
+    throttled?: {
+        dropped: number;
+        sampleRate: number;
+        retryAfterMs: number;
+    };
+}
+interface PurchaseResult {
+    object: "purchase_result";
+    crossdeckCustomerId: string;
+    env: Environment;
+    entitlements: PublicEntitlement[];
+}
+interface ForgetResult {
+    object: "forgot";
+    crossdeckCustomerId: string | null;
+    queuedAt: number;
+    env: Environment;
+}
+interface CrossdeckServerOptions {
+    secretKey: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    sdkVersion?: string;
+    /**
+     * Optional informational appId stamped onto event batches. The server
+     * ultimately trusts the API key's resolved app routing, so this is
+     * best-effort metadata only.
+     */
+    appId?: string;
+}
+interface IdentityHints {
+    customerId?: string;
+    userId?: string;
+    anonymousId?: string;
+}
+interface IdentifyOptions {
+    email?: string;
+    traits?: Record<string, unknown>;
+}
+interface AliasIdentityInput extends IdentifyOptions {
+    userId: string;
+    anonymousId: string;
+}
+type ErrorLevel = "error" | "warning" | "info";
+interface ServerEvent {
+    eventId?: string;
+    name: string;
+    timestamp?: number;
+    properties?: Record<string, unknown>;
+    developerUserId?: string;
+    anonymousId?: string;
+    crossdeckCustomerId?: string;
+    level?: ErrorLevel;
+    tags?: Record<string, string>;
+    categoryTags?: string[];
+}
+interface IngestOptions {
+    idempotencyKey?: string;
+}
+interface SyncPurchaseInput {
+    rail?: "apple";
+    signedTransactionInfo: string;
+    signedRenewalInfo?: string;
+    appAccountToken?: string;
+}
+type GrantDuration = "P30D" | "P90D" | "P1Y" | "lifetime";
+interface GrantEntitlementInput {
+    customerId: string;
+    entitlementKey: string;
+    duration: GrantDuration;
+    reason: string;
+}
+interface RevokeEntitlementInput {
+    customerId: string;
+    entitlementKey: string;
+    reason: string;
+}
+interface EntitlementMutationResult {
+    object: "entitlement_mutation";
+    action: "grant" | "revoke";
+    crossdeckCustomerId: string;
+    entitlement: PublicEntitlement;
+    env: Environment;
+}
+type AuditDecision = "applied" | "no_op" | "rejected";
+interface AuditEntry {
+    eventId: string;
+    rail: AuditRail;
+    env: Environment;
+    eventType: string;
+    projectId: string;
+    subscriptionId?: string;
+    customerId?: string;
+    fromState?: string;
+    toState?: string;
+    decision: AuditDecision;
+    reason?: string;
+    derivedSignal?: string;
+    signatureVerified: boolean;
+    reconciledWithProvider: boolean;
+    rawEventReceivedAt: number;
+    processedAt: number;
+}
+
+declare class CrossdeckServer {
+    private readonly http;
+    private readonly sdkVersion;
+    private readonly appId?;
+    constructor(options: CrossdeckServerOptions);
+    identify(userId: string, anonymousId: string, options?: IdentifyOptions): Promise<AliasResult>;
+    aliasIdentity(input: AliasIdentityInput): Promise<AliasResult>;
+    forget(hints: IdentityHints): Promise<ForgetResult>;
+    getEntitlements(hints: IdentityHints): Promise<EntitlementsListResponse>;
+    getCustomerEntitlements(customerId: string): Promise<EntitlementsListResponse>;
+    track(event: ServerEvent, options?: IngestOptions): Promise<IngestResponse>;
+    ingest(events: ServerEvent[], options?: IngestOptions): Promise<IngestResponse>;
+    syncPurchases(input: SyncPurchaseInput): Promise<PurchaseResult>;
+    grantEntitlement(input: GrantEntitlementInput): Promise<EntitlementMutationResult>;
+    revokeEntitlement(input: RevokeEntitlementInput): Promise<EntitlementMutationResult>;
+    getAuditEntry(eventId: string): Promise<AuditEntry>;
+    private identityPayload;
+    private normalizeEvent;
+    private mintEventId;
+    private mintBatchId;
+}
+
+type CrossdeckErrorType = "authentication_error" | "permission_error" | "invalid_request_error" | "rate_limit_error" | "internal_error" | "network_error" | "configuration_error";
+interface CrossdeckErrorPayload {
+    type: CrossdeckErrorType;
+    code: string;
+    message: string;
+    requestId?: string;
+    status?: number;
+    retryAfterMs?: number;
+}
+declare class CrossdeckError extends Error {
+    readonly type: CrossdeckErrorType;
+    readonly code: string;
+    readonly requestId?: string;
+    readonly status?: number;
+    readonly retryAfterMs?: number;
+    constructor(payload: CrossdeckErrorPayload);
+}
+
+declare const SDK_NAME = "@cross-deck/node";
+declare const SDK_VERSION = "0.1.0";
+declare const DEFAULT_BASE_URL = "https://api.cross-deck.com/v1";
+declare const DEFAULT_TIMEOUT_MS = 15000;
+
+export { type AliasIdentityInput, type AliasResult, type AuditDecision, type AuditEntry, CrossdeckError, type CrossdeckErrorPayload, type CrossdeckErrorType, CrossdeckServer, type CrossdeckServerOptions, DEFAULT_BASE_URL, DEFAULT_TIMEOUT_MS, type EntitlementMutationResult, type EntitlementsListResponse, type Environment, type ErrorLevel, type ForgetResult, type GrantDuration, type GrantEntitlementInput, type IdentifyOptions, type IdentityHints, type IngestOptions, type IngestResponse, type PublicEntitlement, type RevokeEntitlementInput, SDK_NAME, SDK_VERSION, type ServerEvent, type SyncPurchaseInput };