@shadowob/oauth 1.1.4 → 1.1.6-dev.311

package/dist/index.cjs

@@ -204,6 +204,32 @@ var ShadowOAuth = class {
       data
     );
   }
+  /**
+   * Check the current user's entitlement for this OAuth app.
+   * Requires `commerce:read` scope.
+   */
+  async getCommerceEntitlementAccess(accessToken, params) {
+    const qs = new URLSearchParams();
+    if (params?.resourceType) qs.set("resourceType", params.resourceType);
+    if (params?.resourceId) qs.set("resourceId", params.resourceId);
+    if (params?.capability) qs.set("capability", params.capability);
+    const query = qs.toString();
+    return this.oauthGet(
+      `/api/oauth/commerce/entitlements${query ? `?${query}` : ""}`,
+      accessToken
+    );
+  }
+  /**
+   * Redeem one current-user entitlement for this OAuth app.
+   * Requires `commerce:write` scope.
+   */
+  async redeemCommerceEntitlement(accessToken, data) {
+    return this.oauthPost(
+      "/api/oauth/commerce/entitlements/redeem",
+      accessToken,
+      data
+    );
+  }
   // ─── Private helpers ─────────────────────────────
   async oauthGet(path, accessToken) {
     const res = await fetch(`${this.baseUrl}${path}`, {

package/dist/index.d.cts

@@ -22,7 +22,7 @@ interface ShadowOAuthUser {
     avatarUrl: string | null;
     email?: string;
 }
-type ShadowOAuthScope = 'user:read' | 'user:email' | 'servers:read' | 'servers:write' | 'channels:read' | 'channels:write' | 'messages:read' | 'messages:write' | 'attachments:read' | 'attachments:write' | 'workspaces:read' | 'workspaces:write' | 'buddies:create' | 'buddies:manage';
+type ShadowOAuthScope = 'user:read' | 'user:email' | 'servers:read' | 'servers:write' | 'channels:read' | 'channels:write' | 'messages:read' | 'messages:write' | 'attachments:read' | 'attachments:write' | 'workspaces:read' | 'workspaces:write' | 'buddies:create' | 'buddies:manage' | 'commerce:read' | 'commerce:write';
 interface ShadowOAuthServer {
     id: string;
     name: string;
@@ -54,6 +54,57 @@ interface ShadowOAuthBuddy {
     userId: string;
     agentId: string;
 }
+interface ShadowOAuthCommerceEntitlementSummary {
+    id: string;
+    status: string;
+    capability: string;
+    resourceType: string;
+    resourceId: string;
+    productId?: string | null;
+    shopId?: string | null;
+    orderId?: string | null;
+    offerId?: string | null;
+    expiresAt?: string | null;
+}
+interface ShadowOAuthCommerceEntitlementAccess {
+    allowed: boolean;
+    status: string;
+    reasonCode?: string | null;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    app: {
+        id: string;
+    };
+    entitlement?: ShadowOAuthCommerceEntitlementSummary | null;
+}
+interface ShadowOAuthCommerceEntitlementRedeemInput {
+    idempotencyKey: string;
+    resourceType?: string;
+    resourceId?: string;
+    capability?: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+interface ShadowOAuthCommerceEntitlementRedemption {
+    appId: string;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    idempotencyKey: string;
+    redeemedAt: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+interface ShadowOAuthCommerceEntitlementRedeemResult {
+    redeemed: true;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    app: {
+        id: string;
+    };
+    entitlement: ShadowOAuthCommerceEntitlementSummary;
+    redemption: ShadowOAuthCommerceEntitlementRedemption;
+}
 
 /**
  * Shadow OAuth SDK client.
@@ -169,8 +220,22 @@ declare class ShadowOAuth {
         channelId: string;
         content: string;
     }): Promise<ShadowOAuthMessage>;
+    /**
+     * Check the current user's entitlement for this OAuth app.
+     * Requires `commerce:read` scope.
+     */
+    getCommerceEntitlementAccess(accessToken: string, params?: {
+        resourceType?: string;
+        resourceId?: string;
+        capability?: string;
+    }): Promise<ShadowOAuthCommerceEntitlementAccess>;
+    /**
+     * Redeem one current-user entitlement for this OAuth app.
+     * Requires `commerce:write` scope.
+     */
+    redeemCommerceEntitlement(accessToken: string, data: ShadowOAuthCommerceEntitlementRedeemInput): Promise<ShadowOAuthCommerceEntitlementRedeemResult>;
     private oauthGet;
     private oauthPost;
 }
 
-export { ShadowOAuth, type ShadowOAuthBuddy, type ShadowOAuthChannel, type ShadowOAuthConfig, type ShadowOAuthMessage, type ShadowOAuthScope, type ShadowOAuthServer, type ShadowOAuthTokens, type ShadowOAuthUser, type ShadowOAuthWorkspace };
+export { ShadowOAuth, type ShadowOAuthBuddy, type ShadowOAuthChannel, type ShadowOAuthCommerceEntitlementAccess, type ShadowOAuthCommerceEntitlementRedeemInput, type ShadowOAuthCommerceEntitlementRedeemResult, type ShadowOAuthCommerceEntitlementRedemption, type ShadowOAuthCommerceEntitlementSummary, type ShadowOAuthConfig, type ShadowOAuthMessage, type ShadowOAuthScope, type ShadowOAuthServer, type ShadowOAuthTokens, type ShadowOAuthUser, type ShadowOAuthWorkspace };

package/dist/index.d.ts

@@ -22,7 +22,7 @@ interface ShadowOAuthUser {
     avatarUrl: string | null;
     email?: string;
 }
-type ShadowOAuthScope = 'user:read' | 'user:email' | 'servers:read' | 'servers:write' | 'channels:read' | 'channels:write' | 'messages:read' | 'messages:write' | 'attachments:read' | 'attachments:write' | 'workspaces:read' | 'workspaces:write' | 'buddies:create' | 'buddies:manage';
+type ShadowOAuthScope = 'user:read' | 'user:email' | 'servers:read' | 'servers:write' | 'channels:read' | 'channels:write' | 'messages:read' | 'messages:write' | 'attachments:read' | 'attachments:write' | 'workspaces:read' | 'workspaces:write' | 'buddies:create' | 'buddies:manage' | 'commerce:read' | 'commerce:write';
 interface ShadowOAuthServer {
     id: string;
     name: string;
@@ -54,6 +54,57 @@ interface ShadowOAuthBuddy {
     userId: string;
     agentId: string;
 }
+interface ShadowOAuthCommerceEntitlementSummary {
+    id: string;
+    status: string;
+    capability: string;
+    resourceType: string;
+    resourceId: string;
+    productId?: string | null;
+    shopId?: string | null;
+    orderId?: string | null;
+    offerId?: string | null;
+    expiresAt?: string | null;
+}
+interface ShadowOAuthCommerceEntitlementAccess {
+    allowed: boolean;
+    status: string;
+    reasonCode?: string | null;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    app: {
+        id: string;
+    };
+    entitlement?: ShadowOAuthCommerceEntitlementSummary | null;
+}
+interface ShadowOAuthCommerceEntitlementRedeemInput {
+    idempotencyKey: string;
+    resourceType?: string;
+    resourceId?: string;
+    capability?: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+interface ShadowOAuthCommerceEntitlementRedemption {
+    appId: string;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    idempotencyKey: string;
+    redeemedAt: string;
+    metadata?: Record<string, string | number | boolean | null>;
+}
+interface ShadowOAuthCommerceEntitlementRedeemResult {
+    redeemed: true;
+    resourceType: string;
+    resourceId: string;
+    capability: string;
+    app: {
+        id: string;
+    };
+    entitlement: ShadowOAuthCommerceEntitlementSummary;
+    redemption: ShadowOAuthCommerceEntitlementRedemption;
+}
 
 /**
  * Shadow OAuth SDK client.
@@ -169,8 +220,22 @@ declare class ShadowOAuth {
         channelId: string;
         content: string;
     }): Promise<ShadowOAuthMessage>;
+    /**
+     * Check the current user's entitlement for this OAuth app.
+     * Requires `commerce:read` scope.
+     */
+    getCommerceEntitlementAccess(accessToken: string, params?: {
+        resourceType?: string;
+        resourceId?: string;
+        capability?: string;
+    }): Promise<ShadowOAuthCommerceEntitlementAccess>;
+    /**
+     * Redeem one current-user entitlement for this OAuth app.
+     * Requires `commerce:write` scope.
+     */
+    redeemCommerceEntitlement(accessToken: string, data: ShadowOAuthCommerceEntitlementRedeemInput): Promise<ShadowOAuthCommerceEntitlementRedeemResult>;
     private oauthGet;
     private oauthPost;
 }
 
-export { ShadowOAuth, type ShadowOAuthBuddy, type ShadowOAuthChannel, type ShadowOAuthConfig, type ShadowOAuthMessage, type ShadowOAuthScope, type ShadowOAuthServer, type ShadowOAuthTokens, type ShadowOAuthUser, type ShadowOAuthWorkspace };
+export { ShadowOAuth, type ShadowOAuthBuddy, type ShadowOAuthChannel, type ShadowOAuthCommerceEntitlementAccess, type ShadowOAuthCommerceEntitlementRedeemInput, type ShadowOAuthCommerceEntitlementRedeemResult, type ShadowOAuthCommerceEntitlementRedemption, type ShadowOAuthCommerceEntitlementSummary, type ShadowOAuthConfig, type ShadowOAuthMessage, type ShadowOAuthScope, type ShadowOAuthServer, type ShadowOAuthTokens, type ShadowOAuthUser, type ShadowOAuthWorkspace };

package/dist/index.js

@@ -178,6 +178,32 @@ var ShadowOAuth = class {
       data
     );
   }
+  /**
+   * Check the current user's entitlement for this OAuth app.
+   * Requires `commerce:read` scope.
+   */
+  async getCommerceEntitlementAccess(accessToken, params) {
+    const qs = new URLSearchParams();
+    if (params?.resourceType) qs.set("resourceType", params.resourceType);
+    if (params?.resourceId) qs.set("resourceId", params.resourceId);
+    if (params?.capability) qs.set("capability", params.capability);
+    const query = qs.toString();
+    return this.oauthGet(
+      `/api/oauth/commerce/entitlements${query ? `?${query}` : ""}`,
+      accessToken
+    );
+  }
+  /**
+   * Redeem one current-user entitlement for this OAuth app.
+   * Requires `commerce:write` scope.
+   */
+  async redeemCommerceEntitlement(accessToken, data) {
+    return this.oauthPost(
+      "/api/oauth/commerce/entitlements/redeem",
+      accessToken,
+      data
+    );
+  }
   // ─── Private helpers ─────────────────────────────
   async oauthGet(path, accessToken) {
     const res = await fetch(`${this.baseUrl}${path}`, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shadowob/oauth",
-  "version": "1.1.4",
+  "version": "1.1.6-dev.311",
   "description": "Shadow OAuth SDK — typed client for integrating Shadow OAuth login into third-party applications",
   "license": "MIT",
   "type": "module",