@payark/sdk-effect 0.1.5 → 0.1.9

package/dist/api-spec.js

@@ -0,0 +1,651 @@
+'use strict';
+
+var platform = require('@effect/platform');
+var effect = require('effect');
+
+// src/api-spec.ts
+var NonEmptyString = effect.Schema.String.pipe(
+  effect.Schema.nonEmptyString(),
+  effect.Schema.brand("NonEmptyString")
+);
+var UrlString = effect.Schema.String.pipe(
+  effect.Schema.pattern(/^https?:\/\/.+/),
+  effect.Schema.brand("UrlString")
+);
+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"));
+var ProjectId = effect.Schema.String.pipe(effect.Schema.brand("ProjectId"));
+var PaymentId = effect.Schema.String.pipe(effect.Schema.brand("PaymentId"));
+var CheckoutSessionId = effect.Schema.String.pipe(
+  effect.Schema.brand("CheckoutSessionId")
+);
+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(
+  effect.Schema.filter((s) => s.includes("@")),
+  effect.Schema.brand("Email")
+);
+var Timestamp = effect.Schema.String.pipe(effect.Schema.brand("Timestamp"));
+var Metadata = effect.Schema.Record({
+  key: effect.Schema.String,
+  value: effect.Schema.Any
+});
+effect.Schema.Struct({
+  created_at: Timestamp,
+  updated_at: Timestamp
+});
+var Provider = effect.Schema.Literal(
+  "esewa",
+  "khalti",
+  "hamropay",
+  "connectips",
+  "imepay",
+  "fonepay",
+  "sandbox"
+);
+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,
+  email: effect.Schema.NullOr(Email),
+  name: effect.Schema.NullOr(NonEmptyString),
+  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,
+  provider_ref: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.String)),
+  metadata_json: effect.Schema.optional(effect.Schema.NullOr(Metadata)),
+  gateway_response: effect.Schema.optional(effect.Schema.NullOr(effect.Schema.Any)),
+  created_at: Timestamp,
+  updated_at: effect.Schema.optional(Timestamp)
+});
+var Subscription = effect.Schema.Struct({
+  id: SubscriptionId,
+  project_id: ProjectId,
+  customer_id: CustomerId,
+  status: SubscriptionStatus,
+  amount: effect.Schema.Number,
+  currency: effect.Schema.String,
+  interval: SubscriptionInterval,
+  interval_count: effect.Schema.Number,
+  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,
+  updated_at: effect.Schema.optional(Timestamp)
+});
+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({
+  id: TokenId,
+  name: NonEmptyString,
+  scopes: effect.Schema.Array(effect.Schema.String),
+  last_used_at: effect.Schema.NullOr(Timestamp),
+  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
+});
+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,
+  offset: effect.Schema.Number
+});
+var PaginatedResponse = (schema) => effect.Schema.Struct({
+  data: effect.Schema.Array(schema),
+  meta: PaginationMeta
+});
+var WebhookEventType = effect.Schema.Literal(
+  "payment.success",
+  "payment.failed",
+  "subscription.created",
+  "subscription.activated",
+  "subscription.renewed",
+  "subscription.payment_succeeded",
+  "subscription.payment_failed",
+  "subscription.renewal_due",
+  "subscription.canceled"
+);
+effect.Schema.Struct({
+  type: WebhookEventType,
+  id: effect.Schema.optional(effect.Schema.String),
+  data: effect.Schema.Union(
+    Payment,
+    Subscription,
+    Customer,
+    effect.Schema.Struct({
+      id: effect.Schema.String,
+      amount: effect.Schema.optional(effect.Schema.Number),
+      currency: effect.Schema.optional(effect.Schema.String),
+      status: effect.Schema.String,
+      metadata: effect.Schema.optional(Metadata)
+    })
+  ),
+  is_test: effect.Schema.Boolean,
+  created: effect.Schema.optional(effect.Schema.Number)
+});
+var CreateCheckoutParams = effect.Schema.Struct({
+  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),
+  customerId: effect.Schema.optional(CustomerId),
+  mandate_id: effect.Schema.optional(MandateId)
+}).pipe(
+  effect.Schema.filter((data) => {
+    if (!data.subscriptionId && !data.amount) {
+      return "amount is required when subscriptionId is not provided";
+    }
+    return true;
+  })
+);
+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),
+    method: effect.Schema.optional(effect.Schema.Literal("GET", "POST")),
+    fields: effect.Schema.optional(
+      effect.Schema.Record({ key: effect.Schema.String, value: effect.Schema.String })
+    )
+  })
+});
+var CreateCustomerParams = effect.Schema.Struct({
+  merchant_customer_id: NonEmptyString,
+  email: effect.Schema.optional(Email),
+  name: effect.Schema.optional(NonEmptyString),
+  phone: effect.Schema.optional(effect.Schema.String),
+  project_id: effect.Schema.optional(ProjectId),
+  metadata: effect.Schema.optional(Metadata)
+});
+var ListPaymentsParams = effect.Schema.Struct({
+  limit: effect.Schema.optional(effect.Schema.NumberFromString),
+  offset: effect.Schema.optional(effect.Schema.NumberFromString),
+  projectId: effect.Schema.optional(ProjectId)
+});
+var ListCustomersParams = effect.Schema.Struct({
+  limit: effect.Schema.optional(effect.Schema.NumberFromString),
+  offset: effect.Schema.optional(effect.Schema.NumberFromString),
+  email: effect.Schema.optional(effect.Schema.String),
+  merchant_customer_id: effect.Schema.optional(effect.Schema.String),
+  projectId: effect.Schema.optional(ProjectId)
+});
+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: 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)
+});
+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)
+});
+var ListSubscriptionsParams = effect.Schema.Struct({
+  limit: effect.Schema.optional(effect.Schema.NumberFromString),
+  offset: effect.Schema.optional(effect.Schema.NumberFromString),
+  projectId: effect.Schema.optional(ProjectId),
+  customerId: effect.Schema.optional(CustomerId),
+  status: effect.Schema.optional(SubscriptionStatus)
+});
+var RealtimeTriggerPayload = effect.Schema.Struct({
+  event: effect.Schema.optional(WebhookEventType),
+  data: effect.Schema.optional(effect.Schema.Any)
+});
+effect.Schema.Struct({
+  apiKey: effect.Schema.String,
+  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),
+  signingPrivateKey: effect.Schema.optional(effect.Schema.String)
+});
+effect.Schema.Struct({
+  error: effect.Schema.String,
+  details: effect.Schema.optional(effect.Schema.Any)
+});
+var IndustrialError = class extends effect.Schema.TaggedError()(
+  "IndustrialError",
+  {
+    error: effect.Schema.String,
+    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,
+    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,
+    code: effect.Schema.optional(effect.Schema.String),
+    doc_url: effect.Schema.optional(effect.Schema.String),
+    suggestion: effect.Schema.optional(effect.Schema.String)
+  }
+) {
+};
+var InternalServerError = class extends effect.Schema.TaggedError()(
+  "InternalServerError",
+  {
+    error: effect.Schema.String,
+    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,
+    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)
+  }
+) {
+};
+var AuthContext = effect.Context.GenericTag(
+  "@payark/sdk-effect/AuthContext"
+);
+var SecurityMiddleware = class extends platform.HttpApiMiddleware.Tag()(
+  "SecurityMiddleware",
+  {
+    security: {
+      bearer: platform.HttpApiSecurity.bearer
+    },
+    provides: AuthContext,
+    failure: effect.Schema.Union(AuthenticationError, IndustrialError)
+  }
+) {
+};
+var CronSecurity = class extends platform.HttpApiMiddleware.Tag()(
+  "CronSecurity",
+  {
+    security: {
+      secret: platform.HttpApiSecurity.apiKey({ in: "header", key: "x-cron-secret" })
+    },
+    failure: effect.Schema.Union(AuthenticationError, IndustrialError)
+  }
+) {
+};
+var UserSecurity = class extends platform.HttpApiMiddleware.Tag()(
+  "UserSecurity",
+  {
+    security: {
+      bearer: platform.HttpApiSecurity.bearer
+    },
+    provides: AuthContext,
+    failure: effect.Schema.Union(AuthenticationError, IndustrialError)
+  }
+) {
+};
+var CheckoutGroup = platform.HttpApiGroup.make("checkout").add(
+  platform.HttpApiEndpoint.post("create", "/").addSuccess(CheckoutSession).setPayload(CreateCheckoutParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).prefix("/v1/checkout").middleware(SecurityMiddleware);
+var PaymentsGroup = platform.HttpApiGroup.make("payments").add(
+  platform.HttpApiEndpoint.get("list", "/").addSuccess(PaginatedResponse(Payment)).setUrlParams(ListPaymentsParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).add(
+  platform.HttpApiEndpoint.get("retrieve", "/:id").addSuccess(Payment).setPath(effect.Schema.Struct({ id: Id })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).prefix("/v1/payments").middleware(SecurityMiddleware);
+var CustomersGroup = platform.HttpApiGroup.make("customers").add(
+  platform.HttpApiEndpoint.post("create", "/").addSuccess(Customer, { status: 201 }).setPayload(CreateCustomerParams).addError(AuthenticationError, { status: 401 }).addError(ConflictError, { status: 409 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).add(
+  platform.HttpApiEndpoint.get("list", "/").addSuccess(PaginatedResponse(Customer)).setUrlParams(ListCustomersParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).add(
+  platform.HttpApiEndpoint.get("retrieve", "/:id").addSuccess(Customer).setPath(effect.Schema.Struct({ id: Id })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).add(
+  platform.HttpApiEndpoint.patch("update", "/:id").addSuccess(Customer).setPath(effect.Schema.Struct({ id: Id })).setPayload(UpdateCustomerParams).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(ConflictError, { status: 409 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).add(
+  platform.HttpApiEndpoint.del("delete", "/:id").setPath(effect.Schema.Struct({ id: Id })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(ConflictError, { status: 409 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).prefix("/v1/customers").middleware(SecurityMiddleware);
+var SubscriptionsGroup = platform.HttpApiGroup.make("subscriptions").add(
+  platform.HttpApiEndpoint.post("create", "/").addSuccess(Subscription, { status: 201 }).setPayload(CreateSubscriptionParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 }).middleware(SecurityMiddleware)
+).add(
+  platform.HttpApiEndpoint.get("retrieve", "/:id").addSuccess(Subscription).setPath(effect.Schema.Struct({ id: SubscriptionId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).middleware(SecurityMiddleware)
+).add(
+  platform.HttpApiEndpoint.get("list", "/").addSuccess(PaginatedResponse(Subscription)).setUrlParams(ListSubscriptionsParams).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 }).middleware(SecurityMiddleware)
+).add(
+  platform.HttpApiEndpoint.post("cancel", "/:id/cancel").addSuccess(Subscription).setPath(effect.Schema.Struct({ id: SubscriptionId })).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).middleware(SecurityMiddleware)
+).add(
+  platform.HttpApiEndpoint.post("activate", "/:id/activate").addSuccess(
+    effect.Schema.Struct({
+      checkout_url: effect.Schema.String,
+      payment_id: effect.Schema.String
+    })
+  ).setPath(effect.Schema.Struct({ id: SubscriptionId })).setPayload(
+    effect.Schema.Struct({
+      provider: Provider,
+      returnUrl: effect.Schema.String,
+      cancelUrl: effect.Schema.optional(effect.Schema.String)
+    })
+  ).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 }).addError(IndustrialError, { status: 400 })
+).prefix("/v1/subscriptions");
+var AutomationGroup = platform.HttpApiGroup.make("automation").add(
+  platform.HttpApiEndpoint.post("reminders", "/reminders").addSuccess(
+    effect.Schema.Struct({
+      message: effect.Schema.String,
+      count: effect.Schema.Number
+    })
+  ).addError(InternalServerError, { status: 500 })
+).add(
+  platform.HttpApiEndpoint.post("reaper", "/reaper").addSuccess(
+    effect.Schema.Struct({
+      message: effect.Schema.String,
+      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);
+var TokensGroup = platform.HttpApiGroup.make("tokens").add(
+  platform.HttpApiEndpoint.post("create", "/").addSuccess(
+    effect.Schema.Struct({
+      ...Token.fields,
+      token: effect.Schema.String
+    })
+  ).setPayload(
+    effect.Schema.Struct({
+      name: effect.Schema.String,
+      scopes: effect.Schema.optionalWith(effect.Schema.Array(effect.Schema.String), {
+        default: () => []
+      }),
+      expires_in_days: effect.Schema.optional(effect.Schema.Number)
+    })
+  ).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
+).add(
+  platform.HttpApiEndpoint.get("list", "/").addSuccess(effect.Schema.Array(Token)).addError(AuthenticationError, { status: 401 }).addError(InternalServerError, { status: 500 })
+).add(
+  platform.HttpApiEndpoint.del("delete", "/:id").setPath(effect.Schema.Struct({ id: TokenId })).addSuccess(effect.Schema.Null).addError(AuthenticationError, { status: 401 }).addError(NotFoundError, { status: 404 }).addError(InternalServerError, { status: 500 })
+).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 })
+).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(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(
+  platform.HttpApiEndpoint.post("trigger", "/trigger").addSuccess(
+    effect.Schema.Struct({
+      status: effect.Schema.String,
+      event: effect.Schema.optional(effect.Schema.String)
+    })
+  ).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 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 });
+
+exports.AuthCallbackQueryParams = AuthCallbackQueryParams;
+exports.AuthContext = AuthContext;
+exports.AuthGroup = AuthGroup;
+exports.AuthenticationError = AuthenticationError;
+exports.AutomationGroup = AutomationGroup;
+exports.CallbacksGroup = CallbacksGroup;
+exports.CheckoutGroup = CheckoutGroup;
+exports.ConflictError = ConflictError;
+exports.CronSecurity = CronSecurity;
+exports.CustomersGroup = CustomersGroup;
+exports.DiscoveryGroup = DiscoveryGroup;
+exports.IndustrialError = IndustrialError;
+exports.InternalServerError = InternalServerError;
+exports.MandateExpiredError = MandateExpiredError;
+exports.MandateViolationError = MandateViolationError;
+exports.MandatesGroup = MandatesGroup;
+exports.NotFoundError = NotFoundError;
+exports.PayArkApi = PayArkApi;
+exports.PaymentCallbackQueryParams = PaymentCallbackQueryParams;
+exports.PaymentsGroup = PaymentsGroup;
+exports.ProjectsGroup = ProjectsGroup;
+exports.RealtimeGroup = RealtimeGroup;
+exports.SandboxGroup = SandboxGroup;
+exports.SecurityMiddleware = SecurityMiddleware;
+exports.SigningKeysGroup = SigningKeysGroup;
+exports.SubscriptionsGroup = SubscriptionsGroup;
+exports.TokensGroup = TokensGroup;
+exports.UserSecurity = UserSecurity;
+//# sourceMappingURL=api-spec.js.map
+//# sourceMappingURL=api-spec.js.map