@payark/sdk-effect 0.1.6 → 0.1.9

package/dist/api-spec.mjs

@@ -10,11 +10,17 @@ var UrlString = Schema.String.pipe(
   Schema.pattern(/^https?:\/\/.+/),
   Schema.brand("UrlString")
 );
-var MinorUnitsInt = Schema.Number.pipe(
+Schema.Number.pipe(
   Schema.int(),
   Schema.greaterThan(0),
   Schema.brand("MinorUnitsInt")
 );
+var NprAmount = Schema.Number.pipe(
+  Schema.filter(
+    (n) => Number.isFinite(n) && n > 0 && Math.round(n * 100) === n * 100
+  ),
+  Schema.brand("NprAmount")
+);
 
 // src/schemas.ts
 var Id = Schema.String.pipe(Schema.brand("Id"));
@@ -26,6 +32,10 @@ var CheckoutSessionId = Schema.String.pipe(
 var SubscriptionId = Schema.String.pipe(
   Schema.brand("SubscriptionId")
 );
+var MandateId = Schema.String.pipe(Schema.brand("MandateId"));
+var AgentSessionId = Schema.String.pipe(
+  Schema.brand("AgentSessionId")
+);
 var CustomerId = Schema.String.pipe(Schema.brand("CustomerId"));
 var TokenId = Schema.String.pipe(Schema.brand("TokenId"));
 var Email = Schema.String.pipe(
@@ -44,6 +54,7 @@ Schema.Struct({
 var Provider = Schema.Literal(
   "esewa",
   "khalti",
+  "hamropay",
   "connectips",
   "imepay",
   "fonepay",
@@ -51,12 +62,27 @@ var Provider = Schema.Literal(
 );
 var PaymentStatus = Schema.Literal("pending", "success", "failed");
 var SubscriptionStatus = Schema.Literal(
+  "pending_checkout",
   "active",
   "past_due",
   "canceled",
   "paused"
 );
 var SubscriptionInterval = Schema.Literal("month", "year", "week");
+var CustomerLifecycle = Schema.Literal(
+  "new",
+  "active",
+  "loyal",
+  "at_risk",
+  "churned"
+);
+var MandateType = Schema.Literal("intent", "cart");
+var MandateStatus = Schema.Literal(
+  "active",
+  "consumed",
+  "expired",
+  "violated"
+);
 var Customer = Schema.Struct({
   id: CustomerId,
   merchant_customer_id: NonEmptyString,
@@ -65,12 +91,18 @@ var Customer = Schema.Struct({
   phone: Schema.NullOr(Schema.String),
   project_id: ProjectId,
   metadata: Schema.NullOr(Metadata),
+  total_ltv: Schema.optional(Schema.Number),
+  is_high_value: Schema.optional(Schema.Boolean),
+  lifecycle_stage: Schema.optional(CustomerLifecycle),
+  ltv_cents: Schema.optional(Schema.Number),
+  tier: Schema.NullOr(Schema.String),
   created_at: Timestamp,
   updated_at: Schema.optional(Timestamp)
 });
 var Payment = Schema.Struct({
   id: PaymentId,
   project_id: ProjectId,
+  customer_id: Schema.optional(Schema.NullOr(CustomerId)),
   amount: Schema.Number,
   currency: Schema.String,
   status: PaymentStatus,
@@ -92,7 +124,9 @@ var Subscription = Schema.Struct({
   current_period_start: Timestamp,
   current_period_end: Timestamp,
   payment_link: UrlString,
+  customer_email: Schema.optional(Schema.NullOr(Schema.String)),
   auto_send_link: Schema.Boolean,
+  grace_days: Schema.optional(Schema.Number),
   metadata: Schema.optional(Schema.NullOr(Metadata)),
   canceled_at: Schema.optional(Schema.NullOr(Timestamp)),
   created_at: Timestamp,
@@ -102,6 +136,13 @@ var Project = Schema.Struct({
   id: ProjectId,
   name: NonEmptyString,
   api_key_secret: Schema.String,
+  subscription_tier: Schema.optional(
+    Schema.Literal("free", "pro", "enterprise")
+  ),
+  subscription_status: Schema.optional(
+    Schema.Literal("active", "past_due", "canceled", "incomplete")
+  ),
+  expires_at: Schema.optional(Schema.NullOr(Timestamp)),
   created_at: Timestamp
 });
 var Token = Schema.Struct({
@@ -112,6 +153,38 @@ var Token = Schema.Struct({
   expires_at: Schema.NullOr(Timestamp),
   created_at: Timestamp
 });
+var Mandate = Schema.Struct({
+  id: MandateId,
+  project_id: ProjectId,
+  customer_id: Schema.NullOr(CustomerId),
+  type: MandateType,
+  status: MandateStatus,
+  principal_id: Schema.String,
+  max_amount: Schema.Number,
+  currency: Schema.String,
+  permitted_vendors: Schema.NullOr(Schema.Array(Schema.String)),
+  valid_from: Timestamp,
+  valid_until: Timestamp,
+  credential_jwt: Schema.String,
+  public_key: Schema.String,
+  signature: Schema.String,
+  parent_mandate_id: Schema.NullOr(MandateId),
+  payment_id: Schema.NullOr(PaymentId),
+  created_at: Timestamp,
+  consumed_at: Schema.NullOr(Timestamp),
+  metadata_json: Metadata
+});
+Schema.Struct({
+  id: AgentSessionId,
+  project_id: ProjectId,
+  context_id: Schema.String,
+  agent_card_url: UrlString,
+  capabilities: Schema.Any,
+  auth_scheme: Schema.Literal("bearer", "mandate"),
+  status: Schema.String,
+  created_at: Timestamp,
+  expires_at: Timestamp
+});
 var PaginationMeta = Schema.Struct({
   total: Schema.NullOr(Schema.Number),
   limit: Schema.Number,
@@ -125,6 +198,8 @@ var WebhookEventType = Schema.Literal(
   "payment.success",
   "payment.failed",
   "subscription.created",
+  "subscription.activated",
+  "subscription.renewed",
   "subscription.payment_succeeded",
   "subscription.payment_failed",
   "subscription.renewal_due",
@@ -149,13 +224,15 @@ Schema.Struct({
   created: Schema.optional(Schema.Number)
 });
 var CreateCheckoutParams = Schema.Struct({
-  amount: Schema.optional(MinorUnitsInt),
+  amount: Schema.optional(NprAmount),
   currency: Schema.optionalWith(Schema.String, { default: () => "NPR" }),
   provider: Provider,
   returnUrl: UrlString,
   cancelUrl: Schema.optional(UrlString),
   metadata: Schema.optional(Metadata),
-  subscriptionId: Schema.optional(SubscriptionId)
+  subscriptionId: Schema.optional(SubscriptionId),
+  customerId: Schema.optional(CustomerId),
+  mandate_id: Schema.optional(MandateId)
 }).pipe(
   Schema.filter((data) => {
     if (!data.subscriptionId && !data.amount) {
@@ -167,6 +244,7 @@ var CreateCheckoutParams = Schema.Struct({
 var CheckoutSession = Schema.Struct({
   id: CheckoutSessionId,
   checkout_url: UrlString,
+  qr_string: Schema.optional(Schema.String),
   payment_method: Schema.Struct({
     type: Provider,
     url: Schema.optional(UrlString),
@@ -200,22 +278,27 @@ var UpdateCustomerParams = Schema.Struct({
   email: Schema.optional(Email),
   name: Schema.optional(NonEmptyString),
   phone: Schema.optional(Schema.String),
+  tier: Schema.optional(Schema.String),
+  merchant_customer_id: Schema.optional(Schema.String),
   metadata: Schema.optional(Metadata)
 });
 var CreateSubscriptionParams = Schema.Struct({
   customer_id: CustomerId,
-  amount: MinorUnitsInt,
+  amount: NprAmount,
   currency: Schema.optionalWith(Schema.String, { default: () => "NPR" }),
   interval: SubscriptionInterval,
   interval_count: Schema.optional(Schema.Number),
   project_id: Schema.optional(ProjectId),
+  customer_email: Schema.optional(Schema.String),
   auto_send_link: Schema.optional(Schema.Boolean),
   metadata: Schema.optional(Metadata)
 });
-var CallbackQueryParams = Schema.Struct({
+Schema.Struct({
   payment_id: Schema.optional(Schema.String),
   data: Schema.optional(Schema.String),
-  pidx: Schema.optional(Schema.String)
+  pidx: Schema.optional(Schema.String),
+  /** HamroPay-specific: the gateway's own transactionId returned on callback. */
+  ref_id: Schema.optional(Schema.String)
 });
 var ListSubscriptionsParams = Schema.Struct({
   limit: Schema.optional(Schema.NumberFromString),
@@ -233,7 +316,8 @@ Schema.Struct({
   baseUrl: Schema.optional(Schema.String),
   timeout: Schema.optional(Schema.Number),
   maxRetries: Schema.optional(Schema.Number),
-  sandbox: Schema.optional(Schema.Boolean)
+  sandbox: Schema.optional(Schema.Boolean),
+  signingPrivateKey: Schema.optional(Schema.String)
 });
 Schema.Struct({
   error: Schema.String,
@@ -243,21 +327,30 @@ var IndustrialError = class extends Schema.TaggedError()(
   "IndustrialError",
   {
     error: Schema.String,
-    details: Schema.optional(Schema.Any)
+    details: Schema.optional(Schema.Any),
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
   }
 ) {
 };
 var AuthenticationError = class extends Schema.TaggedError()(
   "AuthenticationError",
   {
-    error: Schema.String
+    error: Schema.String,
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
   }
 ) {
 };
 var NotFoundError = class extends Schema.TaggedError()(
   "NotFoundError",
   {
-    error: Schema.String
+    error: Schema.String,
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
   }
 ) {
 };
@@ -265,14 +358,43 @@ var InternalServerError = class extends Schema.TaggedError()(
   "InternalServerError",
   {
     error: Schema.String,
-    details: Schema.optional(Schema.Any)
+    details: Schema.optional(Schema.Any),
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
   }
 ) {
 };
 var ConflictError = class extends Schema.TaggedError()(
   "ConflictError",
   {
-    error: Schema.String
+    error: Schema.String,
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
+  }
+) {
+};
+var MandateViolationError = class extends Schema.TaggedError()(
+  "MandateViolationError",
+  {
+    error: Schema.String,
+    mandateId: Schema.optional(Schema.String),
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
+  }
+) {
+};
+var MandateExpiredError = class extends Schema.TaggedError()(
+  "MandateExpiredError",
+  {
+    error: Schema.String,
+    mandateId: MandateId,
+    expiredAt: Timestamp,
+    code: Schema.optional(Schema.String),
+    doc_url: Schema.optional(Schema.String),
+    suggestion: Schema.optional(Schema.String)
   }
 ) {
 };
@@ -363,7 +485,22 @@ var AutomationGroup = HttpApiGroup.make("automation").add(
   HttpApiEndpoint.post("reaper", "/reaper").addSuccess(
     Schema.Struct({
       message: Schema.String,
-      count: Schema.Number
+      count: Schema.Number,
+      purged_projects: Schema.Number
+    })
+  ).addError(InternalServerError, { status: 500 })
+).add(
+  HttpApiEndpoint.post("processRenewals", "/process-renewals").addSuccess(
+    Schema.Struct({
+      message: Schema.String,
+      emails_sent: Schema.Number
+    })
+  ).addError(InternalServerError, { status: 500 })
+).add(
+  HttpApiEndpoint.post("processGracePeriod", "/process-grace-period").addSuccess(
+    Schema.Struct({
+      message: Schema.String,
+      marked_past_due: Schema.Number
     })
   ).addError(InternalServerError, { status: 500 })
 ).prefix("/v1/automation").middleware(CronSecurity);
@@ -389,10 +526,30 @@ var TokensGroup = HttpApiGroup.make("tokens").add(
 ).prefix("/v1/tokens").middleware(UserSecurity);
 var ProjectsGroup = HttpApiGroup.make("projects").add(
   HttpApiEndpoint.get("list", "/").addSuccess(Schema.Array(Project)).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
-).prefix("/v1/projects").middleware(SecurityMiddleware);
+).add(
+  HttpApiEndpoint.post("upgrade", "/:id/upgrade").addSuccess(Project).setPath(Schema.Struct({ id: ProjectId })).setPayload(Schema.Struct({ tier: Schema.Literal("pro", "enterprise") })).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
+).prefix("/v1/projects").middleware(UserSecurity);
+var PaymentCallbackQueryParams = Schema.Struct({
+  payment_id: Schema.optional(Schema.String),
+  data: Schema.optional(Schema.String),
+  pidx: Schema.optional(Schema.String),
+  /** HamroPay-specific: the gateway's own transactionId returned on callback. */
+  ref_id: Schema.optional(Schema.String),
+  /** Supabase Auth: access_token and refresh_token can be in the fragment or query */
+  access_token: Schema.optional(Schema.String),
+  refresh_token: Schema.optional(Schema.String),
+  code: Schema.optional(Schema.String)
+});
 var CallbacksGroup = HttpApiGroup.make("callbacks").add(
-  HttpApiEndpoint.get("handle", "/:provider").addSuccess(Schema.Any).setPath(Schema.Struct({ provider: Schema.String })).setUrlParams(CallbackQueryParams).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+  HttpApiEndpoint.get("handle", "/:provider").addSuccess(Schema.Any).setPath(Schema.Struct({ provider: Schema.String })).setUrlParams(PaymentCallbackQueryParams).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
 ).prefix("/v1/callback");
+var AuthCallbackQueryParams = Schema.Struct({
+  code: Schema.optional(Schema.String),
+  next: Schema.optional(Schema.String)
+});
+var AuthGroup = HttpApiGroup.make("auth").add(
+  HttpApiEndpoint.post("callback", "/callback").addSuccess(Schema.Any).setUrlParams(AuthCallbackQueryParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
+).prefix("/auth");
 var RealtimeGroup = HttpApiGroup.make("realtime").add(
   HttpApiEndpoint.get("connect", "/").addSuccess(Schema.Any).setUrlParams(Schema.Struct({ token: Schema.String })).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
 ).add(
@@ -403,8 +560,63 @@ var RealtimeGroup = HttpApiGroup.make("realtime").add(
     })
   ).setPayload(RealtimeTriggerPayload).setUrlParams(Schema.Struct({ token: Schema.optional(Schema.String) })).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
 ).prefix("/v1/realtime");
-var PayArkApi = HttpApi.make("PayArkApi").add(CheckoutGroup).add(PaymentsGroup).add(CustomersGroup).add(SubscriptionsGroup).add(AutomationGroup).add(TokensGroup).add(ProjectsGroup).add(CallbacksGroup).add(RealtimeGroup).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(ConflictError, { status: 409 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 });
+var MandatesGroup = HttpApiGroup.make("mandates").add(
+  HttpApiEndpoint.post("registerIntent", "/intent").addSuccess(Mandate, { status: 201 }).setPayload(
+    Schema.Struct({
+      principal_id: Schema.String,
+      max_amount: Schema.Number,
+      currency: Schema.String,
+      valid_until: Timestamp,
+      permitted_vendors: Schema.optional(Schema.Array(Schema.String)),
+      credential_jwt: Schema.String,
+      public_key: Schema.String,
+      customer_id: Schema.optional(CustomerId)
+    })
+  ).addError(AuthenticationError, { status: 401 }).addError(IndustrialError, { status: 400 })
+).add(
+  HttpApiEndpoint.get("retrieve", "/:id").addSuccess(Mandate).setPath(Schema.Struct({ id: MandateId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 })
+).prefix("/v1/mandates").middleware(SecurityMiddleware);
+var SandboxGroup = HttpApiGroup.make("sandbox").add(
+  HttpApiEndpoint.post("init", "/init").addSuccess(
+    Schema.Struct({
+      projectId: Schema.String,
+      apiKey: Schema.optional(Schema.String),
+      expiresAt: Timestamp,
+      session: Schema.optional(
+        Schema.Struct({
+          access_token: Schema.String,
+          refresh_token: Schema.String
+        })
+      )
+    })
+  ).addError(InternalServerError, { status: 500 })
+).prefix("/v1/sandbox").middleware(UserSecurity);
+var DiscoveryGroup = HttpApiGroup.make("discovery").add(
+  HttpApiEndpoint.get("agentCard", "/agent.json").addSuccess(Schema.Any).addError(InternalServerError, { status: 500 })
+).prefix("/.well-known");
+var SigningKeysGroup = HttpApiGroup.make("signingKeys").add(
+  HttpApiEndpoint.post("generate", "/").addSuccess(
+    Schema.Struct({
+      id: Schema.String,
+      publicKey: Schema.String,
+      privateKey: Schema.String,
+      algorithm: Schema.String,
+      createdAt: Timestamp
+    }),
+    { status: 201 }
+  ).setPath(Schema.Struct({ id: ProjectId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 })
+).add(
+  HttpApiEndpoint.get("get", "/").addSuccess(
+    Schema.Struct({
+      id: Schema.String,
+      publicKey: Schema.String,
+      algorithm: Schema.String,
+      createdAt: Timestamp
+    })
+  ).setPath(Schema.Struct({ id: ProjectId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 })
+).prefix("/v1/projects/:id/signing-keys").middleware(UserSecurity);
+var PayArkApi = HttpApi.make("PayArkApi").add(CheckoutGroup).add(PaymentsGroup).add(CustomersGroup).add(SubscriptionsGroup).add(AutomationGroup).add(TokensGroup).add(ProjectsGroup).add(CallbacksGroup).add(AuthGroup).add(MandatesGroup).add(DiscoveryGroup).add(RealtimeGroup).add(SandboxGroup).add(SigningKeysGroup).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(MandateViolationError, { status: 403 }).addError(MandateExpiredError, { status: 410 }).addError(ConflictError, { status: 409 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 });
 
-export { AuthContext, AuthenticationError, AutomationGroup, CallbacksGroup, CheckoutGroup, ConflictError, CronSecurity, CustomersGroup, IndustrialError, InternalServerError, NotFoundError, PayArkApi, PaymentsGroup, ProjectsGroup, RealtimeGroup, SecurityMiddleware, SubscriptionsGroup, TokensGroup, UserSecurity };
+export { AuthCallbackQueryParams, AuthContext, AuthGroup, AuthenticationError, AutomationGroup, CallbacksGroup, CheckoutGroup, ConflictError, CronSecurity, CustomersGroup, DiscoveryGroup, IndustrialError, InternalServerError, MandateExpiredError, MandateViolationError, MandatesGroup, NotFoundError, PayArkApi, PaymentCallbackQueryParams, PaymentsGroup, ProjectsGroup, RealtimeGroup, SandboxGroup, SecurityMiddleware, SigningKeysGroup, SubscriptionsGroup, TokensGroup, UserSecurity };
 //# sourceMappingURL=api-spec.mjs.map
 //# sourceMappingURL=api-spec.mjs.map