@decohere/create 0.0.1-dev.48 → 0.0.1-dev.5

package/types/src/webapi/features/auth0-cli.d.ts

@@ -1,72 +0,0 @@
-/** Management API scopes needed for API, SPA, connections, and admin users. */
-declare const REQUIRED_SCOPES: string;
-/** Default API scopes matching Hello CASL Authorize decorators. */
-export declare const HELLO_API_SCOPES: readonly ["read:Hello", "create:Hello", "update:Hello", "delete:Hello"];
-export declare const DB_CONNECTION_NAME = "Username-Password-Authentication";
-export declare class Auth0AuthError extends Error {
-    constructor(message: string);
-}
-export interface Auth0Tenant {
-    name: string;
-    active?: boolean;
-}
-export declare function isInstalled(): boolean;
-export declare function listTenants(): Auth0Tenant[];
-export declare function login(): boolean;
-export declare function listApis(): Array<{
-    identifier: string;
-    name: string;
-}>;
-export declare function createApi(name: string, identifier: string, scopes?: readonly string[]): {
-    identifier: string;
-};
-/**
- * Replace an API's scopes and enable RBAC policy enforcement.
- * Auth0 CLI `--scopes` replaces the full set.
- */
-export declare function updateApiScopes(identifier: string, scopes?: readonly string[]): void;
-export declare function createSpaApp(name: string, callbackUrls: string | readonly string[]): {
-    client_id: string;
-};
-export type Auth0App = {
-    client_id: string;
-    name: string;
-};
-export declare function listApps(): Auth0App[];
-export declare function updateSpaCallbacks(clientId: string, callbackUrls: string | readonly string[]): void;
-/**
- * Create a Postman SPA, or reuse an existing app with the same name (re-scaffold).
- * Always returns a client_id suitable for Postman auth0ClientId.
- */
-export declare function ensureSpaApp(name: string, callbackUrls: string | readonly string[]): {
-    client_id: string;
-    reused: boolean;
-};
-/** Enable a database connection for an application (required for username/password login). */
-export declare function enableConnectionForClient(connectionName: string, clientId: string): void;
-export type AdminDatabaseUser = {
-    user_id: string;
-    email: string;
-    password: string;
-    username: string;
-};
-/** Strong default password when the scaffolder caller leaves password blank. */
-export declare function generateAdminPassword(): string;
-/** Look up a user by email (Management API users-by-email). */
-export declare function findUserByEmail(email: string): {
-    user_id: string;
-    email: string;
-} | null;
-/** Reset password so a re-scaffold can write a known password to .env. */
-export declare function updateUserPassword(userId: string, password: string): void;
-/**
- * Create a DB connection root-admin user for local / Postman login.
- * If the user already exists, look them up, reset password to `input.password`,
- * and return that identity so callers can still write .env credentials.
- */
-export declare function createAdminDatabaseUser(input: {
-    email: string;
-    password: string;
-    username: string;
-}): AdminDatabaseUser;
-export { REQUIRED_SCOPES };

package/types/src/webapi/features/biome-format.d.ts

@@ -1,5 +0,0 @@
-/**
- * Format/lint-fix all files in the scaffolded workspace with Biome.
- * Prefer a global `biome` binary (builder image); fall back to `npx`.
- */
-export declare function formatScaffoldedFiles(targetDir: string, paths?: string[]): void;

package/types/src/webapi/features/database.feature.d.ts

@@ -1,5 +0,0 @@
-import type { Feature } from "../../services/scaffold.service.js";
-export type DatabaseOptions = {
-    databaseProvider?: "none" | "postgres/typeorm";
-};
-export declare const DatabaseFeature: Feature<DatabaseOptions>;

package/types/src/webapi/features/finalize.feature.d.ts

@@ -1,2 +0,0 @@
-import type { Feature } from "../../services/scaffold.service.js";
-export declare const FinalizeFeature: Feature;

package/types/src/webapi/features/postman.feature.d.ts

@@ -1,16 +0,0 @@
-import type { Feature } from "../../services/scaffold.service.js";
-import { type Auth0Env } from "../postman/openapi-to-postman.js";
-/** Postman OAuth callback URLs (popup + "Authorize using browser"). */
-declare const POSTMAN_CALLBACKS: readonly ["https://oauth.pstmn.io/v1/callback", "https://oauth.pstmn.io/v1/browser-callback"];
-/** Scopes requested for Auth0 access tokens (OIDC + Hello CASL permissions). */
-declare const POSTMAN_SCOPES: string;
-export type PostmanOptions = {
-    postmanProvider?: "api" | "local" | "none";
-    apiKey?: string;
-    workspaceId?: string;
-};
-/** Build Postman collection: OpenAPI routes + Auth0 auth overlay. */
-export declare function buildHybridPostmanCollection(projectName: string, auth?: Auth0Env): Promise<import("../postman/openapi-to-postman.js").PostmanCollection>;
-export declare const PostmanFeature: Feature<PostmanOptions>;
-export { buildHelloOpenApiDocument } from "../postman/hello-openapi.js";
-export { POSTMAN_CALLBACKS, POSTMAN_SCOPES };

package/types/src/webapi/models/api-package-json.model.d.ts

@@ -1,18 +0,0 @@
-import type { KeyedModel, SourceFile } from "../../models/source-file.js";
-/**
- * Builder for `projects/<api>/package.json`.
- *
- * Starts with the core cortex + crucible deps. Features can call
- * `addDependency` / `addDevDependency` to extend.
- */
-export declare class ApiPackageJson implements KeyedModel {
-    private readonly workspaceName;
-    private readonly apiName;
-    readonly key: string;
-    private readonly _dependencies;
-    private readonly _devDependencies;
-    constructor(workspaceName: string, apiName?: string);
-    addDependency(name: string, version: string): this;
-    addDevDependency(name: string, version: string): this;
-    files(): SourceFile[];
-}

package/types/src/webapi/models/auth-config.model.d.ts

@@ -1,26 +0,0 @@
-import type { KeyedModel, SourceFile } from "../../models/source-file.js";
-export type AdminUserConfig = {
-    sub: string;
-    email: string;
-    password: string;
-    username: string;
-};
-export type AuthConfig = {
-    issuerBaseUrl: string;
-    audience: string;
-    adminUser?: AdminUserConfig;
-};
-/**
- * Data-carrier model for auth configuration.
- *
- * Registered by AuthFeature when auth0 is configured. Other features (e.g.
- * PostmanFeature) retrieve it via workspace.getModel(WELL_KNOWN_FILES.AUTH_CONFIG).
- * Produces no files — exists solely so features can communicate auth details.
- */
-export declare class AuthConfigModel implements KeyedModel {
-    readonly config: AuthConfig;
-    readonly key: string;
-    constructor(config: AuthConfig);
-    setAdminUser(adminUser: AdminUserConfig): void;
-    files(): SourceFile[];
-}

package/types/src/webapi/models/controller-source-file.model.d.ts

@@ -1,45 +0,0 @@
-import type { KeyedModel, SourceFile } from "../../models/source-file.js";
-/**
- * A controller method. Features call `addDecorator()` to prepend decorators
- * before the HTTP verb decorator (e.g. `@AllowAnonymous` before `@Get()`).
- */
-export declare class ControllerMethod {
-    readonly name: string;
-    private readonly _httpDecorator;
-    private readonly _params;
-    private readonly _extraDecorators;
-    private _body;
-    private _isAsync;
-    constructor(name: string, _httpDecorator: string, _params: string, isAsync: boolean, body: string[]);
-    addDecorator(decorator: string): this;
-    /** Replace the method body lines (used by features that extend generated behaviour). */
-    setBody(body: string[]): this;
-    setAsync(isAsync?: boolean): this;
-    render(): string[];
-}
-/**
- * Model for `projects/api/src/controllers/hello.controller.ts`.
- *
- * Pre-initialised with all routes and their HTTP decorators. Features mutate
- * the model via `getMethod(name).addDecorator(...)`, `addDecorator(...)` (class
- * level), `addCortexImport(...)`, `addImport(...)`, and `addConstructorParam(...)`.
- */
-export declare class ControllerSourceFile implements KeyedModel {
-    readonly key: string;
-    private readonly _cortexImports;
-    private readonly _extraImportGroups;
-    private readonly _classDecorators;
-    private readonly _ctorParams;
-    private readonly _methods;
-    /** Retrieve a method by name to mutate its decorators. */
-    getMethod(name: string): ControllerMethod;
-    /** Add a class-level decorator (e.g. `@Authorize`). */
-    addDecorator(decorator: string): this;
-    /** Add a named import from `@decohere/cortex`. */
-    addCortexImport(name: string, typeOnly?: boolean): this;
-    /** Add a named import from any other module. */
-    addImport(name: string, from: string, typeOnly?: boolean): this;
-    /** Add a constructor parameter (e.g. an injected dependency). */
-    addConstructorParam(param: string): this;
-    files(): SourceFile[];
-}

package/types/src/webapi/models/github-ci.model.d.ts

@@ -1,9 +0,0 @@
-import type { KeyedModel, SourceFile } from "../../models/source-file.js";
-/**
- * Minimal GitHub Actions for scaffolded apps: lint ∥ test, build gate on default branch,
- * npm publish after CI (skips private packages). No default forge docker --push.
- */
-export declare class GithubCiWorkflows implements KeyedModel {
-    readonly key: string;
-    files(): SourceFile[];
-}

package/types/src/webapi/models/main-source-file.model.d.ts

@@ -1,54 +0,0 @@
-import type { KeyedModel, SourceFile } from "../../models/source-file.js";
-export type TypeOrmImport = {
-    className: string;
-    importPath: string;
-};
-export type ServiceImport = TypeOrmImport & {
-    scope?: "singleton" | "request";
-};
-/**
- * Model for `projects/api/src/main.ts`.
- *
- * Starts with the minimal HTTP + YAML config setup. Features mutate the model
- * by calling addSideEffectImport / addImport / addBuilderCall / addEntity /
- * addRepository. files() renders whatever has been accumulated.
- */
-export declare class MainSourceFile implements KeyedModel {
-    private readonly appName;
-    readonly key: string;
-    private readonly _sideEffectImports;
-    private readonly _extraImports;
-    private readonly _builderCalls;
-    private readonly _entities;
-    private readonly _repositories;
-    private readonly _services;
-    private _dataSourceName;
-    private _typeOrmSeed;
-    constructor(appName: string);
-    /** Adds a bare side-effect import, e.g. `@decohere/cortex/auth`. */
-    addSideEffectImport(path: string): this;
-    /** Adds a named import, e.g. `import { Foo } from "bar"`. */
-    addImport(name: string, from: string, typeOnly?: boolean): this;
-    /**
-     * Adds a builder call inserted after `.withConfiguration()` and before
-     * `.withServices()`. Pass the call without leading dot, e.g. `.withAuth()`.
-     */
-    addBuilderCall(call: string): this;
-    /** Adds a TypeORM entity — import and entry in `withTypeOrm({ entities })`. */
-    addEntity(entity: TypeOrmImport): this;
-    /** Adds a TypeORM repository — import and entry in `withTypeOrm({ repositories })`. */
-    addRepository(repo: TypeOrmImport): this;
-    /** Adds a service registered in `.withServices()`. */
-    addService(service: ServiceImport): this;
-    /**
-     * Datasource name passed to `withTypeOrm({ name })`. Must match
-     * `database.dataSources[].name` in config.yaml.
-     */
-    setDataSourceName(name: string): this;
-    /**
-     * Inline seed callback body for `withTypeOrm({ seed })`.
-     * Receives `dataSource` in scope. Example: `await dataSource.getRepository(User).save(...)`.
-     */
-    setTypeOrmSeed(seedBody: string): this;
-    files(): SourceFile[];
-}

package/types/src/webapi/models/production-dockerfile.model.d.ts

@@ -1,20 +0,0 @@
-import type { KeyedModel, SourceFile } from "../../models/source-file.js";
-export type ProductionDockerfileOptions = {
-    /** When true, only write `Dockerfile.<name>` (existing workspace — do not replace root Dockerfile). */
-    namedOnly?: boolean;
-};
-/**
- * Production Dockerfiles for PaaS (Railway/Fly) and local `docker build`.
- *
- * Context is always the **repo root** (`docker build -f Dockerfile.billing .`).
- * Root `Dockerfile` is the first API (`pnpm start`). Extra or custom-named APIs
- * also get `Dockerfile.<name>` so each service can be deployed on its own.
- */
-export declare class WebapiProductionDockerfile implements KeyedModel {
-    private readonly apiNames;
-    private readonly options;
-    readonly key: string;
-    constructor(apiNames?: readonly string[], options?: ProductionDockerfileOptions);
-    files(): SourceFile[];
-}
-export declare function renderProductionDockerfile(apiName: string, startScript: string): string;

package/types/src/webapi/models/sample-files.model.d.ts

@@ -1,7 +0,0 @@
-import type { SourceFile, SourceFileProvider } from "../../models/source-file.js";
-export declare class SampleConfigModel implements SourceFileProvider {
-    files(): SourceFile[];
-}
-export declare class SampleServiceModel implements SourceFileProvider {
-    files(): SourceFile[];
-}

package/types/src/webapi/models/webapi-image.model.d.ts

@@ -1,5 +0,0 @@
-import { DevContainerImageModel } from "../../models/docker-image.model.js";
-export declare class WebapiDevContainer extends DevContainerImageModel {
-    constructor(baseImage?: string);
-    protected registerBaseLayers(): void;
-}

package/types/src/webapi/postman/hello-openapi.d.ts

@@ -1,19 +0,0 @@
-/** Minimal OpenAPI 3 document shape used for Postman conversion. */
-export type ScaffoldOpenApiDocument = {
-    openapi: "3.0.3";
-    info: {
-        title: string;
-        version: string;
-        description?: string;
-    };
-    servers?: Array<{
-        url: string;
-        description?: string;
-    }>;
-    paths: Record<string, Record<string, unknown>>;
-};
-/**
- * Canonical Hello WebAPI OpenAPI document used to generate Postman requests.
- * Keep paths aligned with scaffolded HelloController (`/hello`, `/hello/{id}`).
- */
-export declare function buildHelloOpenApiDocument(projectName: string): ScaffoldOpenApiDocument;

package/types/src/webapi/postman/local-view.d.ts

@@ -1,17 +0,0 @@
-import { type Auth0Env, type PostmanCollection } from "./openapi-to-postman.js";
-/** Local View / Native Git environment (YAML). */
-export declare function buildEnvironmentYaml(name: string, auth: Auth0Env | undefined, options: {
-    callbacks: readonly string[];
-    scopes: string;
-}): string;
-/**
- * Build Postman Local View multi-file YAML from a v2.1 collection (routes)
- * plus hand-authored Auth0 overlay.
- */
-export declare function buildLocalViewFilesFromCollection(collection: PostmanCollection, projectName: string, auth: Auth0Env | undefined, options: {
-    callbacks: readonly string[];
-    scopes: string;
-}): Array<{
-    filePath: string;
-    content: string;
-}>;

package/types/src/webapi/postman/openapi-to-postman.d.ts

@@ -1,62 +0,0 @@
-import type { ScaffoldOpenApiDocument } from "./hello-openapi.js";
-export type PostmanCollection = {
-    info: {
-        _postman_id?: string;
-        name: string;
-        schema: string;
-        description?: string;
-    };
-    auth?: unknown;
-    item?: PostmanItem[];
-    variable?: Array<{
-        key: string;
-        value: string;
-    }>;
-    [key: string]: unknown;
-};
-export type PostmanItem = {
-    name?: string;
-    item?: PostmanItem[];
-    request?: PostmanRequest;
-    [key: string]: unknown;
-};
-export type PostmanRequest = {
-    method?: string;
-    header?: Array<{
-        key: string;
-        value: string;
-    }>;
-    body?: {
-        mode?: string;
-        raw?: string;
-    };
-    url?: string | {
-        raw?: string;
-        host?: string[];
-        path?: string[];
-        variable?: unknown[];
-    };
-    auth?: {
-        type: string;
-        [key: string]: unknown;
-    };
-    [key: string]: unknown;
-};
-export type Auth0Env = {
-    auth0Domain?: string;
-    auth0Audience?: string;
-    auth0ClientId?: string;
-};
-/** Convert an OpenAPI document to a Postman Collection v2.1 via openapi-to-postmanv2. */
-export declare function openApiToPostmanCollection(document: ScaffoldOpenApiDocument): Promise<PostmanCollection>;
-/**
- * Overlay Auth0 OAuth2 (PKCE) collection auth and fix Local View-friendly URLs.
- * Route items come from OpenAPI; auth/env remain hand-authored.
- */
-export declare function applyPostmanAuthOverlay(collection: PostmanCollection, projectName: string, auth: Auth0Env | undefined, options: {
-    callbacks: readonly string[];
-    scopes: string;
-    description: string;
-}): PostmanCollection;
-/** OpenAPI `{id}` → Postman `:id`, without touching `{{variables}}`. */
-export declare function openApiPathParamsToColon(url: string): string;