@namera-ai/api 0.0.0

package/README.md

@@ -0,0 +1,58 @@
+# @namera-ai/api
+
+The typed HTTP contract for Namera, built with Effect `HttpApi`. Generate OpenAPI
+documentation and derive client types from the same endpoint schemas used by the
+server. This package defines the API; it does not start a server.
+
+For ordinary application integration, use [@namera-ai/sdk](https://www.npmjs.com/package/@namera-ai/sdk).
+
+## Installation
+
+Requires Node.js 24.14+ for Node applications. Use the matching Effect 4 beta.
+
+```sh
+npm install @namera-ai/api effect@4.0.0-beta.105
+pnpm add @namera-ai/api effect@4.0.0-beta.105
+yarn add @namera-ai/api effect@4.0.0-beta.105
+bun add @namera-ai/api effect@4.0.0-beta.105
+```
+
+Choose the command for your package manager.
+
+## Generate OpenAPI documentation
+
+```ts
+import { writeFile } from "node:fs/promises";
+import { OpenApi } from "effect/unstable/httpapi";
+import { NameraApi } from "@namera-ai/api";
+
+const document = OpenApi.fromApi(NameraApi);
+await writeFile("openapi.json", JSON.stringify(document, null, 2));
+```
+
+The contract covers wallets, session keys, executions, signatures, authorization,
+organizations, billing, and the public waitlist. Authentication is defined per
+endpoint; installing this package grants no access.
+
+## Derive client types
+
+```ts
+import type { HttpApiClient } from "effect/unstable/httpapi";
+import { NameraApi } from "@namera-ai/api";
+
+type Client = HttpApiClient.ForApi<typeof NameraApi>;
+type WalletClient = Client["wallet"];
+```
+
+Effect integrations can construct clients with `HttpApiClient.make` and supply
+the required client middleware layers. Most consumers should use the SDK, which
+handles authentication and returns promise-based results.
+
+## Related packages
+
+- [protocol](https://www.npmjs.com/package/@namera-ai/protocol): runtime schemas and types.
+- [sdk](https://www.npmjs.com/package/@namera-ai/sdk): application client.
+- [cli](https://www.npmjs.com/package/@namera-ai/cli): terminal commands and local MCP.
+
+Use matching versions of the four packages starting with 1.0.0.
+[Contributor architecture](https://github.com/thenamespace/namera-core/blob/main/architecture/packages/contracts.md).

package/dist/common.js

@@ -0,0 +1,13 @@
+import { HttpApiError } from "effect/unstable/httpapi";
+import { RateLimitExceeded } from "@namera-ai/protocol";
+
+//#region src/common.ts
+const CommonErrors = [
+	HttpApiError.ForbiddenNoContent,
+	HttpApiError.InternalServerErrorNoContent,
+	RateLimitExceeded
+];
+
+//#endregion
+export { CommonErrors };
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","names":[],"sources":["../src/common.ts"],"sourcesContent":["import { HttpApiError } from \"effect/unstable/httpapi\";\n\nimport { RateLimitExceeded } from \"@namera-ai/protocol\";\n\nexport const CommonErrors = [\n  HttpApiError.ForbiddenNoContent,\n  HttpApiError.InternalServerErrorNoContent,\n  RateLimitExceeded,\n] as const;\n"],"mappings":";;;;AAIA,MAAa,eAAe;CAC1B,aAAa;CACb,aAAa;CACb;AACF"}

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+import { HealthGroup } from "./routes/health.js";
+import { ApiKeySecurity, AuthTokenSecurity, Authorization, BearerSecurity, CurrentActor } from "./middlewares/auth.js";
+import { AdminAuthorization, CurrentAdmin } from "./middlewares/admin.js";
+import "./middlewares/index.js";
+import { AddressMetadataGroup } from "./routes/address-metadata.js";
+import { ExecutionGroup } from "./routes/execution.js";
+import { EnsGroup } from "./routes/ens.js";
+import { ApiKeyGroup } from "./routes/api-key.js";
+import { BillingGroup } from "./routes/billing.js";
+import { DashboardGroup } from "./routes/dashboard.js";
+import { PortfolioGroup } from "./routes/portfolio.js";
+import { WalletGroup } from "./routes/wallet.js";
+import { SessionKeyGroup } from "./routes/session-key.js";
+import { SignatureGroup } from "./routes/signature.js";
+import { MagicLinkGroup } from "./routes/auth/core/magic-link.js";
+import { SessionGroup } from "./routes/auth/core/session.js";
+import { UserGroup } from "./routes/auth/core/user.js";
+import { NotificationGroup } from "./routes/auth/notification.js";
+import { OAuthGroup } from "./routes/auth/oauth.js";
+import { InvitationGroup } from "./routes/auth/organization/invitation.js";
+import { MemberGroup } from "./routes/auth/organization/members.js";
+import { OrganizationGroup } from "./routes/auth/organization/organization.js";
+import { BetaInviteGroup } from "./routes/beta-invite.js";
+import { AdminWaitlistGroup, WaitlistGroup } from "./routes/waitlist.js";
+import "./routes/index.js";
+import { HttpApi } from "effect/unstable/httpapi";
+//#region src/index.d.ts
+declare const NameraApi_base: HttpApi.HttpApi<"NameraAPI", typeof AddressMetadataGroup | typeof ApiKeyGroup | typeof BillingGroup | typeof BetaInviteGroup | typeof WaitlistGroup | typeof AdminWaitlistGroup | typeof DashboardGroup | typeof ExecutionGroup | typeof EnsGroup | typeof HealthGroup | typeof InvitationGroup | typeof MagicLinkGroup | typeof MemberGroup | typeof NotificationGroup | typeof PortfolioGroup | typeof OAuthGroup | typeof OrganizationGroup | typeof SessionKeyGroup | typeof SessionGroup | typeof SignatureGroup | typeof UserGroup | typeof WalletGroup>;
+declare class NameraApi extends NameraApi_base {}
+//#endregion
+export { AdminAuthorization, ApiKeySecurity, AuthTokenSecurity, Authorization, BearerSecurity, CurrentActor, CurrentAdmin, NameraApi };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","names":[],"sources":["../src/index.ts"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;cAgCa,kBAAkB"}

package/dist/index.js

@@ -0,0 +1,40 @@
+import { HealthGroup } from "./routes/health.js";
+import { ApiKeySecurity, AuthTokenSecurity, Authorization, BearerSecurity, CurrentActor } from "./middlewares/auth.js";
+import { AdminAuthorization, CurrentAdmin } from "./middlewares/admin.js";
+import { AddressMetadataGroup } from "./routes/address-metadata.js";
+import { ExecutionGroup } from "./routes/execution.js";
+import { EnsGroup } from "./routes/ens.js";
+import { ApiKeyGroup } from "./routes/api-key.js";
+import { BillingGroup } from "./routes/billing.js";
+import { DashboardGroup } from "./routes/dashboard.js";
+import { PortfolioGroup } from "./routes/portfolio.js";
+import { WalletGroup } from "./routes/wallet.js";
+import { SessionKeyGroup } from "./routes/session-key.js";
+import { SignatureGroup } from "./routes/signature.js";
+import { MagicLinkGroup } from "./routes/auth/core/magic-link.js";
+import { SessionGroup } from "./routes/auth/core/session.js";
+import { UserGroup } from "./routes/auth/core/user.js";
+import { NotificationGroup } from "./routes/auth/notification.js";
+import { OAuthGroup } from "./routes/auth/oauth.js";
+import { InvitationGroup } from "./routes/auth/organization/invitation.js";
+import { MemberGroup } from "./routes/auth/organization/members.js";
+import { OrganizationGroup } from "./routes/auth/organization/organization.js";
+import { BetaInviteGroup } from "./routes/beta-invite.js";
+import { AdminWaitlistGroup, WaitlistGroup } from "./routes/waitlist.js";
+import { HttpApi, OpenApi } from "effect/unstable/httpapi";
+
+//#region src/index.ts
+var NameraApi = class extends HttpApi.make("NameraAPI").add(AddressMetadataGroup, ApiKeyGroup, BillingGroup, BetaInviteGroup, WaitlistGroup, AdminWaitlistGroup, DashboardGroup, ExecutionGroup, EnsGroup, HealthGroup, InvitationGroup, MagicLinkGroup, MemberGroup, NotificationGroup, PortfolioGroup, OAuthGroup, OrganizationGroup, SessionKeyGroup, SessionGroup, SignatureGroup, UserGroup, WalletGroup).annotate(OpenApi.Title, "Namera API").annotate(OpenApi.Description, "Backend API for Namera built using Effect and Drizzle").annotate(OpenApi.Summary, "Namera is a programmable wallet infrastructure that lets agents execute onchain transactions within rules you define. Instead of giving full wallet access, you define permissions upfront and let agents operate within those boundaries.").annotate(OpenApi.Servers, [{
+	url: "https://api.namera.ai",
+	description: "Production server"
+}, {
+	url: "http://localhost:8080",
+	description: "Local development server"
+}]).annotate(OpenApi.License, {
+	name: "Apache-2.0",
+	url: "https://opensource.org/licenses/Apache-2.0"
+}) {};
+
+//#endregion
+export { AdminAuthorization, ApiKeySecurity, AuthTokenSecurity, Authorization, BearerSecurity, CurrentActor, CurrentAdmin, NameraApi };
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { HttpApi, OpenApi } from \"effect/unstable/httpapi\";\n\nimport {\n  AddressMetadataGroup,\n  ApiKeyGroup,\n  BillingGroup,\n  BetaInviteGroup,\n  WaitlistGroup,\n  AdminWaitlistGroup,\n  DashboardGroup,\n  ExecutionGroup,\n  EnsGroup,\n  HealthGroup,\n  InvitationGroup,\n  MagicLinkGroup,\n  MemberGroup,\n  NotificationGroup,\n  OAuthGroup,\n  OrganizationGroup,\n  PortfolioGroup,\n  SessionKeyGroup,\n  SessionGroup,\n  SignatureGroup,\n  UserGroup,\n  WalletGroup,\n} from \"./routes/index.js\";\n\nexport * from \"./middlewares/index.js\";\n\n// This class is the transport contract shared by the server, OpenAPI output,\n// dashboard atoms, and public SDK. Handlers and business logic deliberately\n// live outside this package so every client is generated from the same schema.\nexport class NameraApi extends HttpApi.make(\"NameraAPI\")\n  .add(\n    AddressMetadataGroup,\n    ApiKeyGroup,\n    BillingGroup,\n    BetaInviteGroup,\n    WaitlistGroup,\n    AdminWaitlistGroup,\n    DashboardGroup,\n    ExecutionGroup,\n    EnsGroup,\n    HealthGroup,\n    InvitationGroup,\n    MagicLinkGroup,\n    MemberGroup,\n    NotificationGroup,\n    PortfolioGroup,\n    OAuthGroup,\n    OrganizationGroup,\n    SessionKeyGroup,\n    SessionGroup,\n    SignatureGroup,\n    UserGroup,\n    WalletGroup,\n  )\n  .annotate(OpenApi.Title, \"Namera API\")\n  .annotate(OpenApi.Description, \"Backend API for Namera built using Effect and Drizzle\")\n  .annotate(\n    OpenApi.Summary,\n    \"Namera is a programmable wallet infrastructure that lets agents execute onchain transactions within rules you define. Instead of giving full wallet access, you define permissions upfront and let agents operate within those boundaries.\",\n  )\n  .annotate(OpenApi.Servers, [\n    {\n      url: \"https://api.namera.ai\",\n      description: \"Production server\",\n    },\n    {\n      url: \"http://localhost:8080\",\n      description: \"Local development server\",\n    },\n  ])\n  .annotate(OpenApi.License, {\n    name: \"Apache-2.0\",\n    url: \"https://opensource.org/licenses/Apache-2.0\",\n  }) {}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAgCA,IAAa,YAAb,cAA+B,QAAQ,KAAK,WAAW,CAAC,CACrD,IACC,sBACA,aACA,cACA,iBACA,eACA,oBACA,gBACA,gBACA,UACA,aACA,iBACA,gBACA,aACA,mBACA,gBACA,YACA,mBACA,iBACA,cACA,gBACA,WACA,WACF,CAAC,CACA,SAAS,QAAQ,OAAO,YAAY,CAAC,CACrC,SAAS,QAAQ,aAAa,uDAAuD,CAAC,CACtF,SACC,QAAQ,SACR,4OACF,CAAC,CACA,SAAS,QAAQ,SAAS,CACzB;CACE,KAAK;CACL,aAAa;AACf,GACA;CACE,KAAK;CACL,aAAa;AACf,CACF,CAAC,CAAC,CACD,SAAS,QAAQ,SAAS;CACzB,MAAM;CACN,KAAK;AACP,CAAC,CAAC,CAAC,CAAC"}

package/dist/middlewares/admin.d.ts

@@ -0,0 +1,25 @@
+import { HttpApiError, HttpApiMiddleware, HttpApiSecurity } from "effect/unstable/httpapi";
+import { Context } from "effect";
+import { RateLimitExceeded } from "@namera-ai/protocol";
+//#region src/middlewares/admin.d.ts
+declare const CurrentAdmin_base: Context.ServiceClass<CurrentAdmin, "@namera-ai/api/CurrentAdmin", {
+  readonly type: "admin";
+  readonly credential: "shared-token";
+}>;
+declare class CurrentAdmin extends CurrentAdmin_base {}
+declare const AdminAuthorization_base: HttpApiMiddleware.ServiceClass<AdminAuthorization, "@namera-ai/api/AdminAuthorization", {
+  requires: never;
+  provides: CurrentAdmin;
+  error: readonly [import("effect/unstable/httpapi/HttpApiSchema").asNoContent<typeof HttpApiError.Unauthorized>, import("effect/unstable/httpapi/HttpApiSchema").asNoContent<typeof HttpApiError.InternalServerError>, typeof RateLimitExceeded];
+  clientError: never;
+  requiredForClient: false;
+  security: {
+    readonly bearer: HttpApiSecurity.Http;
+  };
+}, HttpApiMiddleware.HttpApiMiddlewareSecurity<{
+  readonly bearer: HttpApiSecurity.Http;
+}, CurrentAdmin, readonly [import("effect/unstable/httpapi/HttpApiSchema").asNoContent<typeof HttpApiError.Unauthorized>, import("effect/unstable/httpapi/HttpApiSchema").asNoContent<typeof HttpApiError.InternalServerError>, typeof RateLimitExceeded], never>>;
+declare class AdminAuthorization extends AdminAuthorization_base {}
+//#endregion
+export { AdminAuthorization, CurrentAdmin };
+//# sourceMappingURL=admin.d.ts.map

package/dist/middlewares/admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.d.ts","names":[],"sources":["../../src/middlewares/admin.ts"],"mappings":";;;;;WAOmB;WAA8B;;cAFpC,qBAAqB;;;;;;;;;;;;;cAKrB,2BAA2B"}

package/dist/middlewares/admin.js

@@ -0,0 +1,18 @@
+import { HttpApiError, HttpApiMiddleware, HttpApiSecurity } from "effect/unstable/httpapi";
+import { Context } from "effect";
+import { RateLimitExceeded } from "@namera-ai/protocol";
+
+//#region src/middlewares/admin.ts
+var CurrentAdmin = class extends Context.Service()("@namera-ai/api/CurrentAdmin") {};
+var AdminAuthorization = class extends HttpApiMiddleware.Service()("@namera-ai/api/AdminAuthorization", {
+	error: [
+		HttpApiError.UnauthorizedNoContent,
+		HttpApiError.InternalServerErrorNoContent,
+		RateLimitExceeded
+	],
+	security: { bearer: HttpApiSecurity.bearer }
+}) {};
+
+//#endregion
+export { AdminAuthorization, CurrentAdmin };
+//# sourceMappingURL=admin.js.map

package/dist/middlewares/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","names":[],"sources":["../../src/middlewares/admin.ts"],"sourcesContent":["import { Context } from \"effect\";\nimport { HttpApiError, HttpApiMiddleware, HttpApiSecurity } from \"effect/unstable/httpapi\";\n\nimport { RateLimitExceeded } from \"@namera-ai/protocol\";\n\nexport class CurrentAdmin extends Context.Service<\n  CurrentAdmin,\n  { readonly type: \"admin\"; readonly credential: \"shared-token\" }\n>()(\"@namera-ai/api/CurrentAdmin\") {}\n\nexport class AdminAuthorization extends HttpApiMiddleware.Service<\n  AdminAuthorization,\n  { provides: CurrentAdmin }\n>()(\"@namera-ai/api/AdminAuthorization\", {\n  error: [\n    HttpApiError.UnauthorizedNoContent,\n    HttpApiError.InternalServerErrorNoContent,\n    RateLimitExceeded,\n  ],\n  security: { bearer: HttpApiSecurity.bearer },\n}) {}\n"],"mappings":";;;;;AAKA,IAAa,eAAb,cAAkC,QAAQ,QAGxC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC;AAEpC,IAAa,qBAAb,cAAwC,kBAAkB,QAGxD,CAAC,CAAC,qCAAqC;CACvC,OAAO;EACL,aAAa;EACb,aAAa;EACb;CACF;CACA,UAAU,EAAE,QAAQ,gBAAgB,OAAO;AAC7C,CAAC,CAAC,CAAC,CAAC"}