@caronte-sdk/node 0.2.0 → 0.2.1

package/dist/adapters/nest/index.d.ts

@@ -1,49 +1,49 @@
 import { CanActivate, ExecutionContext, DynamicModule } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
-import { A as ArgosClient, a as ArgosClientOptions } from '../../client-Cgm1csuM.js';
+import { C as CaronteClient, a as CaronteClientOptions } from '../../client-TcOSwgrn.js';
 
-declare const OPERATION_KEY = "argos:operation";
+declare const OPERATION_KEY = "caronte:operation";
 interface OperationMeta {
     id: string;
     level: string;
     method: string;
 }
 /**
- * Marks a controller method as a argos operation.
+ * Marks a controller method as a caronte operation.
  *
  * @example
  * ```ts
  * @Get()
  * @Operation('tasks:list', 'private')
- * listTasks(@ArgosUser() user: TokenClaims) { ... }
+ * listTasks(@CaronteUser() user: TokenClaims) { ... }
  * ```
  */
 declare function Operation(id: string, level: string, method?: string): MethodDecorator;
 /** Injects the authenticated user's TokenClaims into a parameter. */
-declare const ArgosUser: (...dataOrPipes: unknown[]) => ParameterDecorator;
+declare const CaronteUser: (...dataOrPipes: unknown[]) => ParameterDecorator;
 
-declare class ArgosGuard implements CanActivate {
+declare class CaronteGuard implements CanActivate {
     private readonly client;
     private readonly reflector;
-    constructor(client: ArgosClient, reflector: Reflector);
+    constructor(client: CaronteClient, reflector: Reflector);
     canActivate(ctx: ExecutionContext): Promise<boolean>;
 }
 
-interface ArgosModuleOptions extends ArgosClientOptions {
+interface CaronteModuleOptions extends CaronteClientOptions {
 }
-declare class ArgosModule {
+declare class CaronteModule {
     /**
-     * Register the argos module globally.
+     * Register the caronte module globally.
      *
-     * Creates the `ArgosClient`, bootstraps it (authenticate + sync + fetch),
-     * and provides `ArgosGuard` for injection.
+     * Creates the `CaronteClient`, bootstraps it (authenticate + sync + fetch),
+     * and provides `CaronteGuard` for injection.
      *
      * @example
      * ```ts
      * // app.module.ts
      * @Module({
      *   imports: [
-     *     ArgosModule.forRootAsync({
+     *     CaronteModule.forRootAsync({
      *       authorizerUrl: process.env.AUTHORIZER_URL!,
      *       realmId:       process.env.REALM_ID!,
      *       appId:         process.env.APP_ID!,
@@ -54,7 +54,7 @@ declare class ArgosModule {
      * export class AppModule {}
      * ```
      */
-    static forRootAsync(options: ArgosModuleOptions): DynamicModule;
+    static forRootAsync(options: CaronteModuleOptions): DynamicModule;
 }
 
-export { ArgosGuard, ArgosModule, type ArgosModuleOptions, ArgosUser, OPERATION_KEY, Operation, type OperationMeta };
+export { CaronteGuard, CaronteModule, type CaronteModuleOptions, CaronteUser, OPERATION_KEY, Operation, type OperationMeta };

package/dist/adapters/nest/index.js

@@ -1,24 +1,24 @@
-import { ArgosClient } from '../../chunk-G73YTEJQ.js';
-import '../../chunk-AKUM2UEO.js';
+import { CaronteClient } from '../../chunk-XMA2NAR7.js';
+import '../../chunk-VEDVQOBD.js';
 import { __decorateClass, __decorateParam, getRegistry, detectMethod, registerOperation } from '../../chunk-HV6X5RJY.js';
 import { createParamDecorator, Injectable, Inject, Module, UnauthorizedException, ForbiddenException, SetMetadata } from '@nestjs/common';
 import { Reflector } from '@nestjs/core';
 
-var OPERATION_KEY = "argos:operation";
+var OPERATION_KEY = "caronte:operation";
 function Operation(id, level, method) {
   const resolvedMethod = method ?? detectMethod(id);
   registerOperation({ identifier: id, method: resolvedMethod, level });
   return SetMetadata(OPERATION_KEY, { id, level, method: resolvedMethod });
 }
-var ArgosUser = createParamDecorator(
-  (_data, ctx) => ctx.switchToHttp().getRequest().argosUser
+var CaronteUser = createParamDecorator(
+  (_data, ctx) => ctx.switchToHttp().getRequest().caronteUser
 );
-var ArgosGuard = class {
+var CaronteGuard = class {
   // @Inject() explícito -- não depender de emitDecoratorMetadata (design:paramtypes)
   // pra resolver os parâmetros: o build desta lib usa tsup/esbuild, que não emite
   // essa metadata (limitação conhecida do esbuild), então a injeção implícita por
   // tipo do Nest falha silenciosamente (reflector fica undefined em runtime,
-  // TypeError em qualquer rota guardada por ArgosGuard).
+  // TypeError em qualquer rota guardada por CaronteGuard).
   constructor(client, reflector) {
     this.client = client;
     this.reflector = reflector;
@@ -45,30 +45,30 @@ var ArgosGuard = class {
     } catch {
       throw new UnauthorizedException("Invalid token.");
     }
-    request.argosUser = claims;
+    request.caronteUser = claims;
     const allowed = this.client.checkPermission(claims, id, method);
     if (!allowed) throw new ForbiddenException("Insufficient permissions.");
     return true;
   }
 };
-ArgosGuard = __decorateClass([
+CaronteGuard = __decorateClass([
   Injectable(),
-  __decorateParam(0, Inject(ArgosClient)),
+  __decorateParam(0, Inject(CaronteClient)),
   __decorateParam(1, Inject(Reflector))
-], ArgosGuard);
-var ArgosModule = class {
+], CaronteGuard);
+var CaronteModule = class {
   /**
-   * Register the argos module globally.
+   * Register the caronte module globally.
    *
-   * Creates the `ArgosClient`, bootstraps it (authenticate + sync + fetch),
-   * and provides `ArgosGuard` for injection.
+   * Creates the `CaronteClient`, bootstraps it (authenticate + sync + fetch),
+   * and provides `CaronteGuard` for injection.
    *
    * @example
    * ```ts
    * // app.module.ts
    * @Module({
    *   imports: [
-   *     ArgosModule.forRootAsync({
+   *     CaronteModule.forRootAsync({
    *       authorizerUrl: process.env.AUTHORIZER_URL!,
    *       realmId:       process.env.REALM_ID!,
    *       appId:         process.env.APP_ID!,
@@ -81,29 +81,29 @@ var ArgosModule = class {
    */
   static forRootAsync(options) {
     return {
-      module: ArgosModule,
+      module: CaronteModule,
       global: true,
       providers: [
         Reflector,
         {
-          provide: ArgosClient,
+          provide: CaronteClient,
           useFactory: async () => {
-            const client = new ArgosClient(options);
+            const client = new CaronteClient(options);
             for (const op of getRegistry()) client.registerOperation(op);
             await client.startup();
             return client;
           }
         },
-        ArgosGuard
+        CaronteGuard
       ],
-      exports: [ArgosClient, ArgosGuard]
+      exports: [CaronteClient, CaronteGuard]
     };
   }
 };
-ArgosModule = __decorateClass([
+CaronteModule = __decorateClass([
   Module({})
-], ArgosModule);
+], CaronteModule);
 
-export { ArgosGuard, ArgosModule, ArgosUser, OPERATION_KEY, Operation };
+export { CaronteGuard, CaronteModule, CaronteUser, OPERATION_KEY, Operation };
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/adapters/nest/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/adapters/nest/decorator.ts","../../../src/adapters/nest/guard.ts","../../../src/adapters/nest/module.ts"],"names":["Reflector"],"mappings":"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","file":"index.js","sourcesContent":["import { createParamDecorator, ExecutionContext, SetMetadata } from '@nestjs/common';\nimport type { TokenClaims } from '../../models.js';\nimport { detectMethod, registerOperation } from '../../registry.js';\n\nexport const OPERATION_KEY = 'argos:operation';\n\nexport interface OperationMeta {\n  id: string;\n  level: string;\n  method: string;\n}\n\n/**\n * Marks a controller method as a argos operation.\n *\n * @example\n * ```ts\n * @Get()\n * @Operation('tasks:list', 'private')\n * listTasks(@ArgosUser() user: TokenClaims) { ... }\n * ```\n */\nexport function Operation(id: string, level: string, method?: string): MethodDecorator {\n  const resolvedMethod = method ?? detectMethod(id);\n  registerOperation({ identifier: id, method: resolvedMethod, level });\n  return SetMetadata<string, OperationMeta>(OPERATION_KEY, { id, level, method: resolvedMethod });\n}\n\n/** Injects the authenticated user's TokenClaims into a parameter. */\nexport const ArgosUser = createParamDecorator(\n  (_data: unknown, ctx: ExecutionContext): TokenClaims | undefined =>\n    ctx.switchToHttp().getRequest().argosUser,\n);","import {\n  CanActivate, ExecutionContext, ForbiddenException,\n  Inject, Injectable, UnauthorizedException,\n} from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\nimport { ArgosClient } from '../../client.js';\nimport type { TokenClaims } from '../../models.js';\nimport { OPERATION_KEY, type OperationMeta } from './decorator.js';\n\n@Injectable()\nexport class ArgosGuard implements CanActivate {\n  // @Inject() explícito -- não depender de emitDecoratorMetadata (design:paramtypes)\n  // pra resolver os parâmetros: o build desta lib usa tsup/esbuild, que não emite\n  // essa metadata (limitação conhecida do esbuild), então a injeção implícita por\n  // tipo do Nest falha silenciosamente (reflector fica undefined em runtime,\n  // TypeError em qualquer rota guardada por ArgosGuard).\n  constructor(\n    @Inject(ArgosClient) private readonly client: ArgosClient,\n    @Inject(Reflector) private readonly reflector: Reflector,\n  ) {}\n\n  async canActivate(ctx: ExecutionContext): Promise<boolean> {\n    const meta = this.reflector.get<OperationMeta | undefined>(\n      OPERATION_KEY,\n      ctx.getHandler(),\n    );\n\n    if (!meta) return true; // no @Operation — pass through\n\n    const { id, level, method } = meta;\n    const request = ctx.switchToHttp().getRequest<{ headers: Record<string, string>; argosUser?: TokenClaims }>();\n\n    if (level === 'public') return true;\n\n    const auth = request.headers['authorization'] ?? '';\n    const [scheme, token] = auth.split(' ');\n\n    if (scheme?.toLowerCase() !== 'bearer' || !token) {\n      throw new UnauthorizedException('Bearer token required.');\n    }\n\n    let claims: TokenClaims;\n    try {\n      claims = await this.client.validateToken(token);\n    } catch {\n      // Token malformado/expirado/inválido -- 401, igual aos adapters express/\n      // fastify (que engolem o erro de validateToken pelo mesmo motivo), não\n      // deixar virar 500 por exceção não tratada.\n      throw new UnauthorizedException('Invalid token.');\n    }\n    request.argosUser = claims;\n\n    const allowed = this.client.checkPermission(claims, id, method);\n    if (!allowed) throw new ForbiddenException('Insufficient permissions.');\n\n    return true;\n  }\n}","import { DynamicModule, Module } from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\nimport { ArgosClient, type ArgosClientOptions } from '../../client.js';\nimport { getRegistry } from '../../registry.js';\nimport { ArgosGuard } from './guard.js';\n\nexport interface ArgosModuleOptions extends ArgosClientOptions {}\n\n@Module({})\nexport class ArgosModule {\n  /**\n   * Register the argos module globally.\n   *\n   * Creates the `ArgosClient`, bootstraps it (authenticate + sync + fetch),\n   * and provides `ArgosGuard` for injection.\n   *\n   * @example\n   * ```ts\n   * // app.module.ts\n   * @Module({\n   *   imports: [\n   *     ArgosModule.forRootAsync({\n   *       authorizerUrl: process.env.AUTHORIZER_URL!,\n   *       realmId:       process.env.REALM_ID!,\n   *       appId:         process.env.APP_ID!,\n   *       secret:        process.env.APP_SECRET!,\n   *     }),\n   *   ],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRootAsync(options: ArgosModuleOptions): DynamicModule {\n    return {\n      module: ArgosModule,\n      global: true,\n      providers: [\n        Reflector,\n        {\n          provide: ArgosClient,\n          useFactory: async () => {\n            const client = new ArgosClient(options);\n            for (const op of getRegistry()) client.registerOperation(op);\n            await client.startup();\n            return client;\n          },\n        },\n        ArgosGuard,\n      ],\n      exports: [ArgosClient, ArgosGuard],\n    };\n  }\n}"]}
+{"version":3,"sources":["../../../src/adapters/nest/decorator.ts","../../../src/adapters/nest/guard.ts","../../../src/adapters/nest/module.ts"],"names":["Reflector"],"mappings":"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","file":"index.js","sourcesContent":["import { createParamDecorator, ExecutionContext, SetMetadata } from '@nestjs/common';\nimport type { TokenClaims } from '../../models.js';\nimport { detectMethod, registerOperation } from '../../registry.js';\n\nexport const OPERATION_KEY = 'caronte:operation';\n\nexport interface OperationMeta {\n  id: string;\n  level: string;\n  method: string;\n}\n\n/**\n * Marks a controller method as a caronte operation.\n *\n * @example\n * ```ts\n * @Get()\n * @Operation('tasks:list', 'private')\n * listTasks(@CaronteUser() user: TokenClaims) { ... }\n * ```\n */\nexport function Operation(id: string, level: string, method?: string): MethodDecorator {\n  const resolvedMethod = method ?? detectMethod(id);\n  registerOperation({ identifier: id, method: resolvedMethod, level });\n  return SetMetadata<string, OperationMeta>(OPERATION_KEY, { id, level, method: resolvedMethod });\n}\n\n/** Injects the authenticated user's TokenClaims into a parameter. */\nexport const CaronteUser = createParamDecorator(\n  (_data: unknown, ctx: ExecutionContext): TokenClaims | undefined =>\n    ctx.switchToHttp().getRequest().caronteUser,\n);","import {\n  CanActivate, ExecutionContext, ForbiddenException,\n  Inject, Injectable, UnauthorizedException,\n} from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\nimport { CaronteClient } from '../../client.js';\nimport type { TokenClaims } from '../../models.js';\nimport { OPERATION_KEY, type OperationMeta } from './decorator.js';\n\n@Injectable()\nexport class CaronteGuard implements CanActivate {\n  // @Inject() explícito -- não depender de emitDecoratorMetadata (design:paramtypes)\n  // pra resolver os parâmetros: o build desta lib usa tsup/esbuild, que não emite\n  // essa metadata (limitação conhecida do esbuild), então a injeção implícita por\n  // tipo do Nest falha silenciosamente (reflector fica undefined em runtime,\n  // TypeError em qualquer rota guardada por CaronteGuard).\n  constructor(\n    @Inject(CaronteClient) private readonly client: CaronteClient,\n    @Inject(Reflector) private readonly reflector: Reflector,\n  ) {}\n\n  async canActivate(ctx: ExecutionContext): Promise<boolean> {\n    const meta = this.reflector.get<OperationMeta | undefined>(\n      OPERATION_KEY,\n      ctx.getHandler(),\n    );\n\n    if (!meta) return true; // no @Operation — pass through\n\n    const { id, level, method } = meta;\n    const request = ctx.switchToHttp().getRequest<{ headers: Record<string, string>; caronteUser?: TokenClaims }>();\n\n    if (level === 'public') return true;\n\n    const auth = request.headers['authorization'] ?? '';\n    const [scheme, token] = auth.split(' ');\n\n    if (scheme?.toLowerCase() !== 'bearer' || !token) {\n      throw new UnauthorizedException('Bearer token required.');\n    }\n\n    let claims: TokenClaims;\n    try {\n      claims = await this.client.validateToken(token);\n    } catch {\n      // Token malformado/expirado/inválido -- 401, igual aos adapters express/\n      // fastify (que engolem o erro de validateToken pelo mesmo motivo), não\n      // deixar virar 500 por exceção não tratada.\n      throw new UnauthorizedException('Invalid token.');\n    }\n    request.caronteUser = claims;\n\n    const allowed = this.client.checkPermission(claims, id, method);\n    if (!allowed) throw new ForbiddenException('Insufficient permissions.');\n\n    return true;\n  }\n}","import { DynamicModule, Module } from '@nestjs/common';\nimport { Reflector } from '@nestjs/core';\nimport { CaronteClient, type CaronteClientOptions } from '../../client.js';\nimport { getRegistry } from '../../registry.js';\nimport { CaronteGuard } from './guard.js';\n\nexport interface CaronteModuleOptions extends CaronteClientOptions {}\n\n@Module({})\nexport class CaronteModule {\n  /**\n   * Register the caronte module globally.\n   *\n   * Creates the `CaronteClient`, bootstraps it (authenticate + sync + fetch),\n   * and provides `CaronteGuard` for injection.\n   *\n   * @example\n   * ```ts\n   * // app.module.ts\n   * @Module({\n   *   imports: [\n   *     CaronteModule.forRootAsync({\n   *       authorizerUrl: process.env.AUTHORIZER_URL!,\n   *       realmId:       process.env.REALM_ID!,\n   *       appId:         process.env.APP_ID!,\n   *       secret:        process.env.APP_SECRET!,\n   *     }),\n   *   ],\n   * })\n   * export class AppModule {}\n   * ```\n   */\n  static forRootAsync(options: CaronteModuleOptions): DynamicModule {\n    return {\n      module: CaronteModule,\n      global: true,\n      providers: [\n        Reflector,\n        {\n          provide: CaronteClient,\n          useFactory: async () => {\n            const client = new CaronteClient(options);\n            for (const op of getRegistry()) client.registerOperation(op);\n            await client.startup();\n            return client;\n          },\n        },\n        CaronteGuard,\n      ],\n      exports: [CaronteClient, CaronteGuard],\n    };\n  }\n}"]}

package/dist/chunk-VEDVQOBD.js

@@ -0,0 +1,21 @@
+// src/exceptions.ts
+var CaronteError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = this.constructor.name;
+  }
+};
+var CaronteAuthError = class extends CaronteError {
+};
+var CaronteTokenError = class extends CaronteError {
+};
+var CaronteForbiddenError = class extends CaronteError {
+};
+var CaronteSyncError = class extends CaronteError {
+};
+var CaronteConfigError = class extends CaronteError {
+};
+
+export { CaronteAuthError, CaronteConfigError, CaronteError, CaronteForbiddenError, CaronteSyncError, CaronteTokenError };
+//# sourceMappingURL=chunk-VEDVQOBD.js.map
+//# sourceMappingURL=chunk-VEDVQOBD.js.map

package/dist/chunk-VEDVQOBD.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/exceptions.ts"],"names":[],"mappings":";AAAO,IAAM,YAAA,GAAN,cAA2B,KAAA,CAAM;AAAA,EACtC,YAAY,OAAA,EAAiB;AAC3B,IAAA,KAAA,CAAM,OAAO,CAAA;AACb,IAAA,IAAA,CAAK,IAAA,GAAO,KAAK,WAAA,CAAY,IAAA;AAAA,EAC/B;AACF;AAEO,IAAM,gBAAA,GAAN,cAAkC,YAAA,CAAa;AAAC;AAChD,IAAM,iBAAA,GAAN,cAAkC,YAAA,CAAa;AAAC;AAChD,IAAM,qBAAA,GAAN,cAAoC,YAAA,CAAa;AAAC;AAClD,IAAM,gBAAA,GAAN,cAAkC,YAAA,CAAa;AAAC;AAChD,IAAM,kBAAA,GAAN,cAAkC,YAAA,CAAa;AAAC","file":"chunk-VEDVQOBD.js","sourcesContent":["export class CaronteError extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = this.constructor.name;\n  }\n}\n\nexport class CaronteAuthError    extends CaronteError {}\nexport class CaronteTokenError   extends CaronteError {}\nexport class CaronteForbiddenError extends CaronteError {}\nexport class CaronteSyncError    extends CaronteError {}\nexport class CaronteConfigError  extends CaronteError {}"]}

package/dist/{chunk-G73YTEJQ.js → chunk-XMA2NAR7.js}

@@ -1,8 +1,8 @@
-import { ArgosConfigError, ArgosAuthError, ArgosSyncError, ArgosError, ArgosTokenError } from './chunk-AKUM2UEO.js';
+import { CaronteConfigError, CaronteAuthError, CaronteSyncError, CaronteError, CaronteTokenError } from './chunk-VEDVQOBD.js';
 import { getRegistry } from './chunk-HV6X5RJY.js';
 import { createRemoteJWKSet, jwtVerify } from 'jose';
 
-var ArgosClient = class _ArgosClient {
+var CaronteClient = class _CaronteClient {
   base;
   realmId;
   appId;
@@ -25,7 +25,7 @@ var ArgosClient = class _ArgosClient {
   }
   async startup() {
     if (this.registeredOperations.length === 0) {
-      throw new ArgosConfigError(
+      throw new CaronteConfigError(
         "No operations registered. Call registerOperation() before startup()."
       );
     }
@@ -41,12 +41,12 @@ var ArgosClient = class _ArgosClient {
       body: JSON.stringify({ app_id: this.appId, secret: this.secret })
     });
     if (!res.ok) {
-      throw new ArgosAuthError(
+      throw new CaronteAuthError(
         `Authentication failed: HTTP ${res.status} \u2014 ${await res.text()}`
       );
     }
     const data = await res.json();
-    if (!data.access_token) throw new ArgosAuthError("Authorizer returned no access_token.");
+    if (!data.access_token) throw new CaronteAuthError("Authorizer returned no access_token.");
     this.appToken = data.access_token;
   }
   initJwks() {
@@ -72,7 +72,7 @@ var ArgosClient = class _ArgosClient {
       })
     });
     if (!res.ok) {
-      throw new ArgosSyncError(`Sync failed: HTTP ${res.status} \u2014 ${await res.text()}`);
+      throw new CaronteSyncError(`Sync failed: HTTP ${res.status} \u2014 ${await res.text()}`);
     }
   }
   async fetchOperations() {
@@ -81,7 +81,7 @@ var ArgosClient = class _ArgosClient {
       headers: { Authorization: `Bearer ${this.appToken}` }
     });
     if (!res.ok) {
-      throw new ArgosError(
+      throw new CaronteError(
         `Fetch operations failed: HTTP ${res.status} \u2014 ${await res.text()}`
       );
     }
@@ -101,7 +101,7 @@ var ArgosClient = class _ArgosClient {
       const p = payload;
       const tokenRealm = p["realm_id"] ?? "";
       if (tokenRealm.toLowerCase() !== this.realmId.toLowerCase()) {
-        throw new ArgosTokenError(
+        throw new CaronteTokenError(
           `Token realm '${tokenRealm}' does not match this app's realm '${this.realmId}'.`
         );
       }
@@ -113,8 +113,8 @@ var ArgosClient = class _ArgosClient {
         raw: p
       };
     } catch (err) {
-      if (err instanceof ArgosTokenError) throw err;
-      throw new ArgosTokenError(`Invalid token: ${err.message}`);
+      if (err instanceof CaronteTokenError) throw err;
+      throw new CaronteTokenError(`Invalid token: ${err.message}`);
     }
   }
   checkPermission(claims, identifier, method) {
@@ -129,18 +129,18 @@ var ArgosClient = class _ArgosClient {
   }
   /** Load operations from the global registry and bootstrap the client. */
   static async create(options) {
-    const client = new _ArgosClient(options);
+    const client = new _CaronteClient(options);
     for (const op of getRegistry()) client.registerOperation(op);
     await client.startup();
     return client;
   }
   ensureAppToken() {
     if (!this.appToken) {
-      throw new ArgosAuthError("No app token. Call authenticate() or startup() first.");
+      throw new CaronteAuthError("No app token. Call authenticate() or startup() first.");
     }
   }
 };
 
-export { ArgosClient };
-//# sourceMappingURL=chunk-G73YTEJQ.js.map
-//# sourceMappingURL=chunk-G73YTEJQ.js.map
+export { CaronteClient };
+//# sourceMappingURL=chunk-XMA2NAR7.js.map
+//# sourceMappingURL=chunk-XMA2NAR7.js.map

package/dist/chunk-XMA2NAR7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"names":[],"mappings":"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","file":"chunk-XMA2NAR7.js","sourcesContent":["import { createRemoteJWKSet, jwtVerify, type JWTPayload } from 'jose';\nimport {\n  CaronteAuthError, CaronteConfigError, CaronteError,\n  CaronteSyncError, CaronteTokenError,\n} from './exceptions.js';\nimport type { OperationDescriptor, OperationWithGroups, TokenClaims } from './models.js';\nimport { getRegistry } from './registry.js';\n\nexport interface CaronteClientOptions {\n  authorizerUrl: string;\n  realmId: string;\n  appId: string;\n  secret: string;\n}\n\nexport class CaronteClient {\n  private readonly base: string;\n  private readonly realmId: string;\n  private readonly appId: string;\n  private readonly secret: string;\n\n  private appToken: string | null = null;\n  private jwks: ReturnType<typeof createRemoteJWKSet> | null = null;\n  private operations: OperationWithGroups[] = [];\n  private registeredOperations: OperationDescriptor[] = [];\n\n  constructor(options: CaronteClientOptions) {\n    this.base     = options.authorizerUrl.replace(/\\/$/, '');\n    this.realmId  = options.realmId;\n    this.appId    = options.appId;\n    this.secret   = options.secret;\n  }\n\n  private get realmBase(): string {\n    return `${this.base}/realms/${this.realmId}`;\n  }\n\n  registerOperation(op: OperationDescriptor): void {\n    this.registeredOperations.push(op);\n  }\n\n  async startup(): Promise<void> {\n    if (this.registeredOperations.length === 0) {\n      throw new CaronteConfigError(\n        'No operations registered. Call registerOperation() before startup().',\n      );\n    }\n    await this.authenticate();\n    this.initJwks();\n    await this.syncOperations();\n    await this.fetchOperations();\n  }\n\n  async authenticate(): Promise<void> {\n    const res = await fetch(`${this.realmBase}/apps/token`, {\n      method: 'POST',\n      headers: { 'Content-Type': 'application/json' },\n      body: JSON.stringify({ app_id: this.appId, secret: this.secret }),\n    });\n    if (!res.ok) {\n      throw new CaronteAuthError(\n        `Authentication failed: HTTP ${res.status} — ${await res.text()}`,\n      );\n    }\n    const data = await res.json() as { access_token?: string };\n    if (!data.access_token) throw new CaronteAuthError('Authorizer returned no access_token.');\n    this.appToken = data.access_token;\n  }\n\n  private initJwks(): void {\n    this.jwks = createRemoteJWKSet(\n      new URL(`${this.realmBase}/protocol/openid-connect/certs`),\n    );\n  }\n\n  async syncOperations(): Promise<void> {\n    this.ensureAppToken();\n    const res = await fetch(`${this.realmBase}/apps/operations/sync`, {\n      method: 'POST',\n      headers: {\n        'Content-Type': 'application/json',\n        Authorization: `Bearer ${this.appToken}`,\n      },\n      body: JSON.stringify({\n        operations: this.registeredOperations.map(op => ({\n          identifier:  op.identifier,\n          method:      op.method,\n          level:       op.level,\n          description: op.description ?? null,\n        })),\n      }),\n    });\n    if (!res.ok) {\n      throw new CaronteSyncError(`Sync failed: HTTP ${res.status} — ${await res.text()}`);\n    }\n  }\n\n  async fetchOperations(): Promise<void> {\n    this.ensureAppToken();\n    const res = await fetch(`${this.realmBase}/apps/operations`, {\n      headers: { Authorization: `Bearer ${this.appToken}` },\n    });\n    if (!res.ok) {\n      throw new CaronteError(\n        `Fetch operations failed: HTTP ${res.status} — ${await res.text()}`,\n      );\n    }\n    const data = await res.json() as { operations: any[] };\n    this.operations = data.operations.map(op => ({\n      operationId:   op.operation_id,\n      identifier:    op.identifier,\n      method:        op.method,\n      level:         op.level,\n      allowedGroups: op.allowed_groups ?? [],\n    }));\n  }\n\n  async validateToken(token: string): Promise<TokenClaims> {\n    if (!this.jwks) this.initJwks();\n    try {\n      const { payload } = await jwtVerify(token, this.jwks!);\n      const p = payload as JWTPayload & Record<string, unknown>;\n      const tokenRealm = (p['realm_id'] as string) ?? '';\n\n      // As chaves JWKS já são buscadas em /realms/{this.realmId}/... (ver\n      // realmBase), então um token de outro realm normalmente já falharia a\n      // verificação de assinatura acima. Esta checagem é defesa em\n      // profundidade explícita — não depende desse efeito colateral, e falha\n      // com uma mensagem clara em vez de erro de assinatura.\n      if (tokenRealm.toLowerCase() !== this.realmId.toLowerCase()) {\n        throw new CaronteTokenError(\n          `Token realm '${tokenRealm}' does not match this app's realm '${this.realmId}'.`,\n        );\n      }\n\n      return {\n        sub:     payload.sub ?? '',\n        realmId: tokenRealm,\n        groups:  (p['groups'] as string[]) ?? [],\n        exp:     payload.exp ?? 0,\n        raw:     p,\n      };\n    } catch (err) {\n      if (err instanceof CaronteTokenError) throw err;\n      throw new CaronteTokenError(`Invalid token: ${(err as Error).message}`);\n    }\n  }\n\n  checkPermission(claims: TokenClaims, identifier: string, method: string): boolean {\n    const op = this.operations.find(\n      o => o.identifier === identifier && o.method === method,\n    );\n    if (!op) return false;\n    if (op.level === 'public')    return true;\n    if (op.level === 'private')   return claims.groups.length > 0;\n    if (op.level === 'protected') return claims.groups.some(g => op.allowedGroups.includes(g));\n    return false;\n  }\n\n  /** Load operations from the global registry and bootstrap the client. */\n  static async create(options: CaronteClientOptions): Promise<CaronteClient> {\n    const client = new CaronteClient(options);\n    for (const op of getRegistry()) client.registerOperation(op);\n    await client.startup();\n    return client;\n  }\n\n  private ensureAppToken(): void {\n    if (!this.appToken) {\n      throw new CaronteAuthError('No app token. Call authenticate() or startup() first.');\n    }\n  }\n}"]}

package/dist/{client-Cgm1csuM.d.cts → client-TcOSwgrn.d.cts}

@@ -16,13 +16,13 @@ interface OperationWithGroups extends OperationDescriptor {
     allowedGroups: string[];
 }
 
-interface ArgosClientOptions {
+interface CaronteClientOptions {
     authorizerUrl: string;
     realmId: string;
     appId: string;
     secret: string;
 }
-declare class ArgosClient {
+declare class CaronteClient {
     private readonly base;
     private readonly realmId;
     private readonly appId;
@@ -31,7 +31,7 @@ declare class ArgosClient {
     private jwks;
     private operations;
     private registeredOperations;
-    constructor(options: ArgosClientOptions);
+    constructor(options: CaronteClientOptions);
     private get realmBase();
     registerOperation(op: OperationDescriptor): void;
     startup(): Promise<void>;
@@ -42,8 +42,8 @@ declare class ArgosClient {
     validateToken(token: string): Promise<TokenClaims>;
     checkPermission(claims: TokenClaims, identifier: string, method: string): boolean;
     /** Load operations from the global registry and bootstrap the client. */
-    static create(options: ArgosClientOptions): Promise<ArgosClient>;
+    static create(options: CaronteClientOptions): Promise<CaronteClient>;
     private ensureAppToken;
 }
 
-export { ArgosClient as A, type OperationDescriptor as O, type TokenClaims as T, type ArgosClientOptions as a, type OperationWithGroups as b };
+export { CaronteClient as C, type OperationDescriptor as O, type TokenClaims as T, type CaronteClientOptions as a, type OperationWithGroups as b };

package/dist/{client-Cgm1csuM.d.ts → client-TcOSwgrn.d.ts}

@@ -16,13 +16,13 @@ interface OperationWithGroups extends OperationDescriptor {
     allowedGroups: string[];
 }
 
-interface ArgosClientOptions {
+interface CaronteClientOptions {
     authorizerUrl: string;
     realmId: string;
     appId: string;
     secret: string;
 }
-declare class ArgosClient {
+declare class CaronteClient {
     private readonly base;
     private readonly realmId;
     private readonly appId;
@@ -31,7 +31,7 @@ declare class ArgosClient {
     private jwks;
     private operations;
     private registeredOperations;
-    constructor(options: ArgosClientOptions);
+    constructor(options: CaronteClientOptions);
     private get realmBase();
     registerOperation(op: OperationDescriptor): void;
     startup(): Promise<void>;
@@ -42,8 +42,8 @@ declare class ArgosClient {
     validateToken(token: string): Promise<TokenClaims>;
     checkPermission(claims: TokenClaims, identifier: string, method: string): boolean;
     /** Load operations from the global registry and bootstrap the client. */
-    static create(options: ArgosClientOptions): Promise<ArgosClient>;
+    static create(options: CaronteClientOptions): Promise<CaronteClient>;
     private ensureAppToken;
 }
 
-export { ArgosClient as A, type OperationDescriptor as O, type TokenClaims as T, type ArgosClientOptions as a, type OperationWithGroups as b };
+export { CaronteClient as C, type OperationDescriptor as O, type TokenClaims as T, type CaronteClientOptions as a, type OperationWithGroups as b };

package/dist/index.cjs

@@ -5,21 +5,21 @@ var jose = require('jose');
 // src/client.ts
 
 // src/exceptions.ts
-var ArgosError = class extends Error {
+var CaronteError = class extends Error {
   constructor(message) {
     super(message);
     this.name = this.constructor.name;
   }
 };
-var ArgosAuthError = class extends ArgosError {
+var CaronteAuthError = class extends CaronteError {
 };
-var ArgosTokenError = class extends ArgosError {
+var CaronteTokenError = class extends CaronteError {
 };
-var ArgosForbiddenError = class extends ArgosError {
+var CaronteForbiddenError = class extends CaronteError {
 };
-var ArgosSyncError = class extends ArgosError {
+var CaronteSyncError = class extends CaronteError {
 };
-var ArgosConfigError = class extends ArgosError {
+var CaronteConfigError = class extends CaronteError {
 };
 
 // src/registry.ts
@@ -45,7 +45,7 @@ function clearRegistry() {
 }
 
 // src/client.ts
-var ArgosClient = class _ArgosClient {
+var CaronteClient = class _CaronteClient {
   base;
   realmId;
   appId;
@@ -68,7 +68,7 @@ var ArgosClient = class _ArgosClient {
   }
   async startup() {
     if (this.registeredOperations.length === 0) {
-      throw new ArgosConfigError(
+      throw new CaronteConfigError(
         "No operations registered. Call registerOperation() before startup()."
       );
     }
@@ -84,12 +84,12 @@ var ArgosClient = class _ArgosClient {
       body: JSON.stringify({ app_id: this.appId, secret: this.secret })
     });
     if (!res.ok) {
-      throw new ArgosAuthError(
+      throw new CaronteAuthError(
         `Authentication failed: HTTP ${res.status} \u2014 ${await res.text()}`
       );
     }
     const data = await res.json();
-    if (!data.access_token) throw new ArgosAuthError("Authorizer returned no access_token.");
+    if (!data.access_token) throw new CaronteAuthError("Authorizer returned no access_token.");
     this.appToken = data.access_token;
   }
   initJwks() {
@@ -115,7 +115,7 @@ var ArgosClient = class _ArgosClient {
       })
     });
     if (!res.ok) {
-      throw new ArgosSyncError(`Sync failed: HTTP ${res.status} \u2014 ${await res.text()}`);
+      throw new CaronteSyncError(`Sync failed: HTTP ${res.status} \u2014 ${await res.text()}`);
     }
   }
   async fetchOperations() {
@@ -124,7 +124,7 @@ var ArgosClient = class _ArgosClient {
       headers: { Authorization: `Bearer ${this.appToken}` }
     });
     if (!res.ok) {
-      throw new ArgosError(
+      throw new CaronteError(
         `Fetch operations failed: HTTP ${res.status} \u2014 ${await res.text()}`
       );
     }
@@ -144,7 +144,7 @@ var ArgosClient = class _ArgosClient {
       const p = payload;
       const tokenRealm = p["realm_id"] ?? "";
       if (tokenRealm.toLowerCase() !== this.realmId.toLowerCase()) {
-        throw new ArgosTokenError(
+        throw new CaronteTokenError(
           `Token realm '${tokenRealm}' does not match this app's realm '${this.realmId}'.`
         );
       }
@@ -156,8 +156,8 @@ var ArgosClient = class _ArgosClient {
         raw: p
       };
     } catch (err) {
-      if (err instanceof ArgosTokenError) throw err;
-      throw new ArgosTokenError(`Invalid token: ${err.message}`);
+      if (err instanceof CaronteTokenError) throw err;
+      throw new CaronteTokenError(`Invalid token: ${err.message}`);
     }
   }
   checkPermission(claims, identifier, method) {
@@ -172,25 +172,25 @@ var ArgosClient = class _ArgosClient {
   }
   /** Load operations from the global registry and bootstrap the client. */
   static async create(options) {
-    const client = new _ArgosClient(options);
+    const client = new _CaronteClient(options);
     for (const op of getRegistry()) client.registerOperation(op);
     await client.startup();
     return client;
   }
   ensureAppToken() {
     if (!this.appToken) {
-      throw new ArgosAuthError("No app token. Call authenticate() or startup() first.");
+      throw new CaronteAuthError("No app token. Call authenticate() or startup() first.");
     }
   }
 };
 
-exports.ArgosAuthError = ArgosAuthError;
-exports.ArgosClient = ArgosClient;
-exports.ArgosConfigError = ArgosConfigError;
-exports.ArgosError = ArgosError;
-exports.ArgosForbiddenError = ArgosForbiddenError;
-exports.ArgosSyncError = ArgosSyncError;
-exports.ArgosTokenError = ArgosTokenError;
+exports.CaronteAuthError = CaronteAuthError;
+exports.CaronteClient = CaronteClient;
+exports.CaronteConfigError = CaronteConfigError;
+exports.CaronteError = CaronteError;
+exports.CaronteForbiddenError = CaronteForbiddenError;
+exports.CaronteSyncError = CaronteSyncError;
+exports.CaronteTokenError = CaronteTokenError;
 exports.clearRegistry = clearRegistry;
 exports.detectMethod = detectMethod;
 exports.getRegistry = getRegistry;