c187fabf92
* feat(shopify): Shopify order/refund feed into the transactions inbox
New extensions/general/shopify feed extension, modeled on the WooCommerce
feed: connect a Shopify store with Dev Dashboard custom-app client
credentials (client credentials grant, ~24h tokens, never stored), then a
nightly cron + manual sync imports paid orders and refunds via the GraphQL
Admin API (pinned 2026-07) into the transactions inbox on clearing account
1584. Feed-only: nothing auto-books. Zero PII fields are queried, keeping
the app outside Shopify's protected customer data program.
- shopify_connections migration (RLS, revoke-never-delete, encrypted
client id/secret) + shopify_sync capability and bank_sync-mirrored
backfill
- frozen external_id scheme shopify_{shop_domain}_order|refund_{id},
scoped on the shop domain so reconnects never re-import
- cursor sync on updated_at windows with 24h overlap, lock-date drop at
map time, ingest-failure cursor floor, deadline stop-and-resume,
revoked-credential flip
- /import card + settings panel, sv/en i18n, cron 03:15 in vercel.json +
regenerated Docker crontabs, logo, events, panel registry
- 65 unit tests + pg-real RLS test; extensions.schema.json enum also
gains the missing stripe entry (pre-existing drift)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
* fix(shopify): review findings from PR 1474
- token exchange: a 429 that survives every retry is throttling, not a
credential failure; stop remapping retryable 4xx to 401 so sustained
throttling can no longer flip the connection to revoked and delete the
stored credentials (CodeRabbit critical)
- order sync: advance a scanned-through watermark (run start, capped by
the failure floor) after a fully-listed window, so empty first runs and
quiet stores rotate to the back of the cron's oldest-first selection
instead of permanently occupying the 50-connection batch (CodeRabbit
major, starvation)
- add handler-level tests for the orders cron route (auth 401, disabled
503, unconfigured no-op, query failure, capability skip, happy path,
per-connection failure isolation, revoked marking)
- add 401 tests for /sync, /transaction-sync and /disconnect; pin the
cursor floor rule with a two-order page; stub the encryption key via
vi.stubEnv
- note in the panel description (sv/en) that orders can mix VAT rates and
must be split at booking (Swedish review advisory)
- DECISIONS.md: wrap underscore identifiers in backticks (MD037)
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
---------
Co-authored-by: Claude Fable 5 <noreply@anthropic.com>
62 lines
2.4 KiB
TypeScript
62 lines
2.4 KiB
TypeScript
import crypto from 'crypto'
|
|
|
|
/**
|
|
* At-rest encryption for Shopify custom-app client id/secret.
|
|
*
|
|
* AES-256-GCM with a dedicated env key, mirroring the WooCommerce credential
|
|
* store (extensions/general/woocommerce/lib/credentials.ts) and the
|
|
* Skatteverket token store: 12-byte IV, 16-byte auth tag, layout
|
|
* iv|tag|ciphertext, base64url encoded. The key is deployment-wide (not
|
|
* per-tenant); what makes rows useless off-server is that
|
|
* SHOPIFY_CREDENTIALS_ENCRYPTION_KEY never leaves the environment.
|
|
*/
|
|
|
|
const ALGORITHM = 'aes-256-gcm'
|
|
|
|
/** Whether the integration is configured on this deployment. */
|
|
export function isShopifyConfigured(): boolean {
|
|
return Boolean(process.env.SHOPIFY_CREDENTIALS_ENCRYPTION_KEY)
|
|
}
|
|
|
|
function getEncryptionKey(): Buffer {
|
|
const key = process.env.SHOPIFY_CREDENTIALS_ENCRYPTION_KEY
|
|
if (!key) throw new Error('SHOPIFY_CREDENTIALS_ENCRYPTION_KEY is required')
|
|
return crypto.createHash('sha256').update(key).digest()
|
|
}
|
|
|
|
export function encryptCredential(plaintext: string): string {
|
|
const key = getEncryptionKey()
|
|
const iv = crypto.randomBytes(12)
|
|
const cipher = crypto.createCipheriv(ALGORITHM, key, iv)
|
|
const encrypted = Buffer.concat([cipher.update(plaintext, 'utf8'), cipher.final()])
|
|
const tag = cipher.getAuthTag()
|
|
return Buffer.concat([iv, tag, encrypted]).toString('base64url')
|
|
}
|
|
|
|
export function decryptCredential(ciphertext: string): string {
|
|
const key = getEncryptionKey()
|
|
const combined = Buffer.from(ciphertext, 'base64url')
|
|
const iv = combined.subarray(0, 12)
|
|
const tag = combined.subarray(12, 28)
|
|
const encrypted = combined.subarray(28)
|
|
const decipher = crypto.createDecipheriv(ALGORITHM, key, iv)
|
|
decipher.setAuthTag(tag)
|
|
return Buffer.concat([decipher.update(encrypted), decipher.final()]).toString('utf8')
|
|
}
|
|
|
|
/** Decrypted API credentials for an active connection. */
|
|
export function credentialsOf(connection: {
|
|
shop_domain: string
|
|
client_id_encrypted: string | null
|
|
client_secret_encrypted: string | null
|
|
}): { shopDomain: string; clientId: string; clientSecret: string } {
|
|
if (!connection.client_id_encrypted || !connection.client_secret_encrypted) {
|
|
throw new Error('Connection has no stored credentials')
|
|
}
|
|
return {
|
|
shopDomain: connection.shop_domain,
|
|
clientId: decryptCredential(connection.client_id_encrypted),
|
|
clientSecret: decryptCredential(connection.client_secret_encrypted),
|
|
}
|
|
}
|