@decionis/agentsafe 0.2.5 → 0.4.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +264 -89
- package/dist/Cli.js +24 -0
- package/dist/Cli.js.map +1 -1
- package/dist/Index.d.ts +10 -4
- package/dist/Index.d.ts.map +1 -1
- package/dist/Index.js +8 -2
- package/dist/Index.js.map +1 -1
- package/dist/TrustedExecutor.d.ts.map +1 -1
- package/dist/TrustedExecutor.js +2 -0
- package/dist/TrustedExecutor.js.map +1 -1
- package/dist/adapters/AdapterActionHandler.d.ts.map +1 -1
- package/dist/adapters/AdapterActionHandler.js +8 -4
- package/dist/adapters/AdapterActionHandler.js.map +1 -1
- package/dist/adapters/EffectAdapter.d.ts +6 -1
- package/dist/adapters/EffectAdapter.d.ts.map +1 -1
- package/dist/adapters/EffectAdapter.js +7 -1
- package/dist/adapters/EffectAdapter.js.map +1 -1
- package/dist/adapters/EffectAwareGrantVerifier.d.ts +5 -2
- package/dist/adapters/EffectAwareGrantVerifier.d.ts.map +1 -1
- package/dist/adapters/EffectAwareGrantVerifier.js +9 -0
- package/dist/adapters/EffectAwareGrantVerifier.js.map +1 -1
- package/dist/adapters/banking/BankingAction.d.ts +2 -2
- package/dist/adapters/banking/CoreBankingHttpAdapter.d.ts.map +1 -1
- package/dist/adapters/banking/CoreBankingHttpAdapter.js +4 -4
- package/dist/adapters/banking/CoreBankingHttpAdapter.js.map +1 -1
- package/dist/adapters/cards/CardAuthorizationMatcher.d.ts +44 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.d.ts.map +1 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.js +39 -0
- package/dist/adapters/cards/CardAuthorizationMatcher.js.map +1 -0
- package/dist/adapters/cards/CardEffect.d.ts +52 -0
- package/dist/adapters/cards/CardEffect.d.ts.map +1 -0
- package/dist/adapters/cards/CardEffect.js +117 -0
- package/dist/adapters/cards/CardEffect.js.map +1 -0
- package/dist/adapters/cards/CardHandlers.d.ts +15 -0
- package/dist/adapters/cards/CardHandlers.d.ts.map +1 -0
- package/dist/adapters/cards/CardHandlers.js +26 -0
- package/dist/adapters/cards/CardHandlers.js.map +1 -0
- package/dist/adapters/cards/CardHoldSeal.d.ts +29 -0
- package/dist/adapters/cards/CardHoldSeal.d.ts.map +1 -0
- package/dist/adapters/cards/CardHoldSeal.js +87 -0
- package/dist/adapters/cards/CardHoldSeal.js.map +1 -0
- package/dist/adapters/cards/CardHoldStore.d.ts +102 -0
- package/dist/adapters/cards/CardHoldStore.d.ts.map +1 -0
- package/dist/adapters/cards/CardHoldStore.js +9 -0
- package/dist/adapters/cards/CardHoldStore.js.map +1 -0
- package/dist/adapters/cards/CardHolds.d.ts +19 -0
- package/dist/adapters/cards/CardHolds.d.ts.map +1 -0
- package/dist/adapters/cards/CardHolds.js +57 -0
- package/dist/adapters/cards/CardHolds.js.map +1 -0
- package/dist/adapters/cards/CardPurchase.d.ts +61 -0
- package/dist/adapters/cards/CardPurchase.d.ts.map +1 -0
- package/dist/adapters/cards/CardPurchase.js +116 -0
- package/dist/adapters/cards/CardPurchase.js.map +1 -0
- package/dist/adapters/cards/HeldCardGrants.d.ts +69 -0
- package/dist/adapters/cards/HeldCardGrants.d.ts.map +1 -0
- package/dist/adapters/cards/HeldCardGrants.js +169 -0
- package/dist/adapters/cards/HeldCardGrants.js.map +1 -0
- package/dist/adapters/cards/Pan.d.ts +17 -0
- package/dist/adapters/cards/Pan.d.ts.map +1 -0
- package/dist/adapters/cards/Pan.js +52 -0
- package/dist/adapters/cards/Pan.js.map +1 -0
- package/dist/adapters/cards/PostgresCardHolds.d.ts +95 -0
- package/dist/adapters/cards/PostgresCardHolds.d.ts.map +1 -0
- package/dist/adapters/cards/PostgresCardHolds.js +411 -0
- package/dist/adapters/cards/PostgresCardHolds.js.map +1 -0
- package/dist/adapters/mcp/McpGuard.d.ts.map +1 -1
- package/dist/adapters/mcp/McpGuard.js +9 -4
- package/dist/adapters/mcp/McpGuard.js.map +1 -1
- package/dist/audit/HashChain.d.ts +8 -2
- package/dist/audit/HashChain.d.ts.map +1 -1
- package/dist/audit/HashChain.js +14 -2
- package/dist/audit/HashChain.js.map +1 -1
- package/dist/cli/Cards.d.ts +5 -0
- package/dist/cli/Cards.d.ts.map +1 -0
- package/dist/cli/Cards.js +48 -0
- package/dist/cli/Cards.js.map +1 -0
- package/dist/cli/Commands.d.ts +1 -1
- package/dist/cli/Commands.d.ts.map +1 -1
- package/dist/cli/Commands.js +5 -0
- package/dist/cli/Commands.js.map +1 -1
- package/dist/cli/Edge.d.ts +4 -0
- package/dist/cli/Edge.d.ts.map +1 -0
- package/dist/cli/Edge.js +250 -0
- package/dist/cli/Edge.js.map +1 -0
- package/dist/cli/Help.d.ts.map +1 -1
- package/dist/cli/Help.js +9 -0
- package/dist/cli/Help.js.map +1 -1
- package/dist/cli/Host.d.ts +36 -0
- package/dist/cli/Host.d.ts.map +1 -0
- package/dist/cli/Host.js +247 -0
- package/dist/cli/Host.js.map +1 -0
- package/dist/cli/TcpBrokerCli.d.ts +4 -0
- package/dist/cli/TcpBrokerCli.d.ts.map +1 -0
- package/dist/cli/TcpBrokerCli.js +93 -0
- package/dist/cli/TcpBrokerCli.js.map +1 -0
- package/dist/cli/TcpClientCli.d.ts +16 -0
- package/dist/cli/TcpClientCli.d.ts.map +1 -0
- package/dist/cli/TcpClientCli.js +175 -0
- package/dist/cli/TcpClientCli.js.map +1 -0
- package/dist/config/ConfigKeys.d.ts +2 -2
- package/dist/config/ConfigKeys.d.ts.map +1 -1
- package/dist/config/ConfigKeys.js +31 -0
- package/dist/config/ConfigKeys.js.map +1 -1
- package/dist/config/ExecutorConfig.d.ts +115 -0
- package/dist/config/ExecutorConfig.d.ts.map +1 -1
- package/dist/config/ExecutorConfig.js +212 -0
- package/dist/config/ExecutorConfig.js.map +1 -1
- package/dist/edge/EdgeLicence.d.ts +25 -0
- package/dist/edge/EdgeLicence.d.ts.map +1 -0
- package/dist/edge/EdgeLicence.js +42 -0
- package/dist/edge/EdgeLicence.js.map +1 -0
- package/dist/edge/EdgeReplay.d.ts +45 -0
- package/dist/edge/EdgeReplay.d.ts.map +1 -0
- package/dist/edge/EdgeReplay.js +69 -0
- package/dist/edge/EdgeReplay.js.map +1 -0
- package/dist/edge/Entitlement.d.ts +57 -0
- package/dist/edge/Entitlement.d.ts.map +1 -0
- package/dist/edge/Entitlement.js +139 -0
- package/dist/edge/Entitlement.js.map +1 -0
- package/dist/edge/EntitlementEvaluation.d.ts +66 -0
- package/dist/edge/EntitlementEvaluation.d.ts.map +1 -0
- package/dist/edge/EntitlementEvaluation.js +74 -0
- package/dist/edge/EntitlementEvaluation.js.map +1 -0
- package/dist/edge/UsageCount.d.ts +40 -0
- package/dist/edge/UsageCount.d.ts.map +1 -0
- package/dist/edge/UsageCount.js +140 -0
- package/dist/edge/UsageCount.js.map +1 -0
- package/dist/edge/UsageKeyRegistration.d.ts +34 -0
- package/dist/edge/UsageKeyRegistration.d.ts.map +1 -0
- package/dist/edge/UsageKeyRegistration.js +74 -0
- package/dist/edge/UsageKeyRegistration.js.map +1 -0
- package/dist/edge/UsageMeter.d.ts +89 -0
- package/dist/edge/UsageMeter.d.ts.map +1 -0
- package/dist/edge/UsageMeter.js +275 -0
- package/dist/edge/UsageMeter.js.map +1 -0
- package/dist/edge/UsagePeriod.d.ts +23 -0
- package/dist/edge/UsagePeriod.d.ts.map +1 -0
- package/dist/edge/UsagePeriod.js +31 -0
- package/dist/edge/UsagePeriod.js.map +1 -0
- package/dist/edge/UsageReport.d.ts +92 -0
- package/dist/edge/UsageReport.d.ts.map +1 -0
- package/dist/edge/UsageReport.js +153 -0
- package/dist/edge/UsageReport.js.map +1 -0
- package/dist/edge/UsageTally.d.ts +63 -0
- package/dist/edge/UsageTally.d.ts.map +1 -0
- package/dist/edge/UsageTally.js +89 -0
- package/dist/edge/UsageTally.js.map +1 -0
- package/dist/egress/EgressError.d.ts +7 -1
- package/dist/egress/EgressError.d.ts.map +1 -1
- package/dist/egress/EgressError.js.map +1 -1
- package/dist/egress/EgressPolicy.d.ts +16 -3
- package/dist/egress/EgressPolicy.d.ts.map +1 -1
- package/dist/egress/EgressPolicy.js +33 -3
- package/dist/egress/EgressPolicy.js.map +1 -1
- package/dist/egress/GuardedFetch.d.ts +38 -1
- package/dist/egress/GuardedFetch.d.ts.map +1 -1
- package/dist/egress/GuardedFetch.js +52 -7
- package/dist/egress/GuardedFetch.js.map +1 -1
- package/dist/egress/TcpClient.d.ts +103 -0
- package/dist/egress/TcpClient.d.ts.map +1 -0
- package/dist/egress/TcpClient.js +490 -0
- package/dist/egress/TcpClient.js.map +1 -0
- package/dist/egress/TcpControlClient.d.ts +49 -0
- package/dist/egress/TcpControlClient.d.ts.map +1 -0
- package/dist/egress/TcpControlClient.js +186 -0
- package/dist/egress/TcpControlClient.js.map +1 -0
- package/dist/gateway/ForwardHandler.d.ts.map +1 -1
- package/dist/gateway/ForwardHandler.js +7 -4
- package/dist/gateway/ForwardHandler.js.map +1 -1
- package/dist/gateway/Gateway.d.ts +190 -10
- package/dist/gateway/Gateway.d.ts.map +1 -1
- package/dist/gateway/Gateway.js +465 -62
- package/dist/gateway/Gateway.js.map +1 -1
- package/dist/gateway/GatewayConfig.d.ts +67 -0
- package/dist/gateway/GatewayConfig.d.ts.map +1 -1
- package/dist/gateway/GatewayConfig.js +149 -2
- package/dist/gateway/GatewayConfig.js.map +1 -1
- package/dist/gateway/InterceptedRequest.d.ts +9 -2
- package/dist/gateway/InterceptedRequest.d.ts.map +1 -1
- package/dist/gateway/InterceptedRequest.js +41 -9
- package/dist/gateway/InterceptedRequest.js.map +1 -1
- package/dist/gateway/RateLimit.d.ts +29 -0
- package/dist/gateway/RateLimit.d.ts.map +1 -0
- package/dist/gateway/RateLimit.js +33 -0
- package/dist/gateway/RateLimit.js.map +1 -0
- package/dist/gateway/RefusalSampler.d.ts +28 -0
- package/dist/gateway/RefusalSampler.d.ts.map +1 -0
- package/dist/gateway/RefusalSampler.js +52 -0
- package/dist/gateway/RefusalSampler.js.map +1 -0
- package/dist/gateway/RouteTable.d.ts +3 -0
- package/dist/gateway/RouteTable.d.ts.map +1 -1
- package/dist/gateway/RouteTable.js +44 -7
- package/dist/gateway/RouteTable.js.map +1 -1
- package/dist/gateway/Upstream.d.ts +26 -0
- package/dist/gateway/Upstream.d.ts.map +1 -1
- package/dist/gateway/Upstream.js +41 -2
- package/dist/gateway/Upstream.js.map +1 -1
- package/dist/gateway/UpstreamProof.d.ts +235 -0
- package/dist/gateway/UpstreamProof.d.ts.map +1 -0
- package/dist/gateway/UpstreamProof.js +375 -0
- package/dist/gateway/UpstreamProof.js.map +1 -0
- package/dist/handlers/ForwardRequestHandler.d.ts +5 -1
- package/dist/handlers/ForwardRequestHandler.d.ts.map +1 -1
- package/dist/handlers/ForwardRequestHandler.js +12 -2
- package/dist/handlers/ForwardRequestHandler.js.map +1 -1
- package/dist/hosted/TenantHost.d.ts +180 -0
- package/dist/hosted/TenantHost.d.ts.map +1 -0
- package/dist/hosted/TenantHost.js +432 -0
- package/dist/hosted/TenantHost.js.map +1 -0
- package/dist/hosted/TenantRegistry.d.ts +73 -0
- package/dist/hosted/TenantRegistry.d.ts.map +1 -0
- package/dist/hosted/TenantRegistry.js +123 -0
- package/dist/hosted/TenantRegistry.js.map +1 -0
- package/dist/http/ExecutorHttpServer.d.ts +7 -0
- package/dist/http/ExecutorHttpServer.d.ts.map +1 -1
- package/dist/http/ExecutorHttpServer.js +30 -5
- package/dist/http/ExecutorHttpServer.js.map +1 -1
- package/dist/http/GatewayHttpServer.d.ts +55 -3
- package/dist/http/GatewayHttpServer.d.ts.map +1 -1
- package/dist/http/GatewayHttpServer.js +157 -17
- package/dist/http/GatewayHttpServer.js.map +1 -1
- package/dist/http/RedirectServer.d.ts +26 -0
- package/dist/http/RedirectServer.d.ts.map +1 -0
- package/dist/http/RedirectServer.js +62 -0
- package/dist/http/RedirectServer.js.map +1 -0
- package/dist/http/Routes.d.ts +24 -0
- package/dist/http/Routes.d.ts.map +1 -1
- package/dist/http/Routes.js +28 -1
- package/dist/http/Routes.js.map +1 -1
- package/dist/http/TcpBroker.d.ts +57 -0
- package/dist/http/TcpBroker.d.ts.map +1 -0
- package/dist/http/TcpBroker.js +299 -0
- package/dist/http/TcpBroker.js.map +1 -0
- package/dist/http/TcpHostRelay.d.ts +24 -0
- package/dist/http/TcpHostRelay.d.ts.map +1 -0
- package/dist/http/TcpHostRelay.js +194 -0
- package/dist/http/TcpHostRelay.js.map +1 -0
- package/dist/http/TcpRelayStreams.d.ts +24 -0
- package/dist/http/TcpRelayStreams.d.ts.map +1 -0
- package/dist/http/TcpRelayStreams.js +128 -0
- package/dist/http/TcpRelayStreams.js.map +1 -0
- package/dist/http/TlsListener.d.ts +3 -1
- package/dist/http/TlsListener.d.ts.map +1 -1
- package/dist/http/TlsListener.js +7 -2
- package/dist/http/TlsListener.js.map +1 -1
- package/dist/identity/Authenticator.d.ts.map +1 -1
- package/dist/identity/Authenticator.js +5 -2
- package/dist/identity/Authenticator.js.map +1 -1
- package/dist/identity/PrincipalsFile.d.ts +5 -1
- package/dist/identity/PrincipalsFile.d.ts.map +1 -1
- package/dist/identity/PrincipalsFile.js +2 -0
- package/dist/identity/PrincipalsFile.js.map +1 -1
- package/dist/incident/Metrics.d.ts +2 -0
- package/dist/incident/Metrics.d.ts.map +1 -1
- package/dist/incident/Metrics.js +10 -0
- package/dist/incident/Metrics.js.map +1 -1
- package/dist/incident/SecurityEvents.d.ts +98 -0
- package/dist/incident/SecurityEvents.d.ts.map +1 -1
- package/dist/incident/SecurityEvents.js +96 -2
- package/dist/incident/SecurityEvents.js.map +1 -1
- package/dist/journal/ExecutionJournal.d.ts +27 -0
- package/dist/journal/ExecutionJournal.d.ts.map +1 -1
- package/dist/journal/ExecutionJournal.js +28 -0
- package/dist/journal/ExecutionJournal.js.map +1 -1
- package/dist/journal/FileExecutionJournal.d.ts +2 -1
- package/dist/journal/FileExecutionJournal.d.ts.map +1 -1
- package/dist/journal/FileExecutionJournal.js +4 -1
- package/dist/journal/FileExecutionJournal.js.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts +2 -1
- package/dist/journal/InMemoryExecutionJournal.d.ts.map +1 -1
- package/dist/journal/InMemoryExecutionJournal.js +4 -1
- package/dist/journal/InMemoryExecutionJournal.js.map +1 -1
- package/dist/service/AuthorityClients.d.ts +8 -1
- package/dist/service/AuthorityClients.d.ts.map +1 -1
- package/dist/service/AuthorityClients.js +33 -5
- package/dist/service/AuthorityClients.js.map +1 -1
- package/dist/service/EdgeRuntime.d.ts +73 -0
- package/dist/service/EdgeRuntime.d.ts.map +1 -0
- package/dist/service/EdgeRuntime.js +209 -0
- package/dist/service/EdgeRuntime.js.map +1 -0
- package/dist/service/EscalationResolver.d.ts +109 -5
- package/dist/service/EscalationResolver.d.ts.map +1 -1
- package/dist/service/EscalationResolver.js +41 -3
- package/dist/service/EscalationResolver.js.map +1 -1
- package/dist/service/Requests.d.ts +45 -2
- package/dist/service/Requests.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.d.ts +144 -1
- package/dist/service/TrustedExecutorService.d.ts.map +1 -1
- package/dist/service/TrustedExecutorService.js +866 -37
- package/dist/service/TrustedExecutorService.js.map +1 -1
- package/dist/tcp/TcpWire.d.ts +18 -0
- package/dist/tcp/TcpWire.d.ts.map +1 -0
- package/dist/tcp/TcpWire.js +114 -0
- package/dist/tcp/TcpWire.js.map +1 -0
- package/dist/verify/VerifyAuditChain.d.ts +5 -0
- package/dist/verify/VerifyAuditChain.d.ts.map +1 -1
- package/dist/verify/VerifyAuditChain.js +20 -4
- package/dist/verify/VerifyAuditChain.js.map +1 -1
- package/package.json +7 -3
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import { loadPg } from "../../edge/EdgeReplay.js";
|
|
2
|
+
import { PostgresCardHolds } from "./PostgresCardHolds.js";
|
|
3
|
+
/**
|
|
4
|
+
* The shared hold store over one `pg` pool, opened on first use: the
|
|
5
|
+
* connection string and the hold key are secrets, read when the pool is
|
|
6
|
+
* opened and when a row is sealed, and never held as strings here.
|
|
7
|
+
*/
|
|
8
|
+
export function postgresCardHolds(options) {
|
|
9
|
+
let opened = null;
|
|
10
|
+
const open = async () => {
|
|
11
|
+
opened ??= (async () => {
|
|
12
|
+
const { Pool } = await (options.load ?? loadPg)();
|
|
13
|
+
const pool = new Pool({ connectionString: options.databaseUrl(), max: 4 });
|
|
14
|
+
// An idle connection's error is the next query's failure, not the process's.
|
|
15
|
+
pool.on("error", () => undefined);
|
|
16
|
+
const client = {
|
|
17
|
+
query: async (text, values) => (await pool.query(text, [...values])),
|
|
18
|
+
};
|
|
19
|
+
const store = new PostgresCardHolds({
|
|
20
|
+
client,
|
|
21
|
+
namespace: options.namespace,
|
|
22
|
+
table: options.table,
|
|
23
|
+
seal: options.seal(),
|
|
24
|
+
adopt: options.adopt,
|
|
25
|
+
...(options.clock === undefined ? {} : { clock: options.clock }),
|
|
26
|
+
...(options.claimRetentionMs === undefined
|
|
27
|
+
? {}
|
|
28
|
+
: { claimRetentionMs: options.claimRetentionMs }),
|
|
29
|
+
});
|
|
30
|
+
return { store, pool };
|
|
31
|
+
})();
|
|
32
|
+
return await opened;
|
|
33
|
+
};
|
|
34
|
+
return {
|
|
35
|
+
kind: "postgres",
|
|
36
|
+
spendable: async (key) => (await open()).store.spendable(key),
|
|
37
|
+
hold: async (grant) => (await open()).store.hold(grant),
|
|
38
|
+
grant: async (key) => (await open()).store.grant(key),
|
|
39
|
+
spend: async (grant) => (await open()).store.spend(grant),
|
|
40
|
+
claimed: async (id) => (await open()).store.claimed(id),
|
|
41
|
+
recordClaim: async (id, claim) => (await open()).store.recordClaim(id, claim),
|
|
42
|
+
amend: async (id, request) => (await open()).store.amend(id, request),
|
|
43
|
+
settle: async (id) => (await open()).store.settle(id),
|
|
44
|
+
velocity: async (card, windowMs) => (await open()).store.velocity(card, windowMs),
|
|
45
|
+
ready: async () => {
|
|
46
|
+
await (await open()).store.ready();
|
|
47
|
+
},
|
|
48
|
+
cleanup: async () => {
|
|
49
|
+
await (await open()).store.cleanup();
|
|
50
|
+
},
|
|
51
|
+
close: async () => {
|
|
52
|
+
if (opened !== null)
|
|
53
|
+
await (await opened).pool.end();
|
|
54
|
+
},
|
|
55
|
+
};
|
|
56
|
+
}
|
|
57
|
+
//# sourceMappingURL=CardHolds.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CardHolds.js","sourceRoot":"","sources":["../../../src/adapters/cards/CardHolds.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
/** The one card action this family registers: a purchase the issuer will authorize later. */
|
|
3
|
+
export declare const CARD_PURCHASE_ACTION = "card.purchase";
|
|
4
|
+
export declare class CardActionError extends Error {
|
|
5
|
+
readonly code: string;
|
|
6
|
+
constructor(code: string);
|
|
7
|
+
}
|
|
8
|
+
/**
|
|
9
|
+
* The parameters of `card.purchase`: what the agent wants to buy, with which
|
|
10
|
+
* card, from whom, for at most how much. The card is named by its token
|
|
11
|
+
* reference, never by its number; the amount is minor units of a currency
|
|
12
|
+
* this build knows the exponent of, and it is the ceiling the issuer's
|
|
13
|
+
* authorization will be matched against.
|
|
14
|
+
*/
|
|
15
|
+
export declare const CardPurchaseSchema: z.ZodObject<{
|
|
16
|
+
cardTokenRef: z.ZodString;
|
|
17
|
+
amountMinor: z.ZodNumber;
|
|
18
|
+
currency: z.ZodString;
|
|
19
|
+
merchantId: z.ZodString;
|
|
20
|
+
mcc: z.ZodOptional<z.ZodString>;
|
|
21
|
+
}, z.core.$strict>;
|
|
22
|
+
export type CardPurchase = z.infer<typeof CardPurchaseSchema>;
|
|
23
|
+
/** What the issuer's real-time authorization hook asks. */
|
|
24
|
+
export declare const CardAuthorizationRequestSchema: z.ZodObject<{
|
|
25
|
+
authorization_id: z.ZodString;
|
|
26
|
+
card_token_ref: z.ZodString;
|
|
27
|
+
amount_minor: z.ZodNumber;
|
|
28
|
+
currency: z.ZodString;
|
|
29
|
+
merchant_id: z.ZodString;
|
|
30
|
+
mcc: z.ZodOptional<z.ZodString>;
|
|
31
|
+
}, z.core.$strict>;
|
|
32
|
+
export type CardAuthorizationRequest = z.infer<typeof CardAuthorizationRequestSchema>;
|
|
33
|
+
/** What the issuer says it did with an authorization it asked about. */
|
|
34
|
+
export declare const CardAuthorizationResultSchema: z.ZodObject<{
|
|
35
|
+
status: z.ZodEnum<{
|
|
36
|
+
APPROVED: "APPROVED";
|
|
37
|
+
DECLINED: "DECLINED";
|
|
38
|
+
}>;
|
|
39
|
+
approved_amount_minor: z.ZodOptional<z.ZodNumber>;
|
|
40
|
+
auth_code: z.ZodOptional<z.ZodString>;
|
|
41
|
+
}, z.core.$strict>;
|
|
42
|
+
export type CardAuthorizationResult = z.infer<typeof CardAuthorizationResultSchema>;
|
|
43
|
+
/** The action as the profile reads it, or the refusal that says why not. */
|
|
44
|
+
export declare function cardPurchaseOf(parameters: unknown): CardPurchase;
|
|
45
|
+
/**
|
|
46
|
+
* The binding between the transport and the action: the target is derived
|
|
47
|
+
* from the card, so a caller describing one card and asking for another is
|
|
48
|
+
* refused before the authority is asked.
|
|
49
|
+
*/
|
|
50
|
+
export declare function bindCardPurchase(input: {
|
|
51
|
+
readonly target: string;
|
|
52
|
+
readonly parameters: unknown;
|
|
53
|
+
}): CardPurchase;
|
|
54
|
+
/** The transport target a card purchase names: the card it spends from. */
|
|
55
|
+
export declare function cardTarget(purchase: CardPurchase): string;
|
|
56
|
+
export declare function cardAuthorizationOf(input: unknown): CardAuthorizationRequest;
|
|
57
|
+
export declare function cardAuthorizationResultOf(input: unknown): CardAuthorizationResult;
|
|
58
|
+
/** An authorization id as it arrives in a path segment, held to the same rule as everywhere else. */
|
|
59
|
+
export declare function isCardReference(value: string): boolean;
|
|
60
|
+
export declare function isCardActionName(action: string): boolean;
|
|
61
|
+
//# sourceMappingURL=CardPurchase.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CardPurchase.d.ts","sourceRoot":"","sources":["../../../src/adapters/cards/CardPurchase.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,6FAA6F;AAC7F,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,qBAAa,eAAgB,SAAQ,KAAK;aACL,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIhD;AAiBD;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB;;;;;;kBAM7B,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAE9D,2DAA2D;AAC3D,eAAO,MAAM,8BAA8B;;;;;;;kBAOzC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,8BAA8B,CAAC,CAAC;AAEtF,wEAAwE;AACxE,eAAO,MAAM,6BAA6B;;;;;;;kBAOxC,CAAC;AAEH,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,6BAA6B,CAAC,CAAC;AAYpF,4EAA4E;AAC5E,wBAAgB,cAAc,CAAC,UAAU,EAAE,OAAO,GAAG,YAAY,CAShE;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B,GAAG,YAAY,CAIf;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,QAAQ,EAAE,YAAY,GAAG,MAAM,CAEzD;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,wBAAwB,CAK5E;AAED,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,OAAO,GAAG,uBAAuB,CAIjF;AAED,qGAAqG;AACrG,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAExD"}
|
|
@@ -0,0 +1,116 @@
|
|
|
1
|
+
import { z } from "zod";
|
|
2
|
+
import { isSupportedCurrency } from "../banking/Currency.js";
|
|
3
|
+
import { containsPan } from "./Pan.js";
|
|
4
|
+
/** The one card action this family registers: a purchase the issuer will authorize later. */
|
|
5
|
+
export const CARD_PURCHASE_ACTION = "card.purchase";
|
|
6
|
+
export class CardActionError extends Error {
|
|
7
|
+
code;
|
|
8
|
+
constructor(code) {
|
|
9
|
+
super(code);
|
|
10
|
+
this.code = code;
|
|
11
|
+
this.name = "CardActionError";
|
|
12
|
+
}
|
|
13
|
+
}
|
|
14
|
+
/**
|
|
15
|
+
* A reference: a card token reference, a merchant id, an authorization id.
|
|
16
|
+
* Opaque to this boundary, bounded, and in a character set no header,
|
|
17
|
+
* path segment or log line has to escape.
|
|
18
|
+
*/
|
|
19
|
+
const REFERENCE = /^[\w.:-]{1,200}$/;
|
|
20
|
+
const CURRENCY = /^[A-Z]{3}$/;
|
|
21
|
+
const MCC = /^\d{4}$/;
|
|
22
|
+
const reference = z.string().regex(REFERENCE);
|
|
23
|
+
/** A card reference is a reference that is not, and does not contain, a card number. */
|
|
24
|
+
const cardReference = reference.refine((value) => !containsPan(value));
|
|
25
|
+
/** Minor units, as a JSON integer: at least one, and exact in a double. */
|
|
26
|
+
const minorUnits = z.number().int().positive();
|
|
27
|
+
/**
|
|
28
|
+
* The parameters of `card.purchase`: what the agent wants to buy, with which
|
|
29
|
+
* card, from whom, for at most how much. The card is named by its token
|
|
30
|
+
* reference, never by its number; the amount is minor units of a currency
|
|
31
|
+
* this build knows the exponent of, and it is the ceiling the issuer's
|
|
32
|
+
* authorization will be matched against.
|
|
33
|
+
*/
|
|
34
|
+
export const CardPurchaseSchema = z.strictObject({
|
|
35
|
+
cardTokenRef: cardReference,
|
|
36
|
+
amountMinor: minorUnits,
|
|
37
|
+
currency: z.string().regex(CURRENCY),
|
|
38
|
+
merchantId: reference,
|
|
39
|
+
mcc: z.string().regex(MCC).optional(),
|
|
40
|
+
});
|
|
41
|
+
/** What the issuer's real-time authorization hook asks. */
|
|
42
|
+
export const CardAuthorizationRequestSchema = z.strictObject({
|
|
43
|
+
authorization_id: reference,
|
|
44
|
+
card_token_ref: cardReference,
|
|
45
|
+
amount_minor: minorUnits,
|
|
46
|
+
currency: z.string().regex(CURRENCY),
|
|
47
|
+
merchant_id: reference,
|
|
48
|
+
mcc: z.string().regex(MCC).optional(),
|
|
49
|
+
});
|
|
50
|
+
/** What the issuer says it did with an authorization it asked about. */
|
|
51
|
+
export const CardAuthorizationResultSchema = z.strictObject({
|
|
52
|
+
status: z.enum(["APPROVED", "DECLINED"]),
|
|
53
|
+
approved_amount_minor: minorUnits.optional(),
|
|
54
|
+
auth_code: z
|
|
55
|
+
.string()
|
|
56
|
+
.regex(/^[A-Z0-9]{1,12}$/)
|
|
57
|
+
.optional(),
|
|
58
|
+
});
|
|
59
|
+
/**
|
|
60
|
+
* A card number anywhere it could be read is refused under its own code,
|
|
61
|
+
* before any other rule, so a caller learns that it sent one and never the
|
|
62
|
+
* value: no response, record or line repeats a parameter. Whatever JSON type
|
|
63
|
+
* carries it, a number written as digits is still a card number.
|
|
64
|
+
*/
|
|
65
|
+
function refusePan(value) {
|
|
66
|
+
if (containsPan(String(value)))
|
|
67
|
+
throw new CardActionError("CARD_PAN_REFUSED");
|
|
68
|
+
}
|
|
69
|
+
/** The action as the profile reads it, or the refusal that says why not. */
|
|
70
|
+
export function cardPurchaseOf(parameters) {
|
|
71
|
+
refusePan(parameters?.cardTokenRef);
|
|
72
|
+
const parsed = CardPurchaseSchema.safeParse(parameters);
|
|
73
|
+
if (!parsed.success)
|
|
74
|
+
throw new CardActionError("CARD_PURCHASE_INVALID");
|
|
75
|
+
// A currency is only a number once its exponent is known; one this build lacks is refused.
|
|
76
|
+
if (!isSupportedCurrency(parsed.data.currency)) {
|
|
77
|
+
throw new CardActionError("CARD_CURRENCY_UNSUPPORTED");
|
|
78
|
+
}
|
|
79
|
+
return parsed.data;
|
|
80
|
+
}
|
|
81
|
+
/**
|
|
82
|
+
* The binding between the transport and the action: the target is derived
|
|
83
|
+
* from the card, so a caller describing one card and asking for another is
|
|
84
|
+
* refused before the authority is asked.
|
|
85
|
+
*/
|
|
86
|
+
export function bindCardPurchase(input) {
|
|
87
|
+
const purchase = cardPurchaseOf(input.parameters);
|
|
88
|
+
if (input.target !== cardTarget(purchase))
|
|
89
|
+
throw new CardActionError("CARD_TARGET_MISMATCH");
|
|
90
|
+
return purchase;
|
|
91
|
+
}
|
|
92
|
+
/** The transport target a card purchase names: the card it spends from. */
|
|
93
|
+
export function cardTarget(purchase) {
|
|
94
|
+
return `card:${purchase.cardTokenRef}`;
|
|
95
|
+
}
|
|
96
|
+
export function cardAuthorizationOf(input) {
|
|
97
|
+
refusePan(input?.card_token_ref);
|
|
98
|
+
const parsed = CardAuthorizationRequestSchema.safeParse(input);
|
|
99
|
+
if (!parsed.success)
|
|
100
|
+
throw new CardActionError("CARD_AUTHORIZATION_INVALID");
|
|
101
|
+
return parsed.data;
|
|
102
|
+
}
|
|
103
|
+
export function cardAuthorizationResultOf(input) {
|
|
104
|
+
const parsed = CardAuthorizationResultSchema.safeParse(input);
|
|
105
|
+
if (!parsed.success)
|
|
106
|
+
throw new CardActionError("CARD_AUTHORIZATION_RESULT_INVALID");
|
|
107
|
+
return parsed.data;
|
|
108
|
+
}
|
|
109
|
+
/** An authorization id as it arrives in a path segment, held to the same rule as everywhere else. */
|
|
110
|
+
export function isCardReference(value) {
|
|
111
|
+
return REFERENCE.test(value);
|
|
112
|
+
}
|
|
113
|
+
export function isCardActionName(action) {
|
|
114
|
+
return action === CARD_PURCHASE_ACTION;
|
|
115
|
+
}
|
|
116
|
+
//# sourceMappingURL=CardPurchase.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"CardPurchase.js","sourceRoot":"","sources":["../../../src/adapters/cards/CardPurchase.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,69 @@
|
|
|
1
|
+
import { type CardClaimInput, type CardHoldKey, type CardHoldStore, type CardVelocity, type ClaimedCardAuthorization, type HeldCardGrant, type HeldCardGrantRecord } from "./CardHoldStore.js";
|
|
2
|
+
import type { CardAuthorizationRequest } from "./CardPurchase.js";
|
|
3
|
+
export type { CardApproval, CardVelocity, ClaimedCardAuthorization, HeldCardGrant, } from "./CardHoldStore.js";
|
|
4
|
+
export { CARD_VELOCITY_WINDOW_MS } from "./CardHoldStore.js";
|
|
5
|
+
export interface HeldCardGrantsOptions {
|
|
6
|
+
/** Entries of each kind this process keeps at most; a hold beyond it is refused. */
|
|
7
|
+
readonly maxEntries?: number;
|
|
8
|
+
/** How long a claimed authorization waits for its result before it is forgotten. */
|
|
9
|
+
readonly claimRetentionMs?: number;
|
|
10
|
+
readonly clock?: () => number;
|
|
11
|
+
}
|
|
12
|
+
/**
|
|
13
|
+
* Grants held for a card authorization that has not happened yet, keyed by
|
|
14
|
+
* the card and the merchant, and the authorizations that claimed one, keyed
|
|
15
|
+
* by the issuer's authorization id. In memory and bounded on purpose: a hold
|
|
16
|
+
* lives no longer than its grant, which the authority caps in minutes, and a
|
|
17
|
+
* restart that loses one loses only a grant nobody claimed, which expires
|
|
18
|
+
* with no effect. A claimed authorization is already in the journal. A
|
|
19
|
+
* deployment with more than one replica, or one that must keep its holds
|
|
20
|
+
* across a restart, uses the shared store instead.
|
|
21
|
+
*
|
|
22
|
+
* One card has at most one spendable hold per merchant. An agent that wants
|
|
23
|
+
* a second purchase at the same merchant on the same card waits for the
|
|
24
|
+
* first to be authorised or to expire, so an authorization can never be
|
|
25
|
+
* matched to the wrong one of two; purchases at different merchants hold in
|
|
26
|
+
* parallel, because the authorization names its merchant.
|
|
27
|
+
*/
|
|
28
|
+
export declare class HeldCardGrants implements CardHoldStore {
|
|
29
|
+
readonly kind: "memory";
|
|
30
|
+
private static readonly MAX_ACTIVITY_PER_CARD;
|
|
31
|
+
private readonly holds;
|
|
32
|
+
private readonly claims;
|
|
33
|
+
/** When each card was last held for and claimed, most recently touched card last. */
|
|
34
|
+
private readonly activity;
|
|
35
|
+
private readonly maxEntries;
|
|
36
|
+
private readonly claimRetentionMs;
|
|
37
|
+
private readonly clock;
|
|
38
|
+
constructor(options?: HeldCardGrantsOptions);
|
|
39
|
+
spendable(key: CardHoldKey): Promise<boolean>;
|
|
40
|
+
hold(grant: HeldCardGrant): Promise<boolean>;
|
|
41
|
+
grant(key: CardHoldKey): Promise<HeldCardGrantRecord | undefined>;
|
|
42
|
+
/** Spent before anything is awaited by the caller: the first to ask gets it, later askers find it used. */
|
|
43
|
+
spend(grant: HeldCardGrant): Promise<boolean>;
|
|
44
|
+
claimed(authorizationId: string): Promise<ClaimedCardAuthorization | undefined>;
|
|
45
|
+
/** Remembers a claim for its result; a full store forgets the oldest, which the journal still holds. */
|
|
46
|
+
recordClaim(authorizationId: string, claim: CardClaimInput): Promise<ClaimedCardAuthorization>;
|
|
47
|
+
amend(authorizationId: string, request: CardAuthorizationRequest): Promise<boolean>;
|
|
48
|
+
settle(authorizationId: string): Promise<boolean>;
|
|
49
|
+
/**
|
|
50
|
+
* The burst a policy wants to see: how many purchases were held for this
|
|
51
|
+
* card and how many authorizations claimed one, over the window. The
|
|
52
|
+
* policy language counts nothing over time, so the executor counts here
|
|
53
|
+
* and puts the numbers in the intent's context; a card reference never
|
|
54
|
+
* leaves with them.
|
|
55
|
+
*/
|
|
56
|
+
velocity(cardTokenRef: string, windowMs?: number): Promise<CardVelocity>;
|
|
57
|
+
ready(): Promise<void>;
|
|
58
|
+
cleanup(): Promise<void>;
|
|
59
|
+
close(): Promise<void>;
|
|
60
|
+
get size(): {
|
|
61
|
+
readonly holds: number;
|
|
62
|
+
readonly claims: number;
|
|
63
|
+
};
|
|
64
|
+
private spendableNow;
|
|
65
|
+
/** Remembers one hold or claim on a card, bounded per card and across cards. */
|
|
66
|
+
private note;
|
|
67
|
+
private sweep;
|
|
68
|
+
}
|
|
69
|
+
//# sourceMappingURL=HeldCardGrants.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HeldCardGrants.d.ts","sourceRoot":"","sources":["../../../src/adapters/cards/HeldCardGrants.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACnB,KAAK,WAAW,EAChB,KAAK,aAAa,EAClB,KAAK,YAAY,EACjB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,mBAAmB,EACzB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,YAAY,EACV,YAAY,EACZ,YAAY,EACZ,wBAAwB,EACxB,aAAa,GACd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAE7D,MAAM,WAAW,qBAAqB;IACpC,oFAAoF;IACpF,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CAC/B;AAED;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,cAAe,YAAW,aAAa;IAClD,SAAgB,IAAI,EAAG,QAAQ,CAAU;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,qBAAqB,CAAO;IACpD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAoC;IAC1D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA+C;IACtE,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAGrB;IACJ,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;gBAElB,OAAO,GAAE,qBAA0B;IAMzC,SAAS,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAI7C,IAAI,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAU5C,KAAK,CAAC,GAAG,EAAE,WAAW,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAiB9E,2GAA2G;IAC9F,KAAK,CAAC,KAAK,EAAE,aAAa,GAAG,OAAO,CAAC,OAAO,CAAC;IAM7C,OAAO,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,GAAG,SAAS,CAAC;IAK5F,wGAAwG;IAC3F,WAAW,CACtB,eAAe,EAAE,MAAM,EACvB,KAAK,EAAE,cAAc,GACpB,OAAO,CAAC,wBAAwB,CAAC;IAoBvB,KAAK,CAAC,eAAe,EAAE,MAAM,EAAE,OAAO,EAAE,wBAAwB,GAAG,OAAO,CAAC,OAAO,CAAC;IAOnF,MAAM,CAAC,eAAe,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAO9D;;;;;;OAMG;IACU,QAAQ,CACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,SAA0B,GACjC,OAAO,CAAC,YAAY,CAAC;IAOX,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAInC,IAAW,IAAI,IAAI;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAErE;IAED,OAAO,CAAC,YAAY;IAMpB,gFAAgF;IAChF,OAAO,CAAC,IAAI;IAiBZ,OAAO,CAAC,KAAK;CAWd"}
|
|
@@ -0,0 +1,169 @@
|
|
|
1
|
+
import { CARD_VELOCITY_WINDOW_MS, cardHoldKey, } from "./CardHoldStore.js";
|
|
2
|
+
export { CARD_VELOCITY_WINDOW_MS } from "./CardHoldStore.js";
|
|
3
|
+
/**
|
|
4
|
+
* Grants held for a card authorization that has not happened yet, keyed by
|
|
5
|
+
* the card and the merchant, and the authorizations that claimed one, keyed
|
|
6
|
+
* by the issuer's authorization id. In memory and bounded on purpose: a hold
|
|
7
|
+
* lives no longer than its grant, which the authority caps in minutes, and a
|
|
8
|
+
* restart that loses one loses only a grant nobody claimed, which expires
|
|
9
|
+
* with no effect. A claimed authorization is already in the journal. A
|
|
10
|
+
* deployment with more than one replica, or one that must keep its holds
|
|
11
|
+
* across a restart, uses the shared store instead.
|
|
12
|
+
*
|
|
13
|
+
* One card has at most one spendable hold per merchant. An agent that wants
|
|
14
|
+
* a second purchase at the same merchant on the same card waits for the
|
|
15
|
+
* first to be authorised or to expire, so an authorization can never be
|
|
16
|
+
* matched to the wrong one of two; purchases at different merchants hold in
|
|
17
|
+
* parallel, because the authorization names its merchant.
|
|
18
|
+
*/
|
|
19
|
+
export class HeldCardGrants {
|
|
20
|
+
kind = "memory";
|
|
21
|
+
static MAX_ACTIVITY_PER_CARD = 100;
|
|
22
|
+
holds = new Map();
|
|
23
|
+
claims = new Map();
|
|
24
|
+
/** When each card was last held for and claimed, most recently touched card last. */
|
|
25
|
+
activity = new Map();
|
|
26
|
+
maxEntries;
|
|
27
|
+
claimRetentionMs;
|
|
28
|
+
clock;
|
|
29
|
+
constructor(options = {}) {
|
|
30
|
+
this.maxEntries = options.maxEntries ?? 10_000;
|
|
31
|
+
this.claimRetentionMs = options.claimRetentionMs ?? 15 * 60_000;
|
|
32
|
+
this.clock = options.clock ?? (() => Date.now());
|
|
33
|
+
}
|
|
34
|
+
async spendable(key) {
|
|
35
|
+
return this.spendableNow(key);
|
|
36
|
+
}
|
|
37
|
+
async hold(grant) {
|
|
38
|
+
const key = cardHoldKey(grant);
|
|
39
|
+
if (this.spendableNow(grant))
|
|
40
|
+
return false;
|
|
41
|
+
this.holds.delete(key);
|
|
42
|
+
if (this.holds.size >= this.maxEntries)
|
|
43
|
+
return false;
|
|
44
|
+
this.holds.set(key, grant);
|
|
45
|
+
this.note(grant.cardTokenRef, "hold");
|
|
46
|
+
return true;
|
|
47
|
+
}
|
|
48
|
+
async grant(key) {
|
|
49
|
+
this.sweep();
|
|
50
|
+
const grant = this.holds.get(cardHoldKey(key));
|
|
51
|
+
if (grant === undefined)
|
|
52
|
+
return undefined;
|
|
53
|
+
return {
|
|
54
|
+
cardTokenRef: grant.cardTokenRef,
|
|
55
|
+
merchantId: grant.merchantId,
|
|
56
|
+
amountMinor: grant.amountMinor,
|
|
57
|
+
currency: grant.currency,
|
|
58
|
+
mcc: grant.mcc,
|
|
59
|
+
expiresAtMs: grant.expiresAtMs,
|
|
60
|
+
used: grant.used,
|
|
61
|
+
intentId: grant.held.captured.intent.intentId,
|
|
62
|
+
open: async () => grant,
|
|
63
|
+
};
|
|
64
|
+
}
|
|
65
|
+
/** Spent before anything is awaited by the caller: the first to ask gets it, later askers find it used. */
|
|
66
|
+
async spend(grant) {
|
|
67
|
+
if (grant.used || this.holds.get(cardHoldKey(grant)) !== grant)
|
|
68
|
+
return false;
|
|
69
|
+
grant.used = true;
|
|
70
|
+
return true;
|
|
71
|
+
}
|
|
72
|
+
async claimed(authorizationId) {
|
|
73
|
+
this.sweep();
|
|
74
|
+
return this.claims.get(authorizationId);
|
|
75
|
+
}
|
|
76
|
+
/** Remembers a claim for its result; a full store forgets the oldest, which the journal still holds. */
|
|
77
|
+
async recordClaim(authorizationId, claim) {
|
|
78
|
+
// The claim material is the shared store's concern; here the claim stays in the process.
|
|
79
|
+
const record = {
|
|
80
|
+
grant: claim.grant,
|
|
81
|
+
request: claim.request,
|
|
82
|
+
authorization: claim.authorization,
|
|
83
|
+
leaseExpiresAtMs: claim.leaseExpiresAtMs,
|
|
84
|
+
answer: claim.answer,
|
|
85
|
+
retainUntilMs: this.clock() + this.claimRetentionMs,
|
|
86
|
+
settled: false,
|
|
87
|
+
};
|
|
88
|
+
if (this.claims.size >= this.maxEntries) {
|
|
89
|
+
const oldest = this.claims.keys().next().value;
|
|
90
|
+
this.claims.delete(oldest);
|
|
91
|
+
}
|
|
92
|
+
this.claims.set(authorizationId, record);
|
|
93
|
+
this.note(claim.grant.cardTokenRef, "claim");
|
|
94
|
+
return record;
|
|
95
|
+
}
|
|
96
|
+
async amend(authorizationId, request) {
|
|
97
|
+
const claim = this.claims.get(authorizationId);
|
|
98
|
+
if (claim === undefined || claim.settled)
|
|
99
|
+
return false;
|
|
100
|
+
claim.request = request;
|
|
101
|
+
return true;
|
|
102
|
+
}
|
|
103
|
+
async settle(authorizationId) {
|
|
104
|
+
const claim = this.claims.get(authorizationId);
|
|
105
|
+
if (claim === undefined || claim.settled)
|
|
106
|
+
return false;
|
|
107
|
+
claim.settled = true;
|
|
108
|
+
return true;
|
|
109
|
+
}
|
|
110
|
+
/**
|
|
111
|
+
* The burst a policy wants to see: how many purchases were held for this
|
|
112
|
+
* card and how many authorizations claimed one, over the window. The
|
|
113
|
+
* policy language counts nothing over time, so the executor counts here
|
|
114
|
+
* and puts the numbers in the intent's context; a card reference never
|
|
115
|
+
* leaves with them.
|
|
116
|
+
*/
|
|
117
|
+
async velocity(cardTokenRef, windowMs = CARD_VELOCITY_WINDOW_MS) {
|
|
118
|
+
const since = this.clock() - windowMs;
|
|
119
|
+
const recent = (this.activity.get(cardTokenRef) ?? []).filter((entry) => entry.at > since);
|
|
120
|
+
const holds = recent.filter((entry) => entry.kind === "hold").length;
|
|
121
|
+
return { window_seconds: Math.round(windowMs / 1_000), holds, claims: recent.length - holds };
|
|
122
|
+
}
|
|
123
|
+
async ready() {
|
|
124
|
+
return undefined;
|
|
125
|
+
}
|
|
126
|
+
async cleanup() {
|
|
127
|
+
this.sweep();
|
|
128
|
+
}
|
|
129
|
+
async close() {
|
|
130
|
+
return undefined;
|
|
131
|
+
}
|
|
132
|
+
get size() {
|
|
133
|
+
return { holds: this.holds.size, claims: this.claims.size };
|
|
134
|
+
}
|
|
135
|
+
spendableNow(key) {
|
|
136
|
+
this.sweep();
|
|
137
|
+
const grant = this.holds.get(cardHoldKey(key));
|
|
138
|
+
return grant !== undefined && !grant.used && grant.expiresAtMs > this.clock();
|
|
139
|
+
}
|
|
140
|
+
/** Remembers one hold or claim on a card, bounded per card and across cards. */
|
|
141
|
+
note(cardTokenRef, kind) {
|
|
142
|
+
const now = this.clock();
|
|
143
|
+
const entries = (this.activity.get(cardTokenRef) ?? []).filter((entry) => entry.at > now - CARD_VELOCITY_WINDOW_MS);
|
|
144
|
+
entries.push({ at: now, kind });
|
|
145
|
+
if (entries.length > HeldCardGrants.MAX_ACTIVITY_PER_CARD) {
|
|
146
|
+
entries.splice(0, entries.length - HeldCardGrants.MAX_ACTIVITY_PER_CARD);
|
|
147
|
+
}
|
|
148
|
+
// Re-inserted so the map's order is recency, and the stalest card goes first.
|
|
149
|
+
this.activity.delete(cardTokenRef);
|
|
150
|
+
this.activity.set(cardTokenRef, entries);
|
|
151
|
+
if (this.activity.size > this.maxEntries) {
|
|
152
|
+
this.activity.delete(this.activity.keys().next().value);
|
|
153
|
+
}
|
|
154
|
+
}
|
|
155
|
+
sweep() {
|
|
156
|
+
const now = this.clock();
|
|
157
|
+
// An expired hold is kept as long as a claim would be, so an authorization
|
|
158
|
+
// that arrives late is told its grant expired rather than that none existed.
|
|
159
|
+
for (const [key, grant] of this.holds) {
|
|
160
|
+
if (grant.expiresAtMs + this.claimRetentionMs <= now)
|
|
161
|
+
this.holds.delete(key);
|
|
162
|
+
}
|
|
163
|
+
for (const [key, claim] of this.claims) {
|
|
164
|
+
if (claim.retainUntilMs <= now)
|
|
165
|
+
this.claims.delete(key);
|
|
166
|
+
}
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
//# sourceMappingURL=HeldCardGrants.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"HeldCardGrants.js","sourceRoot":"","sources":["../../../src/adapters/cards/HeldCardGrants.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,17 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Whether a value carries something shaped like a primary account number:
|
|
3
|
+
* 13 to 19 digits that pass the Luhn check, written together or grouped by
|
|
4
|
+
* spaces, hyphens or other punctuation (`4111 1111 1111 1111`,
|
|
5
|
+
* `4111-1111-1111-1111`). A letter ends a run, so `tok_4111111111111111`
|
|
6
|
+
* is still caught by the digits after the prefix.
|
|
7
|
+
*
|
|
8
|
+
* A card reference crosses this boundary into a hashed intent, a Decision
|
|
9
|
+
* Dossier and an evidence line, and none of those may ever hold a card
|
|
10
|
+
* number; so a value that merely looks like one is refused, and a reference
|
|
11
|
+
* that is refused by mistake costs a caller a different reference, which is
|
|
12
|
+
* the right side to err on. Both the contiguous run and the run joined
|
|
13
|
+
* across punctuation are checked, so a number cannot hide behind a trailing
|
|
14
|
+
* group of other digits written after a separator.
|
|
15
|
+
*/
|
|
16
|
+
export declare function containsPan(value: string): boolean;
|
|
17
|
+
//# sourceMappingURL=Pan.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Pan.d.ts","sourceRoot":"","sources":["../../../src/adapters/cards/Pan.ts"],"names":[],"mappings":"AAkBA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAmBlD"}
|
|
@@ -0,0 +1,52 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* The value a doubled digit contributes to a Luhn sum, by digit: 2 × d, with
|
|
3
|
+
* the two digits of a two-digit product added together.
|
|
4
|
+
*/
|
|
5
|
+
const DOUBLED = "0246813579";
|
|
6
|
+
/** A run of digits a card number could be: 13 to 19 of them, passing Luhn. */
|
|
7
|
+
function panShaped(digits) {
|
|
8
|
+
if (digits.length < 13 || digits.length > 19)
|
|
9
|
+
return false;
|
|
10
|
+
const sum = [...digits].reverse().reduce((total, digit, index) =>
|
|
11
|
+
// Stryker disable next-line ArithmeticOperator: divisibility by ten does not depend on the sum's sign.
|
|
12
|
+
total + Number(index % 2 === 0 ? digit : DOUBLED[Number(digit)]), 0);
|
|
13
|
+
return sum % 10 === 0;
|
|
14
|
+
}
|
|
15
|
+
/**
|
|
16
|
+
* Whether a value carries something shaped like a primary account number:
|
|
17
|
+
* 13 to 19 digits that pass the Luhn check, written together or grouped by
|
|
18
|
+
* spaces, hyphens or other punctuation (`4111 1111 1111 1111`,
|
|
19
|
+
* `4111-1111-1111-1111`). A letter ends a run, so `tok_4111111111111111`
|
|
20
|
+
* is still caught by the digits after the prefix.
|
|
21
|
+
*
|
|
22
|
+
* A card reference crosses this boundary into a hashed intent, a Decision
|
|
23
|
+
* Dossier and an evidence line, and none of those may ever hold a card
|
|
24
|
+
* number; so a value that merely looks like one is refused, and a reference
|
|
25
|
+
* that is refused by mistake costs a caller a different reference, which is
|
|
26
|
+
* the right side to err on. Both the contiguous run and the run joined
|
|
27
|
+
* across punctuation are checked, so a number cannot hide behind a trailing
|
|
28
|
+
* group of other digits written after a separator.
|
|
29
|
+
*/
|
|
30
|
+
export function containsPan(value) {
|
|
31
|
+
let contiguous = "";
|
|
32
|
+
let joined = "";
|
|
33
|
+
// The trailing letter ends the last run, so it is checked like every other.
|
|
34
|
+
for (const character of `${value}x`) {
|
|
35
|
+
if (character >= "0" && character <= "9") {
|
|
36
|
+
contiguous += character;
|
|
37
|
+
joined += character;
|
|
38
|
+
continue;
|
|
39
|
+
}
|
|
40
|
+
if (panShaped(contiguous))
|
|
41
|
+
return true;
|
|
42
|
+
contiguous = "";
|
|
43
|
+
// A letter is a character with case; punctuation and spaces have none.
|
|
44
|
+
if (character.toLowerCase() !== character.toUpperCase()) {
|
|
45
|
+
if (panShaped(joined))
|
|
46
|
+
return true;
|
|
47
|
+
joined = "";
|
|
48
|
+
}
|
|
49
|
+
}
|
|
50
|
+
return false;
|
|
51
|
+
}
|
|
52
|
+
//# sourceMappingURL=Pan.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Pan.js","sourceRoot":"","sources":["../../../src/adapters/cards/Pan.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,GAAG,YAAY,CAAC;AAE7B,8EAA8E;AAC9E,SAAS,SAAS,CAAC,MAAc;IAC/B,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE,IAAI,MAAM,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,KAAK,CAAC;IAC3D,MAAM,GAAG,GAAG,CAAC,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,MAAM,CACtC,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;IACtB,uGAAuG;IACvG,KAAK,GAAG,MAAM,CAAC,KAAK,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAClE,CAAC,CACF,CAAC;IACF,OAAO,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC;AACxB,CAAC;AAED;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,WAAW,CAAC,KAAa;IACvC,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,4EAA4E;IAC5E,KAAK,MAAM,SAAS,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QACpC,IAAI,SAAS,IAAI,GAAG,IAAI,SAAS,IAAI,GAAG,EAAE,CAAC;YACzC,UAAU,IAAI,SAAS,CAAC;YACxB,MAAM,IAAI,SAAS,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,SAAS,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,CAAC;QACvC,UAAU,GAAG,EAAE,CAAC;QAChB,uEAAuE;QACvE,IAAI,SAAS,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,WAAW,EAAE,EAAE,CAAC;YACxD,IAAI,SAAS,CAAC,MAAM,CAAC;gBAAE,OAAO,IAAI,CAAC;YACnC,MAAM,GAAG,EAAE,CAAC;QACd,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}
|