shutro-erp 0.3.2 → 0.3.4

package/dist/l10n_in/module.d.ts

@@ -51,37 +51,6 @@ export declare const CompanyGst: import("../server/orm.js").Extension<"res.compa
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
-    /** Its principal place of business: the seller's address on e-invoices and e-way bills. */
-    readonly street: import("../server/orm.js").CharField<{
-        readonly required: false;
-        readonly computed: false;
-        readonly inverse: false;
-        readonly sequence: false;
-        readonly computeName: undefined;
-        readonly store: true;
-        readonly hasDefault: false;
-        readonly readonly: false;
-    }, string>;
-    readonly city: import("../server/orm.js").CharField<{
-        readonly required: false;
-        readonly computed: false;
-        readonly inverse: false;
-        readonly sequence: false;
-        readonly computeName: undefined;
-        readonly store: true;
-        readonly hasDefault: false;
-        readonly readonly: false;
-    }, string>;
-    readonly zip: import("../server/orm.js").CharField<{
-        readonly required: false;
-        readonly computed: false;
-        readonly inverse: false;
-        readonly sequence: false;
-        readonly computeName: undefined;
-        readonly store: true;
-        readonly hasDefault: false;
-        readonly readonly: false;
-    }, string>;
     /** Customer invoices and notes are registered with the IRP when posted (turnover above the threshold). */
     readonly einvoiceEnabled: import("../server/orm.js").ScalarField<"boolean", boolean, boolean, {
         readonly required: true;
@@ -7506,37 +7475,6 @@ export declare const l10nInShutro: import("../server/orm.js").Module<readonly [i
         readonly hasDefault: false;
         readonly readonly: false;
     }, string>;
-    /** Its principal place of business: the seller's address on e-invoices and e-way bills. */
-    readonly street: import("../server/orm.js").CharField<{
-        readonly required: false;
-        readonly computed: false;
-        readonly inverse: false;
-        readonly sequence: false;
-        readonly computeName: undefined;
-        readonly store: true;
-        readonly hasDefault: false;
-        readonly readonly: false;
-    }, string>;
-    readonly city: import("../server/orm.js").CharField<{
-        readonly required: false;
-        readonly computed: false;
-        readonly inverse: false;
-        readonly sequence: false;
-        readonly computeName: undefined;
-        readonly store: true;
-        readonly hasDefault: false;
-        readonly readonly: false;
-    }, string>;
-    readonly zip: import("../server/orm.js").CharField<{
-        readonly required: false;
-        readonly computed: false;
-        readonly inverse: false;
-        readonly sequence: false;
-        readonly computeName: undefined;
-        readonly store: true;
-        readonly hasDefault: false;
-        readonly readonly: false;
-    }, string>;
     /** Customer invoices and notes are registered with the IRP when posted (turnover above the threshold). */
     readonly einvoiceEnabled: import("../server/orm.js").ScalarField<"boolean", boolean, boolean, {
         readonly required: true;

package/dist/l10n_in/module.js

@@ -101,10 +101,8 @@ export const CompanyGst = extendModel('res.company', {
     fields: {
         gstin: f.char({ size: 15, label: 'GSTIN' }),
         pan: f.char({ size: 10, label: 'PAN' }),
-        /** Its principal place of business: the seller's address on e-invoices and e-way bills. */
-        street: f.char({ label: 'Address' }),
-        city: f.char({ label: 'City' }),
-        zip: f.char({ size: 6, label: 'PIN code' }),
+        // Its principal place of business (`street`, `city`, `zip`: the base's company address) is the seller's
+        // address on e-invoices and e-way bills.
         /** Customer invoices and notes are registered with the IRP when posted (turnover above the threshold). */
         einvoiceEnabled: f.boolean({ required: true, default: false, label: 'E-invoicing' }),
     },

package/dist/messaging/web/index.js

@@ -16,7 +16,7 @@ export { Chatter } from './Chatter.js';
 export function registerMessagingWeb(registry, i18n) {
     registry.registerComponent('chatter', Chatter);
     registry.registerPage('messaging.Chat', ChatPage);
-    registry.registerHeaderItem('messaging.Dock', ChatDock);
+    registry.registerHeaderItem('messaging.Dock', ChatDock, { home: true });
     if (i18n !== undefined)
         addMessages(i18n, 'messaging', messages);
     return registry;

package/dist/notify/web/index.js

@@ -10,7 +10,7 @@ export { NotificationSettings } from './NotificationSettings.js';
 export { usePush } from './push.js';
 /** Registers the bell (and its messages in `i18n`, when given). */
 export function registerNotifyWeb(registry, i18n) {
-    registry.registerHeaderItem('notify.Bell', NotificationBell);
+    registry.registerHeaderItem('notify.Bell', NotificationBell, { home: true });
     if (i18n !== undefined)
         addMessages(i18n, 'notify', messages);
     return registry;

package/dist/payment/.kosh/bindings.js

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 51b637962c6e5497
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 7de15337289f5e89
 // Bindings of module `payment`: import the definition API from here to get types scoped to what it can see.
 export { defineModel, defineModule, extendModel, f, replace } from '../../server/orm.js';
 import { definitions } from '../../server/orm.js';

package/dist/payment/.kosh/schema.d.ts

@@ -1,4 +1,4 @@
-// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 51b637962c6e5497
+// GENERATED by `pnpm generate:models` (Shutro’s generator). Do not edit. definitions-hash: 7de15337289f5e89
 // Schema view of module `payment` (RFC 0002 §7.7): the models it owns or depends on, with the extensions it can see.
 import type { F } from '../../server/orm.js';
 
@@ -24,9 +24,11 @@ export interface SchemaView {
   readonly 'audit.event': AuditEvent;
   readonly 'auth.api_key': AuthApiKey;
   readonly 'auth.credential': AuthCredential;
+  readonly 'auth.policy': AuthPolicy;
   readonly 'auth.session': AuthSession;
   readonly 'auth.user_grant': AuthUserGrant;
   readonly 'auth.user_group': AuthUserGroup;
+  readonly 'kosh.image': KoshImage;
   readonly 'kosh.saved_view': KoshSavedView;
   readonly 'mail.activity': MailActivity;
   readonly 'mail.activity.type': MailActivityType;
@@ -35,6 +37,10 @@ export interface SchemaView {
   readonly 'mail.follower': MailFollower;
   readonly 'mail.message': MailMessage;
   readonly 'mail.message.reaction': MailMessageReaction;
+  readonly 'oauth.app': OauthApp;
+  readonly 'oauth.code': OauthCode;
+  readonly 'oauth.grant': OauthGrant;
+  readonly 'oauth.token': OauthToken;
   readonly 'payment.provider': PaymentProvider;
   readonly 'payment.transaction': PaymentTransaction;
   readonly 'portal.announcement': PortalAnnouncement;
@@ -640,6 +646,26 @@ export interface AuthCredential {
 export interface AuthCredentialMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'auth.credential'> {
 }
 
+/** `auth.policy` (owner: base). */
+export interface AuthPolicy {
+  readonly name: 'auth.policy';
+  readonly fields: {
+    readonly id: F.Id<'auth.policy'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly twoFactor: F.Selection<'administrators' | 'everyone', { readonly required: true; readonly default: true }>;
+    readonly sessionDays: F.Integer;
+  };
+  readonly methods: AuthPolicyMethods;
+}
+
+/** Methods of `auth.policy`: declared ones and transitions. */
+export interface AuthPolicyMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'auth.policy'> {
+}
+
 /** `auth.session` (owner: base). */
 export interface AuthSession {
   readonly name: 'auth.session';
@@ -712,6 +738,29 @@ export interface AuthUserGroup {
 export interface AuthUserGroupMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'auth.user_group'> {
 }
 
+/** `kosh.image` (owner: base). */
+export interface KoshImage {
+  readonly name: 'kosh.image';
+  readonly fields: {
+    readonly id: F.Id<'kosh.image'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly ownerModel: F.Char<{ readonly required: true }>;
+    readonly ownerId: F.Integer<{ readonly required: true }>;
+    readonly mime: F.Char<{ readonly required: true }>;
+    readonly data: F.Text<{ readonly required: true }>;
+    readonly hash: F.Char<{ readonly required: true }>;
+  };
+  readonly methods: KoshImageMethods;
+}
+
+/** Methods of `kosh.image`: declared ones and transitions. */
+export interface KoshImageMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'kosh.image'> {
+}
+
 /** `kosh.saved_view` (owner: base). */
 export interface KoshSavedView {
   readonly name: 'kosh.saved_view';
@@ -914,6 +963,105 @@ export interface MailMessageReaction {
 export interface MailMessageReactionMethods extends F.Methods<typeof import('../../messaging/index.js').messagingShutro, 'mail.message.reaction'> {
 }
 
+/** `oauth.app` (owner: base). */
+export interface OauthApp {
+  readonly name: 'oauth.app';
+  readonly fields: {
+    readonly id: F.Id<'oauth.app'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly name: F.Char<{ readonly required: true }>;
+    readonly clientId: F.Char<{ readonly required: true }>;
+    readonly secretHash: F.Char;
+    readonly confidential: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly redirectUris: F.Text<{ readonly required: true }>;
+    readonly scopes: F.Char<{ readonly required: true }>;
+    readonly homepage: F.Char;
+    readonly active: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly owner: F.Many2one<'res.users'>;
+  };
+  readonly methods: OauthAppMethods;
+}
+
+/** Methods of `oauth.app`: declared ones and transitions. */
+export interface OauthAppMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.app'> {
+}
+
+/** `oauth.code` (owner: base). */
+export interface OauthCode {
+  readonly name: 'oauth.code';
+  readonly fields: {
+    readonly id: F.Id<'oauth.code'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly codeHash: F.Char<{ readonly required: true }>;
+    readonly grant: F.Many2one<'oauth.grant', { readonly required: true }>;
+    readonly redirectUri: F.Char<{ readonly required: true }>;
+    readonly challenge: F.Char;
+    readonly expiresAt: F.Datetime<{ readonly required: true }>;
+    readonly used: F.Bool<{ readonly required: true; readonly default: true }>;
+  };
+  readonly methods: OauthCodeMethods;
+}
+
+/** Methods of `oauth.code`: declared ones and transitions. */
+export interface OauthCodeMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.code'> {
+}
+
+/** `oauth.grant` (owner: base). */
+export interface OauthGrant {
+  readonly name: 'oauth.grant';
+  readonly fields: {
+    readonly id: F.Id<'oauth.grant'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly user: F.Many2one<'res.users', { readonly required: true }>;
+    readonly app: F.Many2one<'oauth.app', { readonly required: true }>;
+    readonly scopes: F.Char<{ readonly required: true }>;
+    readonly revoked: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly lastUsedAt: F.Datetime;
+  };
+  readonly methods: OauthGrantMethods;
+}
+
+/** Methods of `oauth.grant`: declared ones and transitions. */
+export interface OauthGrantMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.grant'> {
+}
+
+/** `oauth.token` (owner: base). */
+export interface OauthToken {
+  readonly name: 'oauth.token';
+  readonly fields: {
+    readonly id: F.Id<'oauth.token'>;
+    readonly createdAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly updatedAt: F.Datetime<{ readonly required: true; readonly readonly: true }>;
+    readonly createdBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly updatedBy: F.Many2one<'res.users', { readonly readonly: true }>;
+    readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
+    readonly grant: F.Many2one<'oauth.grant', { readonly required: true }>;
+    readonly accessHash: F.Char<{ readonly required: true }>;
+    readonly refreshHash: F.Char<{ readonly required: true }>;
+    readonly accessExpiresAt: F.Datetime<{ readonly required: true }>;
+    readonly refreshExpiresAt: F.Datetime<{ readonly required: true }>;
+    readonly revoked: F.Bool<{ readonly required: true; readonly default: true }>;
+    readonly rotated: F.Bool<{ readonly required: true; readonly default: true }>;
+  };
+  readonly methods: OauthTokenMethods;
+}
+
+/** Methods of `oauth.token`: declared ones and transitions. */
+export interface OauthTokenMethods extends F.Methods<typeof import('../../server/index.js').baseShutro, 'oauth.token'> {
+}
+
 /** `payment.provider` (owner: payment). */
 export interface PaymentProvider {
   readonly name: 'payment.provider';
@@ -926,7 +1074,7 @@ export interface PaymentProvider {
     readonly displayName: F.Char<{ readonly required: true; readonly readonly: true; readonly compute: true }>;
     readonly company: F.Many2one<'res.company', { readonly required: true; readonly default: true }>;
     readonly name: F.Char<{ readonly required: true }>;
-    readonly code: F.Selection<'fake' | 'sslcommerz', { readonly required: true; readonly default: true }>;
+    readonly code: F.Selection<'fake' | 'sslcommerz' | 'bkash' | 'razorpay' | 'stripe', { readonly required: true; readonly default: true }>;
     readonly state: F.Selection<'disabled' | 'test' | 'live', { readonly required: true; readonly default: true }>;
     readonly journal: F.Many2one<'account.journal', { readonly required: true }>;
     readonly endpoint: F.Many2one<'webhook.endpoint'>;
@@ -1261,6 +1409,13 @@ export interface ResCompany {
     readonly name: F.Char<{ readonly required: true }>;
     readonly currency: F.Many2one<'res.currency', { readonly required: true }>;
     readonly numberGrouping: F.Selection<'international' | 'lakh', { readonly required: true; readonly default: true }>;
+    readonly accentColor: F.Char;
+    readonly street: F.Char;
+    readonly city: F.Char;
+    readonly zip: F.Char;
+    readonly email: F.Char;
+    readonly phone: F.Char;
+    readonly website: F.Char;
     readonly fiscalYearStart: F.Integer<{ readonly required: true; readonly default: true }>; // accounting
     readonly chartTemplate: F.Char; // accounting
     readonly country: F.Char; // accounting

package/dist/payment/bkash.d.ts

@@ -0,0 +1,28 @@
+/**
+ * The bKash adapter (Tokenized Checkout v2; RFC 0017 §5.5). Grant a token (cached for its hour), create a payment
+ * (its `paymentId` kept as the transaction's provider reference) and send the customer to `bkashURL`. bKash has no
+ * server-to-server callback here: it sends the customer back to the return URL with `paymentID` and
+ * `status=success|failure|cancel`, and the payment completes only when the merchant **executes** it. The browser's
+ * status is a hint, never proof: on any return the adapter executes the transaction's own `paymentId` (never the
+ * one in the URL) and believes only bKash's answer — `Completed`, for this invoice number, amount and currency — or,
+ * when execute refuses, bKash's query.
+ *
+ * Credentials come from the environment, never from records: `SHUTRO_ERP_BKASH_USERNAME`, `…_PASSWORD`,
+ * `…_APP_KEY`, `…_APP_SECRET`, `…_SANDBOX` (`true` unless `false`) and, optionally, `…_BASE_URL`.
+ */
+import type { PaymentAdapter } from './providers.js';
+export interface BkashOptions {
+    readonly username?: string | undefined;
+    readonly password?: string | undefined;
+    readonly appKey?: string | undefined;
+    readonly appSecret?: string | undefined;
+    /** The sandbox (default) or the live system. */
+    readonly sandbox?: boolean;
+    /** The API's base, up to `/tokenized-checkout` (default: bKash's sandbox or live address). */
+    readonly baseUrl?: string | undefined;
+    /** The HTTP client (tests). */
+    readonly fetch?: typeof fetch;
+}
+export declare function bkashAdapter(options?: BkashOptions): PaymentAdapter;
+/** bKash with its credentials from the environment, read on first use. */
+export declare function bkashFromEnvironment(env?: NodeJS.ProcessEnv): PaymentAdapter;

package/dist/payment/bkash.js

@@ -0,0 +1,169 @@
+const BASES = {
+    sandbox: 'https://tokenized.sandbox.bka.sh/v2/tokenized-checkout',
+    live: 'https://tokenized.pay.bka.sh/v2/tokenized-checkout',
+};
+/** bKash's code for executing a payment that is already completed. */
+const ALREADY_COMPLETED = '2062';
+const text = (v) => (v === undefined || v === null ? '' : String(v));
+const same = (a, b) => a !== '' && b !== '' && Number(a).toFixed(2) === Number(b).toFixed(2);
+export function bkashAdapter(options = {}) {
+    const sandbox = options.sandbox ?? true;
+    const base = (options.baseUrl || (sandbox ? BASES.sandbox : BASES.live)).replace(/\/$/, '');
+    const http = options.fetch ?? fetch;
+    const ready = [options.username, options.password, options.appKey, options.appSecret].every((v) => v !== undefined && v !== '');
+    let token = null;
+    const grant = async () => {
+        if (!ready)
+            throw new Error('bKash is not configured: set SHUTRO_ERP_BKASH_USERNAME, _PASSWORD, _APP_KEY and _APP_SECRET.');
+        if (token !== null && token.until > Date.now())
+            return token.value;
+        const res = await http(`${base}/auth/grant-token`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                accept: 'application/json',
+                username: options.username,
+                password: options.password,
+            },
+            body: JSON.stringify({ app_key: options.appKey, app_secret: options.appSecret }),
+            signal: AbortSignal.timeout(30_000),
+        });
+        const answer = (await res.json().catch(() => ({})));
+        const value = text(answer['id_token']);
+        if (value === '')
+            throw new Error(`bKash refused the credentials: ${text(answer['statusMessage']) || res.status}.`);
+        // Kept for its lifetime less five minutes (an hour by default).
+        const seconds = Number(answer['expires_in'] ?? 3600);
+        token = { value, until: Date.now() + Math.max(60, seconds - 300) * 1000 };
+        return value;
+    };
+    const post = async (path, body) => {
+        const res = await http(`${base}${path}`, {
+            method: 'POST',
+            headers: {
+                'content-type': 'application/json',
+                accept: 'application/json',
+                authorization: `Bearer ${await grant()}`,
+                'x-app-key': options.appKey,
+            },
+            body: JSON.stringify(body),
+            signal: AbortSignal.timeout(30_000),
+        });
+        return (await res.json().catch(() => ({})));
+    };
+    /** bKash's word on a payment, checked against the transaction. */
+    const outcome = (reference, answer, expected = {}) => {
+        const status = text(answer['transactionStatus']);
+        const invoice = text(answer['merchantInvoiceNumber'] ?? answer['merchantInvoice']);
+        if (status !== 'Completed')
+            return null;
+        if (invoice !== reference ||
+            (expected.amount !== undefined && !same(text(answer['amount']), expected.amount)))
+            return {
+                reference,
+                status: 'failed',
+                providerReference: text(answer['trxId']) || null,
+                error: `bKash completed payment ${text(answer['paymentId'])} for ${invoice}, not this transaction.`,
+            };
+        return {
+            reference,
+            status: 'done',
+            providerReference: text(answer['trxId']) || null,
+            amount: text(answer['amount']),
+            currency: text(answer['currency']) || 'BDT',
+        };
+    };
+    const query = (paymentId) => post('/query/payment', { paymentId });
+    return {
+        code: 'bkash',
+        configured: (mode) => ready && (mode === 'test') === sandbox,
+        async createPayment(request) {
+            if (request.currency !== 'BDT')
+                throw new Error(`bKash takes payments in BDT only, not ${request.currency}.`);
+            const answer = await post('/payment/create', {
+                payerReference: request.customer.phone ?? request.reference,
+                callbackURL: request.returnUrl,
+                amount: request.amount,
+                currency: 'BDT',
+                intent: 'sale',
+                merchantInvoiceNumber: request.reference,
+            });
+            const paymentId = text(answer['paymentId'] ?? answer['paymentID']);
+            const page = text(answer['bkashURL'] ?? answer['bKashURL']);
+            if (paymentId === '' || page === '')
+                throw new Error(`bKash refused the payment: ${text(answer['errorMessageEn'] ?? answer['statusMessage']) || 'no payment id'}.`);
+            return { redirectUrl: page, providerReference: paymentId };
+        },
+        // No server-to-server callbacks: every call to the endpoint is refused.
+        verifyCallback: () => null,
+        readCallback: () => null,
+        async returned({ reference, providerReference, query: hint }) {
+            if (providerReference === null || providerReference === '')
+                return null;
+            if (hint['status'] === 'success') {
+                // Execute: the payment completes now, or bKash says why not.
+                const executed = await post('/payment/execute', { paymentId: providerReference });
+                const done = outcome(reference, executed);
+                if (done !== null)
+                    return done;
+                const code = text(executed['externalCode'] ?? executed['statusCode']);
+                const known = await query(providerReference);
+                const completed = outcome(reference, known);
+                if (completed !== null)
+                    return completed;
+                if (code === ALREADY_COMPLETED)
+                    return null;
+                return {
+                    reference,
+                    status: 'failed',
+                    providerReference,
+                    error: text(executed['errorMessageEn'] ?? executed['statusMessage']) ||
+                        'bKash did not complete the payment.',
+                };
+            }
+            // Failed or cancelled on bKash's page — unless bKash says it completed.
+            const known = await query(providerReference);
+            const completed = outcome(reference, known);
+            if (completed !== null)
+                return completed;
+            return {
+                reference,
+                status: hint['status'] === 'cancel' ? 'cancelled' : 'failed',
+                providerReference,
+                ...(hint['status'] === 'cancel'
+                    ? {}
+                    : { error: 'The payment was not completed on bKash.' }),
+            };
+        },
+        async status(reference, _mode, providerReference) {
+            if (!ready || providerReference === null || providerReference === '')
+                return null;
+            const known = await query(providerReference);
+            return (outcome(reference, known) ??
+                (text(known['transactionStatus']) === 'Initiated'
+                    ? { reference, status: 'pending', providerReference }
+                    : null));
+        },
+    };
+}
+/** bKash with its credentials from the environment, read on first use. */
+export function bkashFromEnvironment(env = process.env) {
+    let made;
+    const real = () => (made ??= bkashAdapter({
+        username: env['KOSH_BKASH_USERNAME'],
+        password: env['KOSH_BKASH_PASSWORD'],
+        appKey: env['KOSH_BKASH_APP_KEY'],
+        appSecret: env['KOSH_BKASH_APP_SECRET'],
+        sandbox: env['KOSH_BKASH_SANDBOX'] !== 'false',
+        baseUrl: env['KOSH_BKASH_BASE_URL'],
+    }));
+    return {
+        code: 'bkash',
+        configured: (mode) => real().configured(mode),
+        createPayment: (request) => real().createPayment(request),
+        verifyCallback: (call, secret) => real().verifyCallback(call, secret),
+        readCallback: (call) => real().readCallback(call),
+        returned: (input) => real().returned?.(input) ?? Promise.resolve(null),
+        status: (reference, mode, providerReference) => real().status(reference, mode, providerReference),
+    };
+}

package/dist/payment/index.d.ts

@@ -16,10 +16,14 @@
  */
 import { type KoshModule } from '../modules-sdk/index.js';
 import { type PaymentAdapter } from './providers.js';
+export { type BkashOptions, bkashAdapter, bkashFromEnvironment } from './bkash.js';
 export { newReference, PaymentProvider, PaymentTransaction, PROVIDERS, paymentShutro, } from './module.js';
+export { decimalsOf, fromSubunits, toSubunits } from './money.js';
 export { ADAPTERS, FAKE_SIGNATURE, fakeAdapter, type PaymentAdapter, type PaymentRequest, type PaymentResult, type PaymentStatus, } from './providers.js';
+export { type RazorpayOptions, razorpayAdapter, razorpayFromEnvironment } from './razorpay.js';
 export { type Settled, settle } from './settle.js';
 export { type SslcommerzOptions, sslcommerzAdapter, sslcommerzFromEnvironment, } from './sslcommerz.js';
+export { type StripeOptions, stripeAdapter, stripeFromEnvironment } from './stripe.js';
 export interface PaymentOptions {
     /** The adapters by code (tests; default: the fake). */
     readonly adapters?: ReadonlyMap<string, PaymentAdapter>;