@supacloud/app 0.1.0 → 0.4.0

package/README.md

@@ -67,6 +67,12 @@ export class CaseModule {}
 The compiler rejects scope violations (e.g. an `application` provider
 depending on a `request` provider) at build time.
 
+## Built-in Tokens
+
+- `DB_CLIENT` — Platform database / Drizzle client (`application` scope).
+- `REQUEST_CONTEXT` — HTTP request context (`request` scope).
+- `JOB_CONTEXT` — Background job execution context (`job` scope).
+
 ## Non-decorator usage
 
 `defineModule(options)` produces the same metadata as `@Module(options)` and

package/dist/context.d.ts

@@ -12,3 +12,8 @@ export declare const REQUEST_CONTEXT: InjectionToken<unknown>;
  * cancellation signal, ...).
  */
 export declare const JOB_CONTEXT: InjectionToken<unknown>;
+/**
+ * Built-in token for the platform database client (PostgreSQL/Drizzle client)
+ * passed to `createApplication({ deps: { dbClient } })`.
+ */
+export declare const DB_CLIENT: InjectionToken<unknown>;

package/dist/decorators.d.ts

@@ -23,6 +23,8 @@ export interface InjectableMeta {
 }
 export interface ModuleOptions {
     name: string;
+    /** Tags for architectural boundary governance (e.g. ['scope:case', 'type:feature']). */
+    tags?: string[];
     imports?: Array<Type<unknown>>;
     providers?: Provider[];
     controllers?: Array<Type<unknown>>;
@@ -30,21 +32,25 @@ export interface ModuleOptions {
     queries?: Array<Type<unknown>>;
     exports?: Token[];
 }
-export interface ModuleMeta extends Required<Omit<ModuleOptions, "exports">> {
+export interface ModuleMeta extends Required<Omit<ModuleOptions, "exports" | "tags">> {
+    tags?: string[];
     exports: Token[];
 }
 export interface CommandOptions {
     name: string;
     /** Permission identifier required to execute (e.g. "case.create"). */
-    permission?: string;
+    permission: string;
     /** Transaction requirement for the underlying write, e.g. "required". */
-    transaction?: string;
+    transaction?: "required" | "none";
     /** Audit event name recorded on success, e.g. "case.created". */
     audit?: string;
     /** Idempotency strategy, e.g. "required". */
-    idempotency?: string;
+    idempotency?: "required" | "none";
 }
-export type CommandMeta = CommandOptions;
+export type CommandMeta = Omit<CommandOptions, "transaction" | "idempotency"> & {
+    transaction: "required" | "none";
+    idempotency: "required" | "none";
+};
 export interface QueryOptions {
     name: string;
 }
@@ -52,7 +58,7 @@ export type QueryMeta = QueryOptions;
 export interface ControllerMeta {
     path: string;
 }
-export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE";
+export type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
 export interface RouteOptions {
     /** TypeBox schema (or compatible) for the request body. */
     body?: unknown;
@@ -62,6 +68,8 @@ export interface RouteOptions {
     query?: unknown;
     /** TypeBox schema for the response. */
     response?: unknown;
+    /** Command class whose governance metadata must be enforced for this route. */
+    command?: Type<unknown>;
 }
 export interface RouteDefinition extends RouteOptions {
     method: HttpMethod;
@@ -91,4 +99,6 @@ export declare const Post: (path: string, options?: RouteOptions) => MethodDecor
 export declare const Put: (path: string, options?: RouteOptions) => MethodDecorator;
 export declare const Patch: (path: string, options?: RouteOptions) => MethodDecorator;
 export declare const Delete: (path: string, options?: RouteOptions) => MethodDecorator;
+export declare const Head: (path: string, options?: RouteOptions) => MethodDecorator;
+export declare const Options: (path: string, options?: RouteOptions) => MethodDecorator;
 export declare function getRoutes(target: object): RouteDefinition[];

package/dist/index.d.ts

@@ -4,7 +4,7 @@ export { InjectionToken } from "./token";
 export type { InjectionTokenOptions } from "./token";
 export { isClassProvider, isExistingProvider, isFactoryProvider, isValueProvider, } from "./provider";
 export type { ClassProvider, ExistingProvider, FactoryProvider, Provider, Token, Type, ValueProvider, } from "./provider";
-export { Command, Controller, Delete, Get, Inject, Injectable, Module, Patch, Post, Put, Query, getCommandMeta, getControllerMeta, getInjectParams, getInjectableMeta, getModuleMeta, getQueryMeta, getRoutes, COMMAND_METADATA, CONTROLLER_METADATA, INJECTABLE_METADATA, INJECT_PARAMS_METADATA, MODULE_METADATA, QUERY_METADATA, ROUTES_METADATA, } from "./decorators";
+export { Command, Controller, Delete, Get, Head, Inject, Injectable, Module, Options, Patch, Post, Put, Query, getCommandMeta, getControllerMeta, getInjectParams, getInjectableMeta, getModuleMeta, getQueryMeta, getRoutes, COMMAND_METADATA, CONTROLLER_METADATA, INJECTABLE_METADATA, INJECT_PARAMS_METADATA, MODULE_METADATA, QUERY_METADATA, ROUTES_METADATA, } from "./decorators";
 export type { CommandMeta, CommandOptions, ControllerMeta, HttpMethod, InjectableMeta, InjectableOptions, ModuleMeta, ModuleOptions, QueryMeta, QueryOptions, RouteDefinition, RouteOptions, } from "./decorators";
 export { defineModule } from "./module";
-export { JOB_CONTEXT, REQUEST_CONTEXT } from "./context";
+export { DB_CLIENT, JOB_CONTEXT, REQUEST_CONTEXT } from "./context";

package/dist/index.js

@@ -86,6 +86,7 @@ function Module(options) {
   return (target) => {
     const meta = {
       name: options.name,
+      tags: options.tags ?? [],
       imports: options.imports ?? [],
       providers: options.providers ?? [],
       controllers: options.controllers ?? [],
@@ -101,7 +102,11 @@ function getModuleMeta(target) {
 }
 function Command(options) {
   return (target) => {
-    defineMetadata(target, COMMAND_METADATA, { ...options });
+    defineMetadata(target, COMMAND_METADATA, {
+      ...options,
+      transaction: options.transaction ?? "none",
+      idempotency: options.idempotency ?? "none"
+    });
   };
 }
 function getCommandMeta(target) {
@@ -143,6 +148,8 @@ var Post = createRouteDecorator("POST");
 var Put = createRouteDecorator("PUT");
 var Patch = createRouteDecorator("PATCH");
 var Delete = createRouteDecorator("DELETE");
+var Head = createRouteDecorator("HEAD");
+var Options = createRouteDecorator("OPTIONS");
 function getRoutes(target) {
   return readOwnOrInherited(target, ROUTES_METADATA) ?? [];
 }
@@ -164,14 +171,19 @@ var REQUEST_CONTEXT = new InjectionToken("supacloud.request-context", {
 var JOB_CONTEXT = new InjectionToken("supacloud.job-context", {
   scope: "job"
 });
+var DB_CLIENT = new InjectionToken("supacloud.db-client", {
+  scope: "application"
+});
 export {
   COMMAND_METADATA,
   CONTROLLER_METADATA,
   Command,
   Controller,
+  DB_CLIENT,
   DEFAULT_SCOPE,
   Delete,
   Get,
+  Head,
   INJECTABLE_METADATA,
   INJECT_PARAMS_METADATA,
   Inject,
@@ -180,6 +192,7 @@ export {
   JOB_CONTEXT,
   MODULE_METADATA,
   Module,
+  Options,
   Patch,
   Post,
   Put,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@supacloud/app",
-  "version": "0.1.0",
+  "version": "0.4.0",
   "description": "Angular-style application metadata for SupaCloud: modules, DI tokens, providers, scopes, controllers and commands",
   "type": "module",
   "main": "./dist/index.js",