@payark/sdk-effect 0.1.6 → 0.1.9

package/dist/index.js

@@ -12,11 +12,17 @@ var UrlString = effect.Schema.String.pipe(
   effect.Schema.pattern(/^https?:\/\/.+/),
   effect.Schema.brand("UrlString")
 );
-var MinorUnitsInt = effect.Schema.Number.pipe(
+effect.Schema.Number.pipe(
   effect.Schema.int(),
   effect.Schema.greaterThan(0),
   effect.Schema.brand("MinorUnitsInt")
 );
+var NprAmount = effect.Schema.Number.pipe(
+  effect.Schema.filter(
+    (n) => Number.isFinite(n) && n > 0 && Math.round(n * 100) === n * 100
+  ),
+  effect.Schema.brand("NprAmount")
+);
 
 // src/schemas.ts
 var Id = effect.Schema.String.pipe(effect.Schema.brand("Id"));
@@ -28,6 +34,10 @@ var CheckoutSessionId = effect.Schema.String.pipe(
 var SubscriptionId = effect.Schema.String.pipe(
   effect.Schema.brand("SubscriptionId")
 );
+var MandateId = effect.Schema.String.pipe(effect.Schema.brand("MandateId"));
+var AgentSessionId = effect.Schema.String.pipe(
+  effect.Schema.brand("AgentSessionId")
+);
 var CustomerId = effect.Schema.String.pipe(effect.Schema.brand("CustomerId"));
 var TokenId = effect.Schema.String.pipe(effect.Schema.brand("TokenId"));
 var Email = effect.Schema.String.pipe(
@@ -46,6 +56,7 @@ var Timestamps = effect.Schema.Struct({
 var Provider = effect.Schema.Literal(
   "esewa",
   "khalti",
+  "hamropay",
   "connectips",
   "imepay",
   "fonepay",
@@ -53,12 +64,27 @@ var Provider = effect.Schema.Literal(
 );
 var PaymentStatus = effect.Schema.Literal("pending", "success", "failed");
 var SubscriptionStatus = effect.Schema.Literal(
+  "pending_checkout",
   "active",
   "past_due",
   "canceled",
   "paused"
 );
 var SubscriptionInterval = effect.Schema.Literal("month", "year", "week");
+var CustomerLifecycle = effect.Schema.Literal(
+  "new",
+  "active",
+  "loyal",
+  "at_risk",
+  "churned"
+);
+var MandateType = effect.Schema.Literal("intent", "cart");
+var MandateStatus = effect.Schema.Literal(
+  "active",
+  "consumed",
+  "expired",
+  "violated"
+);
 var Customer = effect.Schema.Struct({
   id: CustomerId,
   merchant_customer_id: NonEmptyString,
@@ -67,12 +93,18 @@ var Customer = effect.Schema.Struct({
   phone: effect.Schema.NullOr(effect.Schema.String),
   project_id: ProjectId,
   metadata: effect.Schema.NullOr(Metadata),
+  total_ltv: effect.Schema.optional(effect.Schema.Number),
+  is_high_value: effect.Schema.optional(effect.Schema.Boolean),
+  lifecycle_stage: effect.Schema.optional(CustomerLifecycle),
+  ltv_cents: effect.Schema.optional(effect.Schema.Number),
+  tier: effect.Schema.NullOr(effect.Schema.String),
   created_at: Timestamp,
   updated_at: effect.Schema.optional(Timestamp)
 });
 var Payment = effect.Schema.Struct({
   id: PaymentId,
   project_id: ProjectId,
+  customer_id: effect.Schema.optional(effect.Schema.NullOr(CustomerId)),
   amount: effect.Schema.Number,
   currency: effect.Schema.String,
   status: PaymentStatus,
@@ -94,7 +126,9 @@ var Subscription = effect.Schema.Struct({
   current_period_start: Timestamp,
   current_period_end: Timestamp,
   payment_link: UrlString,
+  customer_email: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.String)),
   auto_send_link: effect.Schema.Boolean,
+  grace_days: effect.Schema.optional(effect.Schema.Number),
   metadata: effect.Schema.optional(effect.Schema.NullOr(Metadata)),
   canceled_at: effect.Schema.optional(effect.Schema.NullOr(Timestamp)),
   created_at: Timestamp,
@@ -104,6 +138,13 @@ var Project = effect.Schema.Struct({
   id: ProjectId,
   name: NonEmptyString,
   api_key_secret: effect.Schema.String,
+  subscription_tier: effect.Schema.optional(
+    effect.Schema.Literal("free", "pro", "enterprise")
+  ),
+  subscription_status: effect.Schema.optional(
+    effect.Schema.Literal("active", "past_due", "canceled", "incomplete")
+  ),
+  expires_at: effect.Schema.optional(effect.Schema.NullOr(Timestamp)),
   created_at: Timestamp
 });
 var Token = effect.Schema.Struct({
@@ -114,6 +155,38 @@ var Token = effect.Schema.Struct({
   expires_at: effect.Schema.NullOr(Timestamp),
   created_at: Timestamp
 });
+var Mandate = effect.Schema.Struct({
+  id: MandateId,
+  project_id: ProjectId,
+  customer_id: effect.Schema.NullOr(CustomerId),
+  type: MandateType,
+  status: MandateStatus,
+  principal_id: effect.Schema.String,
+  max_amount: effect.Schema.Number,
+  currency: effect.Schema.String,
+  permitted_vendors: effect.Schema.NullOr(effect.Schema.Array(effect.Schema.String)),
+  valid_from: Timestamp,
+  valid_until: Timestamp,
+  credential_jwt: effect.Schema.String,
+  public_key: effect.Schema.String,
+  signature: effect.Schema.String,
+  parent_mandate_id: effect.Schema.NullOr(MandateId),
+  payment_id: effect.Schema.NullOr(PaymentId),
+  created_at: Timestamp,
+  consumed_at: effect.Schema.NullOr(Timestamp),
+  metadata_json: Metadata
+});
+var AgentSession = effect.Schema.Struct({
+  id: AgentSessionId,
+  project_id: ProjectId,
+  context_id: effect.Schema.String,
+  agent_card_url: UrlString,
+  capabilities: effect.Schema.Any,
+  auth_scheme: effect.Schema.Literal("bearer", "mandate"),
+  status: effect.Schema.String,
+  created_at: Timestamp,
+  expires_at: Timestamp
+});
 var PaginationMeta = effect.Schema.Struct({
   total: effect.Schema.NullOr(effect.Schema.Number),
   limit: effect.Schema.Number,
@@ -127,6 +200,8 @@ var WebhookEventType = effect.Schema.Literal(
   "payment.success",
   "payment.failed",
   "subscription.created",
+  "subscription.activated",
+  "subscription.renewed",
   "subscription.payment_succeeded",
   "subscription.payment_failed",
   "subscription.renewal_due",
@@ -151,13 +226,15 @@ var WebhookEvent = effect.Schema.Struct({
   created: effect.Schema.optional(effect.Schema.Number)
 });
 var CreateCheckoutParams = effect.Schema.Struct({
-  amount: effect.Schema.optional(MinorUnitsInt),
+  amount: effect.Schema.optional(NprAmount),
   currency: effect.Schema.optionalWith(effect.Schema.String, { default: () => "NPR" }),
   provider: Provider,
   returnUrl: UrlString,
   cancelUrl: effect.Schema.optional(UrlString),
   metadata: effect.Schema.optional(Metadata),
-  subscriptionId: effect.Schema.optional(SubscriptionId)
+  subscriptionId: effect.Schema.optional(SubscriptionId),
+  customerId: effect.Schema.optional(CustomerId),
+  mandate_id: effect.Schema.optional(MandateId)
 }).pipe(
   effect.Schema.filter((data) => {
     if (!data.subscriptionId && !data.amount) {
@@ -169,6 +246,7 @@ var CreateCheckoutParams = effect.Schema.Struct({
 var CheckoutSession = effect.Schema.Struct({
   id: CheckoutSessionId,
   checkout_url: UrlString,
+  qr_string: effect.Schema.optional(effect.Schema.String),
   payment_method: effect.Schema.Struct({
     type: Provider,
     url: effect.Schema.optional(UrlString),
@@ -202,22 +280,27 @@ var UpdateCustomerParams = effect.Schema.Struct({
   email: effect.Schema.optional(Email),
   name: effect.Schema.optional(NonEmptyString),
   phone: effect.Schema.optional(effect.Schema.String),
+  tier: effect.Schema.optional(effect.Schema.String),
+  merchant_customer_id: effect.Schema.optional(effect.Schema.String),
   metadata: effect.Schema.optional(Metadata)
 });
 var CreateSubscriptionParams = effect.Schema.Struct({
   customer_id: CustomerId,
-  amount: MinorUnitsInt,
+  amount: NprAmount,
   currency: effect.Schema.optionalWith(effect.Schema.String, { default: () => "NPR" }),
   interval: SubscriptionInterval,
   interval_count: effect.Schema.optional(effect.Schema.Number),
   project_id: effect.Schema.optional(ProjectId),
+  customer_email: effect.Schema.optional(effect.Schema.String),
   auto_send_link: effect.Schema.optional(effect.Schema.Boolean),
   metadata: effect.Schema.optional(Metadata)
 });
 var CallbackQueryParams = effect.Schema.Struct({
   payment_id: effect.Schema.optional(effect.Schema.String),
   data: effect.Schema.optional(effect.Schema.String),
-  pidx: effect.Schema.optional(effect.Schema.String)
+  pidx: effect.Schema.optional(effect.Schema.String),
+  /** HamroPay-specific: the gateway's own transactionId returned on callback. */
+  ref_id: effect.Schema.optional(effect.Schema.String)
 });
 var ListSubscriptionsParams = effect.Schema.Struct({
   limit: effect.Schema.optional(effect.Schema.NumberFromString),
@@ -235,7 +318,8 @@ var PayArkConfig = effect.Schema.Struct({
   baseUrl: effect.Schema.optional(effect.Schema.String),
   timeout: effect.Schema.optional(effect.Schema.Number),
   maxRetries: effect.Schema.optional(effect.Schema.Number),
-  sandbox: effect.Schema.optional(effect.Schema.Boolean)
+  sandbox: effect.Schema.optional(effect.Schema.Boolean),
+  signingPrivateKey: effect.Schema.optional(effect.Schema.String)
 });
 var PayArkErrorBody = effect.Schema.Struct({
   error: effect.Schema.String,
@@ -245,21 +329,30 @@ var IndustrialError = class extends effect.Schema.TaggedError()(
   "IndustrialError",
   {
     error: effect.Schema.String,
-    details: effect.Schema.optional(effect.Schema.Any)
+    details: effect.Schema.optional(effect.Schema.Any),
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
   }
 ) {
 };
 var AuthenticationError = class extends effect.Schema.TaggedError()(
   "AuthenticationError",
   {
-    error: effect.Schema.String
+    error: effect.Schema.String,
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
   }
 ) {
 };
 var NotFoundError = class extends effect.Schema.TaggedError()(
   "NotFoundError",
   {
-    error: effect.Schema.String
+    error: effect.Schema.String,
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
   }
 ) {
 };
@@ -267,14 +360,43 @@ var InternalServerError = class extends effect.Schema.TaggedError()(
   "InternalServerError",
   {
     error: effect.Schema.String,
-    details: effect.Schema.optional(effect.Schema.Any)
+    details: effect.Schema.optional(effect.Schema.Any),
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
   }
 ) {
 };
 var ConflictError = class extends effect.Schema.TaggedError()(
   "ConflictError",
   {
-    error: effect.Schema.String
+    error: effect.Schema.String,
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
+  }
+) {
+};
+var MandateViolationError = class extends effect.Schema.TaggedError()(
+  "MandateViolationError",
+  {
+    error: effect.Schema.String,
+    mandateId: effect.Schema.optional(effect.Schema.String),
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
+  }
+) {
+};
+var MandateExpiredError = class extends effect.Schema.TaggedError()(
+  "MandateExpiredError",
+  {
+    error: effect.Schema.String,
+    mandateId: MandateId,
+    expiredAt: Timestamp,
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
   }
 ) {
 };
@@ -365,7 +487,22 @@ var AutomationGroup = platform.HttpApiGroup.make("automation").add(
   platform.HttpApiEndpoint.post("reaper", "/reaper").addSuccess(
     effect.Schema.Struct({
       message: effect.Schema.String,
-      count: effect.Schema.Number
+      count: effect.Schema.Number,
+      purged_projects: effect.Schema.Number
+    })
+  ).addError(InternalServerError, { status: 500 })
+).add(
+  platform.HttpApiEndpoint.post("processRenewals", "/process-renewals").addSuccess(
+    effect.Schema.Struct({
+      message: effect.Schema.String,
+      emails_sent: effect.Schema.Number
+    })
+  ).addError(InternalServerError, { status: 500 })
+).add(
+  platform.HttpApiEndpoint.post("processGracePeriod", "/process-grace-period").addSuccess(
+    effect.Schema.Struct({
+      message: effect.Schema.String,
+      marked_past_due: effect.Schema.Number
     })
   ).addError(InternalServerError, { status: 500 })
 ).prefix("/v1/automation").middleware(CronSecurity);
@@ -391,10 +528,30 @@ var TokensGroup = platform.HttpApiGroup.make("tokens").add(
 ).prefix("/v1/tokens").middleware(UserSecurity);
 var ProjectsGroup = platform.HttpApiGroup.make("projects").add(
   platform.HttpApiEndpoint.get("list", "/").addSuccess(effect.Schema.Array(Project)).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
-).prefix("/v1/projects").middleware(SecurityMiddleware);
+).add(
+  platform.HttpApiEndpoint.post("upgrade", "/:id/upgrade").addSuccess(Project).setPath(effect.Schema.Struct({ id: ProjectId })).setPayload(effect.Schema.Struct({ tier: effect.Schema.Literal("pro", "enterprise") })).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
+).prefix("/v1/projects").middleware(UserSecurity);
+var PaymentCallbackQueryParams = effect.Schema.Struct({
+  payment_id: effect.Schema.optional(effect.Schema.String),
+  data: effect.Schema.optional(effect.Schema.String),
+  pidx: effect.Schema.optional(effect.Schema.String),
+  /** HamroPay-specific: the gateway's own transactionId returned on callback. */
+  ref_id: effect.Schema.optional(effect.Schema.String),
+  /** Supabase Auth: access_token and refresh_token can be in the fragment or query */
+  access_token: effect.Schema.optional(effect.Schema.String),
+  refresh_token: effect.Schema.optional(effect.Schema.String),
+  code: effect.Schema.optional(effect.Schema.String)
+});
 var CallbacksGroup = platform.HttpApiGroup.make("callbacks").add(
-  platform.HttpApiEndpoint.get("handle", "/:provider").addSuccess(effect.Schema.Any).setPath(effect.Schema.Struct({ provider: effect.Schema.String })).setUrlParams(CallbackQueryParams).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+  platform.HttpApiEndpoint.get("handle", "/:provider").addSuccess(effect.Schema.Any).setPath(effect.Schema.Struct({ provider: effect.Schema.String })).setUrlParams(PaymentCallbackQueryParams).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
 ).prefix("/v1/callback");
+var AuthCallbackQueryParams = effect.Schema.Struct({
+  code: effect.Schema.optional(effect.Schema.String),
+  next: effect.Schema.optional(effect.Schema.String)
+});
+var AuthGroup = platform.HttpApiGroup.make("auth").add(
+  platform.HttpApiEndpoint.post("callback", "/callback").addSuccess(effect.Schema.Any).setUrlParams(AuthCallbackQueryParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
+).prefix("/auth");
 var RealtimeGroup = platform.HttpApiGroup.make("realtime").add(
   platform.HttpApiEndpoint.get("connect", "/").addSuccess(effect.Schema.Any).setUrlParams(effect.Schema.Struct({ token: effect.Schema.String })).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
 ).add(
@@ -405,22 +562,92 @@ var RealtimeGroup = platform.HttpApiGroup.make("realtime").add(
     })
   ).setPayload(RealtimeTriggerPayload).setUrlParams(effect.Schema.Struct({ token: effect.Schema.optional(effect.Schema.String) })).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
 ).prefix("/v1/realtime");
-var PayArkApi = platform.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 = platform.HttpApiGroup.make("mandates").add(
+  platform.HttpApiEndpoint.post("registerIntent", "/intent").addSuccess(Mandate, { status: 201 }).setPayload(
+    effect.Schema.Struct({
+      principal_id: effect.Schema.String,
+      max_amount: effect.Schema.Number,
+      currency: effect.Schema.String,
+      valid_until: Timestamp,
+      permitted_vendors: effect.Schema.optional(effect.Schema.Array(effect.Schema.String)),
+      credential_jwt: effect.Schema.String,
+      public_key: effect.Schema.String,
+      customer_id: effect.Schema.optional(CustomerId)
+    })
+  ).addError(AuthenticationError, { status: 401 }).addError(IndustrialError, { status: 400 })
+).add(
+  platform.HttpApiEndpoint.get("retrieve", "/:id").addSuccess(Mandate).setPath(effect.Schema.Struct({ id: MandateId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 })
+).prefix("/v1/mandates").middleware(SecurityMiddleware);
+var SandboxGroup = platform.HttpApiGroup.make("sandbox").add(
+  platform.HttpApiEndpoint.post("init", "/init").addSuccess(
+    effect.Schema.Struct({
+      projectId: effect.Schema.String,
+      apiKey: effect.Schema.optional(effect.Schema.String),
+      expiresAt: Timestamp,
+      session: effect.Schema.optional(
+        effect.Schema.Struct({
+          access_token: effect.Schema.String,
+          refresh_token: effect.Schema.String
+        })
+      )
+    })
+  ).addError(InternalServerError, { status: 500 })
+).prefix("/v1/sandbox").middleware(UserSecurity);
+var DiscoveryGroup = platform.HttpApiGroup.make("discovery").add(
+  platform.HttpApiEndpoint.get("agentCard", "/agent.json").addSuccess(effect.Schema.Any).addError(InternalServerError, { status: 500 })
+).prefix("/.well-known");
+var SigningKeysGroup = platform.HttpApiGroup.make("signingKeys").add(
+  platform.HttpApiEndpoint.post("generate", "/").addSuccess(
+    effect.Schema.Struct({
+      id: effect.Schema.String,
+      publicKey: effect.Schema.String,
+      privateKey: effect.Schema.String,
+      algorithm: effect.Schema.String,
+      createdAt: Timestamp
+    }),
+    { status: 201 }
+  ).setPath(effect.Schema.Struct({ id: ProjectId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 })
+).add(
+  platform.HttpApiEndpoint.get("get", "/").addSuccess(
+    effect.Schema.Struct({
+      id: effect.Schema.String,
+      publicKey: effect.Schema.String,
+      algorithm: effect.Schema.String,
+      createdAt: Timestamp
+    })
+  ).setPath(effect.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 = platform.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 });
 var PayArkEffectError = class extends effect.Data.TaggedError("PayArkEffectError") {
   /** Human-readable representation for logging/debugging. */
   toString() {
-    return `[PayArkEffectError: ${this.code}] ${this.message} (HTTP ${this.statusCode})`;
+    return `[PayArkEffectError: ${this.code}] ${this.localizedMessage || this.message} (HTTP ${this.statusCode})`;
   }
 };
+var MandateViolationError2 = class extends effect.Data.TaggedError(
+  "MandateViolationError"
+) {
+  statusCode = 403;
+  code = "mandate_violation";
+};
+var MandateExpiredError2 = class extends effect.Data.TaggedError(
+  "MandateExpiredError"
+) {
+  statusCode = 410;
+  code = "mandate_expired";
+};
 
 // src/http.ts
-var SDK_VERSION = "0.1.0";
+var SDK_VERSION = "0.1.8";
 var PayArkConfigService = class extends effect.Context.Tag("PayArkConfigService")() {
 };
 var request = (method, path, options) => effect.Effect.gen(function* (_) {
   const config = yield* _(PayArkConfigService);
   const client = yield* _(platform.HttpClient.HttpClient);
-  const baseUrl = (config.baseUrl ?? "https://payark-api.codimo-dev.workers.dev").replace(/\/+$/, "");
+  const baseUrl = (config.baseUrl ?? "https://api.payark.dev").replace(
+    /\/+$/,
+    ""
+  );
   const url = new URL(`${baseUrl}${path}`);
   if (options?.query) {
     for (const [key, value] of Object.entries(options.query)) {
@@ -449,7 +676,8 @@ var request = (method, path, options) => effect.Effect.gen(function* (_) {
           (e) => new PayArkEffectError({
             message: `Invalid request body: ${String(e)}`,
             statusCode: 400,
-            code: "invalid_request_error"
+            code: "invalid_request_error",
+            localizedMessage: getLocalizedError("invalid_request_error")
           })
         )
       )
@@ -461,7 +689,8 @@ var request = (method, path, options) => effect.Effect.gen(function* (_) {
         (e) => new PayArkEffectError({
           message: `Network error: ${e.message}`,
           statusCode: 0,
-          code: "connection_error"
+          code: "connection_error",
+          localizedMessage: getLocalizedError("connection_error")
         })
       )
     )
@@ -474,7 +703,8 @@ var request = (method, path, options) => effect.Effect.gen(function* (_) {
           (e) => new PayArkEffectError({
             message: `Failed to parse response: ${String(e)}`,
             statusCode: response.status,
-            code: "api_error"
+            code: "api_error",
+            localizedMessage: getLocalizedError("api_error")
           })
         )
       )
@@ -491,11 +721,22 @@ var request = (method, path, options) => effect.Effect.gen(function* (_) {
         message: errorBody?.error || `Request failed with status ${response.status}`,
         statusCode: response.status,
         code: mapStatusToCode(response.status),
-        raw: errorBody
+        raw: errorBody,
+        localizedMessage: getLocalizedError(mapStatusToCode(response.status))
       })
     )
   );
-});
+}).pipe(
+  effect.Effect.retry(
+    effect.Schedule.exponential("200 millis").pipe(
+      effect.Schedule.upTo("5 seconds"),
+      // Only retry connection-level or 429/5xx transient errors:
+      effect.Schedule.check((error) => {
+        return error.code === "connection_error" || error.code === "rate_limit_error" || error.statusCode >= 500;
+      })
+    )
+  )
+);
 function mapStatusToCode(status) {
   if (status === 401) return "authentication_error";
   if (status === 403) return "permission_error";
@@ -505,6 +746,26 @@ function mapStatusToCode(status) {
   if (status >= 500) return "api_error";
   return "unknown_error";
 }
+function getLocalizedError(code) {
+  switch (code) {
+    case "authentication_error":
+      return "Your API key is missing or invalid. Please check your PayArk credentials.";
+    case "permission_error":
+      return "You don't have permission to perform this action.";
+    case "invalid_request_error":
+      return "The request is missing required parameters or they are invalid. Please check your implementation.";
+    case "not_found_error":
+      return "The requested resource could not be found.";
+    case "rate_limit_error":
+      return "You are making too many requests to PayArk. Please wait a moment before trying again.";
+    case "api_error":
+      return "PayArk servers are currently experiencing issues. Please try again later.";
+    case "connection_error":
+      return "Could not connect to PayArk. Please check your internet connection.";
+    default:
+      return "An unexpected error occurred. Please contact support if the issue persists.";
+  }
+}
 
 // src/resources/checkout.ts
 var CheckoutEffect = class {
@@ -578,6 +839,261 @@ var ProjectsEffect = class {
     );
   }
 };
+var CustomersEffect = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Create a new customer for a project.
+   */
+  create(params) {
+    return request("POST", "/v1/customers", { body: params }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Customer)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * List customers for the authenticated project.
+   */
+  list(params = {}) {
+    return request("GET", "/v1/customers", {
+      query: {
+        limit: params.limit,
+        offset: params.offset,
+        projectId: params.projectId,
+        email: params.email,
+        merchant_customer_id: params.merchant_customer_id
+      }
+    }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(PaginatedResponse(Customer))),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Retrieve a single customer by ID.
+   */
+  retrieve(id) {
+    return request(
+      "GET",
+      `/v1/customers/${encodeURIComponent(id)}`
+    ).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Customer)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Update a customer.
+   */
+  update(id, params) {
+    return request(
+      "PATCH",
+      `/v1/customers/${encodeURIComponent(id)}`,
+      {
+        body: params
+      }
+    ).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Customer)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Delete a customer.
+   */
+  delete(id) {
+    return request(
+      "DELETE",
+      `/v1/customers/${encodeURIComponent(id)}`
+    ).pipe(effect.Effect.provideService(PayArkConfigService, this.config));
+  }
+};
+var SubscriptionsEffect = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Create a new subscription.
+   */
+  create(params) {
+    return request("POST", "/v1/subscriptions", { body: params }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Subscription)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * List subscriptions for the authenticated project.
+   */
+  list(params = {}) {
+    return request("GET", "/v1/subscriptions", {
+      query: {
+        limit: params.limit,
+        offset: params.offset,
+        projectId: params.projectId,
+        customerId: params.customerId,
+        status: params.status
+      }
+    }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(PaginatedResponse(Subscription))),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Retrieve a single subscription by ID.
+   */
+  retrieve(id) {
+    return request(
+      "GET",
+      `/v1/subscriptions/${encodeURIComponent(id)}`
+    ).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Subscription)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Cancel a subscription.
+   */
+  cancel(id) {
+    return request(
+      "POST",
+      `/v1/subscriptions/${encodeURIComponent(id)}/cancel`
+    ).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Subscription)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Activate a subscription (returns payment info).
+   */
+  activate(id, params) {
+    const activateSchema = effect.Schema.Struct({
+      checkout_url: effect.Schema.String,
+      payment_id: effect.Schema.String
+    });
+    return request(
+      "POST",
+      `/v1/subscriptions/${encodeURIComponent(id)}/activate`,
+      { body: params }
+    ).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(activateSchema)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+};
+var MandatesEffect = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Register a mandate intent.
+   */
+  registerIntent(params) {
+    return request("POST", "/v1/mandates/intent", {
+      body: params
+    }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Mandate)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Retrieve a mandate.
+   */
+  retrieve(id) {
+    return request(
+      "GET",
+      `/v1/mandates/${encodeURIComponent(id)}`
+    ).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(Mandate)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+};
+var TokensEffect = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Create a new token.
+   */
+  create(params) {
+    const createTokenSchema = effect.Schema.Struct({
+      ...Token.fields,
+      token: effect.Schema.String
+    });
+    return request("POST", "/v1/tokens", { body: params }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(createTokenSchema)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * List all tokens.
+   */
+  list() {
+    return request("GET", "/v1/tokens").pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(effect.Schema.Array(Token))),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Delete/revoke a token.
+   */
+  delete(id) {
+    return request("DELETE", `/v1/tokens/${encodeURIComponent(id)}`).pipe(
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+};
+var RealtimeEffect = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Manually trigger a realtime event.
+   */
+  trigger(params) {
+    const triggerSchema = effect.Schema.Struct({
+      status: effect.Schema.String,
+      event: effect.Schema.optional(effect.Schema.String)
+    });
+    return request("POST", "/v1/realtime/trigger", {
+      body: params,
+      query: { token: params.token }
+    }).pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(triggerSchema)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+};
+var AutomationEffect = class {
+  constructor(config) {
+    this.config = config;
+  }
+  /**
+   * Send reminders.
+   */
+  reminders() {
+    const automationSchema = effect.Schema.Struct({
+      message: effect.Schema.String,
+      count: effect.Schema.Number
+    });
+    return request("POST", "/v1/automation/reminders").pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(automationSchema)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+  /**
+   * Run reaper.
+   */
+  reaper() {
+    const reaperSchema = effect.Schema.Struct({
+      message: effect.Schema.String,
+      count: effect.Schema.Number,
+      purged_projects: effect.Schema.Number
+    });
+    return request("POST", "/v1/automation/reaper").pipe(
+      effect.Effect.flatMap(effect.Schema.decodeUnknown(reaperSchema)),
+      effect.Effect.provideService(PayArkConfigService, this.config)
+    );
+  }
+};
 
 // src/index.ts
 var makeClient = (options) => platform.HttpApiClient.make(PayArkApi, options);
@@ -593,6 +1109,12 @@ var PayArkEffect = class {
   _checkout;
   _payments;
   _projects;
+  _customers;
+  _subscriptions;
+  _mandates;
+  _tokens;
+  _realtime;
+  _automation;
   /**
    * Checkout sessions resource (Effect).
    */
@@ -620,6 +1142,60 @@ var PayArkEffect = class {
     }
     return this._projects;
   }
+  /**
+   * Customers resource (Effect).
+   */
+  get customers() {
+    if (!this._customers) {
+      this._customers = new CustomersEffect(this.config);
+    }
+    return this._customers;
+  }
+  /**
+   * Subscriptions resource (Effect).
+   */
+  get subscriptions() {
+    if (!this._subscriptions) {
+      this._subscriptions = new SubscriptionsEffect(this.config);
+    }
+    return this._subscriptions;
+  }
+  /**
+   * Mandates resource (Effect).
+   */
+  get mandates() {
+    if (!this._mandates) {
+      this._mandates = new MandatesEffect(this.config);
+    }
+    return this._mandates;
+  }
+  /**
+   * Tokens resource (Effect).
+   */
+  get tokens() {
+    if (!this._tokens) {
+      this._tokens = new TokensEffect(this.config);
+    }
+    return this._tokens;
+  }
+  /**
+   * Realtime resource (Effect).
+   */
+  get realtime() {
+    if (!this._realtime) {
+      this._realtime = new RealtimeEffect(this.config);
+    }
+    return this._realtime;
+  }
+  /**
+   * Automation resource (Effect).
+   */
+  get automation() {
+    if (!this._automation) {
+      this._automation = new AutomationEffect(this.config);
+    }
+    return this._automation;
+  }
 };
 var PayArk = class _PayArk extends effect.Context.Tag("@payark/sdk-effect/PayArk")() {
   /**
@@ -628,7 +1204,11 @@ var PayArk = class _PayArk extends effect.Context.Tag("@payark/sdk-effect/PayArk
   static Live = (config) => effect.Layer.succeed(_PayArk, new PayArkEffect(config));
 };
 
+exports.AgentSession = AgentSession;
+exports.AgentSessionId = AgentSessionId;
+exports.AuthCallbackQueryParams = AuthCallbackQueryParams;
 exports.AuthContext = AuthContext;
+exports.AuthGroup = AuthGroup;
 exports.AuthenticationError = AuthenticationError;
 exports.AutomationGroup = AutomationGroup;
 exports.CallbackQueryParams = CallbackQueryParams;
@@ -643,7 +1223,9 @@ exports.CreateSubscriptionParams = CreateSubscriptionParams;
 exports.CronSecurity = CronSecurity;
 exports.Customer = Customer;
 exports.CustomerId = CustomerId;
+exports.CustomerLifecycle = CustomerLifecycle;
 exports.CustomersGroup = CustomersGroup;
+exports.DiscoveryGroup = DiscoveryGroup;
 exports.Email = Email;
 exports.Id = Id;
 exports.IndustrialError = IndustrialError;
@@ -651,6 +1233,13 @@ exports.InternalServerError = InternalServerError;
 exports.ListCustomersParams = ListCustomersParams;
 exports.ListPaymentsParams = ListPaymentsParams;
 exports.ListSubscriptionsParams = ListSubscriptionsParams;
+exports.Mandate = Mandate;
+exports.MandateExpiredError = MandateExpiredError2;
+exports.MandateId = MandateId;
+exports.MandateStatus = MandateStatus;
+exports.MandateType = MandateType;
+exports.MandateViolationError = MandateViolationError2;
+exports.MandatesGroup = MandatesGroup;
 exports.Metadata = Metadata;
 exports.NotFoundError = NotFoundError;
 exports.PaginatedResponse = PaginatedResponse;
@@ -663,6 +1252,7 @@ exports.PayArkEffect = PayArkEffect;
 exports.PayArkEffectError = PayArkEffectError;
 exports.PayArkErrorBody = PayArkErrorBody;
 exports.Payment = Payment;
+exports.PaymentCallbackQueryParams = PaymentCallbackQueryParams;
 exports.PaymentId = PaymentId;
 exports.PaymentStatus = PaymentStatus;
 exports.PaymentsGroup = PaymentsGroup;
@@ -672,7 +1262,9 @@ exports.ProjectsGroup = ProjectsGroup;
 exports.Provider = Provider;
 exports.RealtimeGroup = RealtimeGroup;
 exports.RealtimeTriggerPayload = RealtimeTriggerPayload;
+exports.SandboxGroup = SandboxGroup;
 exports.SecurityMiddleware = SecurityMiddleware;
+exports.SigningKeysGroup = SigningKeysGroup;
 exports.Subscription = Subscription;
 exports.SubscriptionId = SubscriptionId;
 exports.SubscriptionInterval = SubscriptionInterval;