@supacloud/app 0.1.0 → 0.2.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

@@ -36,15 +36,18 @@ export interface ModuleMeta extends Required<Omit<ModuleOptions, "exports">> {
 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;
 }
@@ -62,6 +65,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;

package/dist/index.d.ts

@@ -7,4 +7,4 @@ export type { ClassProvider, ExistingProvider, FactoryProvider, Provider, Token,
 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 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

@@ -101,7 +101,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) {
@@ -164,11 +168,15 @@ 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,

package/package.json

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