@frontiertower/frontier-sdk 0.5.0 → 0.7.0

package/dist/index.js

@@ -25,6 +25,7 @@ __export(index_exports, {
   PartnershipsAccess: () => PartnershipsAccess,
   StorageAccess: () => StorageAccess,
   SwapResultStatus: () => SwapResultStatus,
+  ThirdPartyAccess: () => ThirdPartyAccess,
   UserAccess: () => UserAccess,
   WalletAccess: () => WalletAccess,
   createStandaloneHTML: () => createStandaloneHTML,
@@ -713,6 +714,296 @@ var PartnershipsAccess = class {
   }
 };
 
+// src/access/third-party.ts
+var ThirdPartyAccess = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  // ===========================================================================
+  // Developer Methods
+  // ===========================================================================
+  /**
+   * List developer accounts (paginated)
+   * Requires permission: `thirdParty:listDevelopers` or `thirdParty:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @returns Paginated response of developers
+   *
+   * @example
+   * ```typescript
+   * const developers = await sdk.getThirdParty().listDevelopers({ limit: 20, offset: 0 });
+   * console.log('Total developers:', developers.count);
+   * ```
+   */
+  async listDevelopers(payload) {
+    return this.sdk.request("thirdParty:listDevelopers", payload);
+  }
+  /**
+   * Get developer details by ID
+   * Requires permission: `thirdParty:getDeveloper` or `thirdParty:*`
+   *
+   * @param payload.id - Developer ID
+   * @returns Developer details
+   *
+   * @example
+   * ```typescript
+   * const developer = await sdk.getThirdParty().getDeveloper({ id: 123 });
+   * console.log('Developer:', developer.name);
+   * ```
+   */
+  async getDeveloper(payload) {
+    return this.sdk.request("thirdParty:getDeveloper", payload);
+  }
+  /**
+   * Update developer information
+   * Requires permission: `thirdParty:updateDeveloper` or `thirdParty:*`
+   *
+   * @param payload.id - Developer ID
+   * @param payload.data - Update data
+   * @returns Updated developer
+   *
+   * @example
+   * ```typescript
+   * const developer = await sdk.getThirdParty().updateDeveloper({
+   *   id: 123,
+   *   data: { name: 'New Name', website: 'https://example.com' }
+   * });
+   * ```
+   */
+  async updateDeveloper(payload) {
+    return this.sdk.request("thirdParty:updateDeveloper", payload);
+  }
+  /**
+   * Rotate developer API key
+   * Requires permission: `thirdParty:rotateDeveloperApiKey` or `thirdParty:*`
+   *
+   * Note: The new API key is only shown once in the response
+   *
+   * @param payload.id - Developer ID
+   * @returns Response containing the new API key
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.getThirdParty().rotateDeveloperApiKey({ id: 123 });
+   * console.log('New API key:', result.apiKey);
+   * // Store this key securely - it won't be shown again!
+   * ```
+   */
+  async rotateDeveloperApiKey(payload) {
+    return this.sdk.request("thirdParty:rotateDeveloperApiKey", payload);
+  }
+  // ===========================================================================
+  // App Methods
+  // ===========================================================================
+  /**
+   * List registered apps (paginated)
+   * Requires permission: `thirdParty:listApps` or `thirdParty:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @param payload.developerId - Filter by developer ID
+   * @returns Paginated response of apps
+   *
+   * @example
+   * ```typescript
+   * const apps = await sdk.getThirdParty().listApps({ limit: 20, offset: 0 });
+   * console.log('Total apps:', apps.count);
+   *
+   * // Filter by developer
+   * const devApps = await sdk.getThirdParty().listApps({ developerId: 123 });
+   * ```
+   */
+  async listApps(payload) {
+    return this.sdk.request("thirdParty:listApps", payload);
+  }
+  /**
+   * Register a new app
+   * Requires permission: `thirdParty:createApp` or `thirdParty:*`
+   *
+   * Note: App name, description, and icon are automatically fetched from the URL's metadata
+   *
+   * @param payload - App creation payload with URL
+   * @returns Created app
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().createApp({
+   *   url: 'https://myapp.example.com'
+   * });
+   * console.log('Created app:', app.id, app.name);
+   * ```
+   */
+  async createApp(payload) {
+    return this.sdk.request("thirdParty:createApp", payload);
+  }
+  /**
+   * Get app details by ID
+   * Requires permission: `thirdParty:getApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   * @returns App details
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().getApp({ id: 123 });
+   * console.log('App:', app.name, app.status);
+   * ```
+   */
+  async getApp(payload) {
+    return this.sdk.request("thirdParty:getApp", payload);
+  }
+  /**
+   * Update an app
+   * Requires permission: `thirdParty:updateApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   * @param payload.data - Update data
+   * @returns Updated app
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().updateApp({
+   *   id: 123,
+   *   data: { name: 'Updated App Name', description: 'New description' }
+   * });
+   * ```
+   */
+  async updateApp(payload) {
+    return this.sdk.request("thirdParty:updateApp", payload);
+  }
+  /**
+   * Request app deactivation
+   * Requires permission: `thirdParty:deleteApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getThirdParty().deleteApp({ id: 123 });
+   * ```
+   */
+  async deleteApp(payload) {
+    return this.sdk.request("thirdParty:deleteApp", payload);
+  }
+  // ===========================================================================
+  // Webhook Methods
+  // ===========================================================================
+  /**
+   * List webhooks (paginated)
+   * Requires permission: `thirdParty:listWebhooks` or `thirdParty:*`
+   *
+   * Note: Maximum 3 webhooks per developer account
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @param payload.developerId - Filter by developer ID
+   * @returns Paginated response of webhooks
+   *
+   * @example
+   * ```typescript
+   * const webhooks = await sdk.getThirdParty().listWebhooks({ limit: 10, offset: 0 });
+   * console.log('Total webhooks:', webhooks.count);
+   *
+   * // Filter by developer
+   * const devWebhooks = await sdk.getThirdParty().listWebhooks({ developerId: 123 });
+   * ```
+   */
+  async listWebhooks(payload) {
+    return this.sdk.request("thirdParty:listWebhooks", payload);
+  }
+  /**
+   * Create a new webhook
+   * Requires permission: `thirdParty:createWebhook` or `thirdParty:*`
+   *
+   * Note: New webhooks require admin approval before going live
+   *
+   * @param payload - Webhook creation payload
+   * @returns Created webhook
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().createWebhook({
+   *   url: 'https://myapp.example.com/webhooks',
+   *   events: ['app.approved', 'user.registered']
+   * });
+   * console.log('Created webhook:', webhook.id);
+   * ```
+   */
+  async createWebhook(payload) {
+    return this.sdk.request("thirdParty:createWebhook", payload);
+  }
+  /**
+   * Get webhook details by ID
+   * Requires permission: `thirdParty:getWebhook` or `thirdParty:*`
+   *
+   * @param payload.id - Webhook ID
+   * @returns Webhook details
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().getWebhook({ id: 123 });
+   * console.log('Webhook:', webhook.url, webhook.status);
+   * ```
+   */
+  async getWebhook(payload) {
+    return this.sdk.request("thirdParty:getWebhook", payload);
+  }
+  /**
+   * Update a webhook
+   * Requires permission: `thirdParty:updateWebhook` or `thirdParty:*`
+   *
+   * Note: Config changes require admin approval before going live
+   *
+   * @param payload.id - Webhook ID
+   * @param payload.data - Update data
+   * @returns Updated webhook
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().updateWebhook({
+   *   id: 123,
+   *   data: { url: 'https://newurl.example.com/webhooks' }
+   * });
+   * ```
+   */
+  async updateWebhook(payload) {
+    return this.sdk.request("thirdParty:updateWebhook", payload);
+  }
+  /**
+   * Delete a webhook
+   * Requires permission: `thirdParty:deleteWebhook` or `thirdParty:*`
+   *
+   * @param payload.id - Webhook ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getThirdParty().deleteWebhook({ id: 123 });
+   * ```
+   */
+  async deleteWebhook(payload) {
+    return this.sdk.request("thirdParty:deleteWebhook", payload);
+  }
+  /**
+   * Rotate webhook signing key
+   * Requires permission: `thirdParty:rotateWebhookSigningKey` or `thirdParty:*`
+   *
+   * Note: The new signing public key is returned in the response
+   *
+   * @param payload.id - Webhook ID
+   * @returns Response containing the new signing public key
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.getThirdParty().rotateWebhookSigningKey({ id: 123 });
+   * console.log('New signing key:', result.signingPublicKey);
+   * ```
+   */
+  async rotateWebhookSigningKey(payload) {
+    return this.sdk.request("thirdParty:rotateWebhookSigningKey", payload);
+  }
+};
+
 // src/sdk.ts
 var FrontierSDK = class {
   constructor() {
@@ -736,6 +1027,7 @@ var FrontierSDK = class {
     this.chain = new ChainAccess(this);
     this.user = new UserAccess(this);
     this.partnerships = new PartnershipsAccess(this);
+    this.thirdParty = new ThirdPartyAccess(this);
     window.addEventListener("message", this.handleMessage);
     this.notifyReady();
   }
@@ -790,6 +1082,12 @@ var FrontierSDK = class {
   getPartnerships() {
     return this.partnerships;
   }
+  /**
+   * Get third-party access instance
+   */
+  getThirdParty() {
+    return this.thirdParty;
+  }
   /**
    * Cleanup: Remove event listeners
    * Call this when your app is being destroyed
@@ -1015,6 +1313,7 @@ function createStandaloneHTML(appName = "Frontier App") {
   PartnershipsAccess,
   StorageAccess,
   SwapResultStatus,
+  ThirdPartyAccess,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,

package/dist/index.mjs

@@ -684,6 +684,296 @@ var PartnershipsAccess = class {
   }
 };
 
+// src/access/third-party.ts
+var ThirdPartyAccess = class {
+  constructor(sdk) {
+    this.sdk = sdk;
+  }
+  // ===========================================================================
+  // Developer Methods
+  // ===========================================================================
+  /**
+   * List developer accounts (paginated)
+   * Requires permission: `thirdParty:listDevelopers` or `thirdParty:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @returns Paginated response of developers
+   *
+   * @example
+   * ```typescript
+   * const developers = await sdk.getThirdParty().listDevelopers({ limit: 20, offset: 0 });
+   * console.log('Total developers:', developers.count);
+   * ```
+   */
+  async listDevelopers(payload) {
+    return this.sdk.request("thirdParty:listDevelopers", payload);
+  }
+  /**
+   * Get developer details by ID
+   * Requires permission: `thirdParty:getDeveloper` or `thirdParty:*`
+   *
+   * @param payload.id - Developer ID
+   * @returns Developer details
+   *
+   * @example
+   * ```typescript
+   * const developer = await sdk.getThirdParty().getDeveloper({ id: 123 });
+   * console.log('Developer:', developer.name);
+   * ```
+   */
+  async getDeveloper(payload) {
+    return this.sdk.request("thirdParty:getDeveloper", payload);
+  }
+  /**
+   * Update developer information
+   * Requires permission: `thirdParty:updateDeveloper` or `thirdParty:*`
+   *
+   * @param payload.id - Developer ID
+   * @param payload.data - Update data
+   * @returns Updated developer
+   *
+   * @example
+   * ```typescript
+   * const developer = await sdk.getThirdParty().updateDeveloper({
+   *   id: 123,
+   *   data: { name: 'New Name', website: 'https://example.com' }
+   * });
+   * ```
+   */
+  async updateDeveloper(payload) {
+    return this.sdk.request("thirdParty:updateDeveloper", payload);
+  }
+  /**
+   * Rotate developer API key
+   * Requires permission: `thirdParty:rotateDeveloperApiKey` or `thirdParty:*`
+   *
+   * Note: The new API key is only shown once in the response
+   *
+   * @param payload.id - Developer ID
+   * @returns Response containing the new API key
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.getThirdParty().rotateDeveloperApiKey({ id: 123 });
+   * console.log('New API key:', result.apiKey);
+   * // Store this key securely - it won't be shown again!
+   * ```
+   */
+  async rotateDeveloperApiKey(payload) {
+    return this.sdk.request("thirdParty:rotateDeveloperApiKey", payload);
+  }
+  // ===========================================================================
+  // App Methods
+  // ===========================================================================
+  /**
+   * List registered apps (paginated)
+   * Requires permission: `thirdParty:listApps` or `thirdParty:*`
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @param payload.developerId - Filter by developer ID
+   * @returns Paginated response of apps
+   *
+   * @example
+   * ```typescript
+   * const apps = await sdk.getThirdParty().listApps({ limit: 20, offset: 0 });
+   * console.log('Total apps:', apps.count);
+   *
+   * // Filter by developer
+   * const devApps = await sdk.getThirdParty().listApps({ developerId: 123 });
+   * ```
+   */
+  async listApps(payload) {
+    return this.sdk.request("thirdParty:listApps", payload);
+  }
+  /**
+   * Register a new app
+   * Requires permission: `thirdParty:createApp` or `thirdParty:*`
+   *
+   * Note: App name, description, and icon are automatically fetched from the URL's metadata
+   *
+   * @param payload - App creation payload with URL
+   * @returns Created app
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().createApp({
+   *   url: 'https://myapp.example.com'
+   * });
+   * console.log('Created app:', app.id, app.name);
+   * ```
+   */
+  async createApp(payload) {
+    return this.sdk.request("thirdParty:createApp", payload);
+  }
+  /**
+   * Get app details by ID
+   * Requires permission: `thirdParty:getApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   * @returns App details
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().getApp({ id: 123 });
+   * console.log('App:', app.name, app.status);
+   * ```
+   */
+  async getApp(payload) {
+    return this.sdk.request("thirdParty:getApp", payload);
+  }
+  /**
+   * Update an app
+   * Requires permission: `thirdParty:updateApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   * @param payload.data - Update data
+   * @returns Updated app
+   *
+   * @example
+   * ```typescript
+   * const app = await sdk.getThirdParty().updateApp({
+   *   id: 123,
+   *   data: { name: 'Updated App Name', description: 'New description' }
+   * });
+   * ```
+   */
+  async updateApp(payload) {
+    return this.sdk.request("thirdParty:updateApp", payload);
+  }
+  /**
+   * Request app deactivation
+   * Requires permission: `thirdParty:deleteApp` or `thirdParty:*`
+   *
+   * @param payload.id - App ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getThirdParty().deleteApp({ id: 123 });
+   * ```
+   */
+  async deleteApp(payload) {
+    return this.sdk.request("thirdParty:deleteApp", payload);
+  }
+  // ===========================================================================
+  // Webhook Methods
+  // ===========================================================================
+  /**
+   * List webhooks (paginated)
+   * Requires permission: `thirdParty:listWebhooks` or `thirdParty:*`
+   *
+   * Note: Maximum 3 webhooks per developer account
+   *
+   * @param payload.limit - Maximum number of results to return
+   * @param payload.offset - Offset into the result set
+   * @param payload.developerId - Filter by developer ID
+   * @returns Paginated response of webhooks
+   *
+   * @example
+   * ```typescript
+   * const webhooks = await sdk.getThirdParty().listWebhooks({ limit: 10, offset: 0 });
+   * console.log('Total webhooks:', webhooks.count);
+   *
+   * // Filter by developer
+   * const devWebhooks = await sdk.getThirdParty().listWebhooks({ developerId: 123 });
+   * ```
+   */
+  async listWebhooks(payload) {
+    return this.sdk.request("thirdParty:listWebhooks", payload);
+  }
+  /**
+   * Create a new webhook
+   * Requires permission: `thirdParty:createWebhook` or `thirdParty:*`
+   *
+   * Note: New webhooks require admin approval before going live
+   *
+   * @param payload - Webhook creation payload
+   * @returns Created webhook
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().createWebhook({
+   *   url: 'https://myapp.example.com/webhooks',
+   *   events: ['app.approved', 'user.registered']
+   * });
+   * console.log('Created webhook:', webhook.id);
+   * ```
+   */
+  async createWebhook(payload) {
+    return this.sdk.request("thirdParty:createWebhook", payload);
+  }
+  /**
+   * Get webhook details by ID
+   * Requires permission: `thirdParty:getWebhook` or `thirdParty:*`
+   *
+   * @param payload.id - Webhook ID
+   * @returns Webhook details
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().getWebhook({ id: 123 });
+   * console.log('Webhook:', webhook.url, webhook.status);
+   * ```
+   */
+  async getWebhook(payload) {
+    return this.sdk.request("thirdParty:getWebhook", payload);
+  }
+  /**
+   * Update a webhook
+   * Requires permission: `thirdParty:updateWebhook` or `thirdParty:*`
+   *
+   * Note: Config changes require admin approval before going live
+   *
+   * @param payload.id - Webhook ID
+   * @param payload.data - Update data
+   * @returns Updated webhook
+   *
+   * @example
+   * ```typescript
+   * const webhook = await sdk.getThirdParty().updateWebhook({
+   *   id: 123,
+   *   data: { url: 'https://newurl.example.com/webhooks' }
+   * });
+   * ```
+   */
+  async updateWebhook(payload) {
+    return this.sdk.request("thirdParty:updateWebhook", payload);
+  }
+  /**
+   * Delete a webhook
+   * Requires permission: `thirdParty:deleteWebhook` or `thirdParty:*`
+   *
+   * @param payload.id - Webhook ID
+   *
+   * @example
+   * ```typescript
+   * await sdk.getThirdParty().deleteWebhook({ id: 123 });
+   * ```
+   */
+  async deleteWebhook(payload) {
+    return this.sdk.request("thirdParty:deleteWebhook", payload);
+  }
+  /**
+   * Rotate webhook signing key
+   * Requires permission: `thirdParty:rotateWebhookSigningKey` or `thirdParty:*`
+   *
+   * Note: The new signing public key is returned in the response
+   *
+   * @param payload.id - Webhook ID
+   * @returns Response containing the new signing public key
+   *
+   * @example
+   * ```typescript
+   * const result = await sdk.getThirdParty().rotateWebhookSigningKey({ id: 123 });
+   * console.log('New signing key:', result.signingPublicKey);
+   * ```
+   */
+  async rotateWebhookSigningKey(payload) {
+    return this.sdk.request("thirdParty:rotateWebhookSigningKey", payload);
+  }
+};
+
 // src/sdk.ts
 var FrontierSDK = class {
   constructor() {
@@ -707,6 +997,7 @@ var FrontierSDK = class {
     this.chain = new ChainAccess(this);
     this.user = new UserAccess(this);
     this.partnerships = new PartnershipsAccess(this);
+    this.thirdParty = new ThirdPartyAccess(this);
     window.addEventListener("message", this.handleMessage);
     this.notifyReady();
   }
@@ -761,6 +1052,12 @@ var FrontierSDK = class {
   getPartnerships() {
     return this.partnerships;
   }
+  /**
+   * Get third-party access instance
+   */
+  getThirdParty() {
+    return this.thirdParty;
+  }
   /**
    * Cleanup: Remove event listeners
    * Call this when your app is being destroyed
@@ -776,6 +1073,7 @@ export {
   PartnershipsAccess,
   StorageAccess,
   SwapResultStatus,
+  ThirdPartyAccess,
   UserAccess,
   WalletAccess,
   createStandaloneHTML,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@frontiertower/frontier-sdk",
-  "version": "0.5.0",
+  "version": "0.7.0",
   "description": "SDK for building apps on Frontier Wallet",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",