@sails-pay/bachs 0.0.1 → 0.0.2

package/adapter.js

@@ -4,6 +4,9 @@ module.exports = {
   identity: 'sails-bachs',
   config: {},
   checkout: methods.checkout,
+  customer: {
+    portal: methods.customer.portal
+  },
   verify: methods.verify,
   webhooks: {
     verify: methods.webhooks.verify

package/machines/customer/portal.js

@@ -0,0 +1,57 @@
+const fetch = require('../../helpers/fetch')
+const parameters = require('../../helpers/parameters')
+
+module.exports = require('machine').build({
+  friendlyName: 'Create customer portal session',
+  description:
+    'Creates a fresh Bachs customer portal session and returns its hosted URL.',
+  moreInfoUrl:
+    'https://docs.bachs.io/guides/customer-portal/create-portal-session',
+  inputs: {
+    apiKey: parameters.BACHS_API_KEY,
+    baseUrl: parameters.BACHS_BASE_URL,
+    customerId: {
+      type: 'string',
+      required: true,
+      description: 'The Bachs customer ID.'
+    }
+  },
+  exits: {
+    success: {
+      description: 'The fresh customer portal URL.',
+      outputVariableName: 'portalUrl',
+      outputType: 'string'
+    },
+    couldNotCreatePortalUrl: {
+      description: 'Customer portal URL could not be created.',
+      outputVariableName: 'errors',
+      outputType: 'ref'
+    }
+  },
+  fn: async function ({ apiKey, baseUrl, customerId }, exits) {
+    const adapterConfig = require('../../adapter').config
+
+    try {
+      const portalSession = await fetch(
+        `/customers/${encodeURIComponent(customerId)}/portal-sessions`,
+        {
+          method: 'POST',
+          apiKey: apiKey || adapterConfig.apiKey,
+          baseUrl: baseUrl || adapterConfig.baseUrl
+        }
+      )
+
+      if (
+        !portalSession ||
+        typeof portalSession.url !== 'string' ||
+        portalSession.url.length === 0
+      ) {
+        return exits.couldNotCreatePortalUrl(portalSession)
+      }
+
+      return exits.success(portalSession.url)
+    } catch (error) {
+      return exits.couldNotCreatePortalUrl(error.bachs || error)
+    }
+  }
+})

package/machines/index.js

@@ -4,6 +4,9 @@ checkout.get = require('./checkout/get')
 
 module.exports = {
   checkout,
+  customer: {
+    portal: require('./customer/portal')
+  },
   verify: require('./verify'),
   webhooks: {
     verify: require('./webhooks/verify')

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sails-pay/bachs",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "Bachs adapter for Sails Pay",
   "main": "adapter.js",
   "scripts": {

package/test/customer.test.js

@@ -0,0 +1,183 @@
+const { test, afterEach } = require('node:test')
+const assert = require('node:assert/strict')
+const adapter = require('../adapter')
+const fetch = require('../helpers/fetch')
+
+afterEach(() => {
+  adapter.config = {}
+  fetch.resetFetchImplementation()
+})
+
+test('customer.portal creates a fresh sandbox portal session without a body', async () => {
+  const calls = []
+
+  fetch.setFetchImplementation(async (url, options) => {
+    calls.push({ url, options })
+
+    return {
+      ok: true,
+      status: 201,
+      statusText: 'Created',
+      text: async () =>
+        JSON.stringify({
+          id: `psn_${calls.length}`,
+          url: `https://portal.bachs.io/s/${calls.length}`
+        })
+    }
+  })
+
+  const firstPortalUrl = await adapter.customer.portal({
+    apiKey: 'sk_sandbox_123',
+    customerId: 'cust_123'
+  })
+  const secondPortalUrl = await adapter.customer.portal({
+    apiKey: 'sk_sandbox_123',
+    customerId: 'cust_123'
+  })
+
+  assert.equal(typeof adapter.customer.portal, 'function')
+  assert.equal(firstPortalUrl, 'https://portal.bachs.io/s/1')
+  assert.equal(secondPortalUrl, 'https://portal.bachs.io/s/2')
+  assert.equal(calls.length, 2)
+
+  for (const call of calls) {
+    assert.equal(
+      call.url,
+      'https://sandbox-api.bachs.io/v1/customers/cust_123/portal-sessions'
+    )
+    assert.equal(call.options.method, 'POST')
+    assert.equal(call.options.headers.Authorization, 'Bearer sk_sandbox_123')
+    assert.equal(Object.hasOwn(call.options, 'body'), false)
+  }
+})
+
+test('customer.portal falls back to adapter configuration', async () => {
+  const calls = []
+  adapter.config = {
+    apiKey: 'sk_live_configured',
+    baseUrl: 'https://configured.example'
+  }
+
+  fetch.setFetchImplementation(async (url, options) => {
+    calls.push({ url, options })
+
+    return {
+      ok: true,
+      status: 201,
+      statusText: 'Created',
+      text: async () =>
+        JSON.stringify({
+          id: 'psn_configured',
+          url: 'https://portal.bachs.io/s/configured'
+        })
+    }
+  })
+
+  const portalUrl = await adapter.customer.portal({
+    customerId: 'cust_configured'
+  })
+
+  assert.equal(portalUrl, 'https://portal.bachs.io/s/configured')
+  assert.equal(
+    calls[0].url,
+    'https://configured.example/v1/customers/cust_configured/portal-sessions'
+  )
+  assert.equal(
+    calls[0].options.headers.Authorization,
+    'Bearer sk_live_configured'
+  )
+})
+
+test('customer.portal input credentials override adapter configuration', async () => {
+  const calls = []
+  adapter.config = {
+    apiKey: 'sk_live_configured',
+    baseUrl: 'https://configured.example'
+  }
+
+  fetch.setFetchImplementation(async (url, options) => {
+    calls.push({ url, options })
+
+    return {
+      ok: true,
+      status: 201,
+      statusText: 'Created',
+      text: async () =>
+        JSON.stringify({
+          id: 'psn_override',
+          url: 'https://portal.bachs.io/s/override'
+        })
+    }
+  })
+
+  await adapter.customer.portal({
+    apiKey: 'sk_sandbox_override',
+    baseUrl: 'https://override.example/api',
+    customerId: 'cust/override'
+  })
+
+  assert.equal(
+    calls[0].url,
+    'https://override.example/v1/customers/cust%2Foverride/portal-sessions'
+  )
+  assert.equal(
+    calls[0].options.headers.Authorization,
+    'Bearer sk_sandbox_override'
+  )
+})
+
+test('customer.portal rejects a malformed success response', async () => {
+  fetch.setFetchImplementation(async () => ({
+    ok: true,
+    status: 201,
+    statusText: 'Created',
+    text: async () => JSON.stringify({ id: 'psn_without_url' })
+  }))
+
+  await assert.rejects(
+    () =>
+      adapter.customer.portal({
+        apiKey: 'sk_sandbox_123',
+        customerId: 'cust_123'
+      }),
+    (error) => {
+      assert.equal(error.exit, 'couldNotCreatePortalUrl')
+      assert.deepEqual(error.raw, { id: 'psn_without_url' })
+      return true
+    }
+  )
+})
+
+for (const statusCode of [401, 403, 404, 429, 500, 503]) {
+  test(`customer.portal normalizes Bachs ${statusCode} responses`, async () => {
+    fetch.setFetchImplementation(async () => ({
+      ok: false,
+      status: statusCode,
+      statusText: 'Request failed',
+      text: async () =>
+        JSON.stringify({
+          detail: `Portal request failed with ${statusCode}`,
+          error_code: `STATUS_${statusCode}`
+        })
+    }))
+
+    await assert.rejects(
+      () =>
+        adapter.customer.portal({
+          apiKey: 'sk_sandbox_123',
+          customerId: 'cust_123'
+        }),
+      (error) => {
+        assert.equal(error.exit, 'couldNotCreatePortalUrl')
+        assert.equal(error.raw.statusCode, statusCode)
+        assert.equal(error.raw.statusText, 'Request failed')
+        assert.equal(error.raw.code, `STATUS_${statusCode}`)
+        assert.equal(
+          error.raw.message,
+          `Portal request failed with ${statusCode}`
+        )
+        return true
+      }
+    )
+  })
+}