@decohere/scaffold 0.0.1-dev.125 → 0.0.1-dev.18

package/commonjs/src/webapi/features/postman.feature.js

@@ -1,322 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get POSTMAN_CALLBACKS () {
-        return POSTMAN_CALLBACKS;
-    },
-    get POSTMAN_SCOPES () {
-        return POSTMAN_SCOPES;
-    },
-    get PostmanFeature () {
-        return PostmanFeature;
-    },
-    get buildHelloOpenApiDocument () {
-        return _helloopenapi.buildHelloOpenApiDocument;
-    },
-    get buildHybridPostmanCollection () {
-        return buildHybridPostmanCollection;
-    }
-});
-const _nodecrypto = require("node:crypto");
-const _nodefs = require("node:fs");
-const _nodepath = require("node:path");
-const _prompt = require("../../domain/prompt.js");
-const _const = require("../../models/const.js");
-const _helloopenapi = require("../postman/hello-openapi.js");
-const _localview = require("../postman/local-view.js");
-const _openapitopostman = require("../postman/openapi-to-postman.js");
-const _auth0cli = /*#__PURE__*/ _interop_require_wildcard(require("./auth0-cli.js"));
-function _getRequireWildcardCache(nodeInterop) {
-    if (typeof WeakMap !== "function") return null;
-    var cacheBabelInterop = new WeakMap();
-    var cacheNodeInterop = new WeakMap();
-    return (_getRequireWildcardCache = function(nodeInterop) {
-        return nodeInterop ? cacheNodeInterop : cacheBabelInterop;
-    })(nodeInterop);
-}
-function _interop_require_wildcard(obj, nodeInterop) {
-    if (!nodeInterop && obj && obj.__esModule) {
-        return obj;
-    }
-    if (obj === null || typeof obj !== "object" && typeof obj !== "function") {
-        return {
-            default: obj
-        };
-    }
-    var cache = _getRequireWildcardCache(nodeInterop);
-    if (cache && cache.has(obj)) {
-        return cache.get(obj);
-    }
-    var newObj = {
-        __proto__: null
-    };
-    var hasPropertyDescriptor = Object.defineProperty && Object.getOwnPropertyDescriptor;
-    for(var key in obj){
-        if (key !== "default" && Object.prototype.hasOwnProperty.call(obj, key)) {
-            var desc = hasPropertyDescriptor ? Object.getOwnPropertyDescriptor(obj, key) : null;
-            if (desc && (desc.get || desc.set)) {
-                Object.defineProperty(newObj, key, desc);
-            } else {
-                newObj[key] = obj[key];
-            }
-        }
-    }
-    newObj.default = obj;
-    if (cache) {
-        cache.set(obj, newObj);
-    }
-    return newObj;
-}
-/** Postman OAuth callback URLs (popup + "Authorize using browser"). */ const POSTMAN_CALLBACKS = [
-    "https://oauth.pstmn.io/v1/callback",
-    "https://oauth.pstmn.io/v1/browser-callback"
-];
-/** Scopes requested for Auth0 access tokens (OIDC + Hello CASL permissions). */ const POSTMAN_SCOPES = [
-    "openid",
-    "profile",
-    "email",
-    "read:Hello",
-    "create:Hello",
-    "update:Hello",
-    "delete:Hello"
-].join(" ");
-const COLLECTION_DESCRIPTION = "Open the project root in Postman Local View (not the postman/ folder). " + "Select the Local environment, then Authorization → Get New Access Token (PKCE). " + "Routes are generated from OpenAPI; Auth0 overlay is hand-authored.";
-async function getOptions(_workspace, cliOptions) {
-    if (cliOptions.postmanProvider != null) return {};
-    const choices = [
-        {
-            label: "none",
-            description: "skip"
-        },
-        {
-            label: "local",
-            description: "Local View / Native Git files (no API key)"
-        },
-        {
-            label: "api",
-            description: "also upload to Postman.com (needs API key)"
-        }
-    ];
-    const selected = await (0, _prompt.pick)("\n  Postman: ", choices, (c)=>`${c.label} — ${c.description}`);
-    const provider = selected?.label ?? "none";
-    if (provider === "none") return {
-        postmanProvider: "none"
-    };
-    if (provider === "local") return {
-        postmanProvider: "local"
-    };
-    const apiKey = process.env.POSTMAN_API_KEY ?? await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("../../domain/prompt.js"))).then((m)=>m.ask("\n  Postman API key (app.getpostman.com/settings/me/api-keys): "));
-    const headers = {
-        "X-Api-Key": apiKey,
-        "Content-Type": "application/json"
-    };
-    const wsRes = await fetch("https://api.getpostman.com/workspaces", {
-        headers
-    });
-    if (!wsRes.ok) {
-        console.error("\n  Postman API key invalid — falling back to local files.");
-        return {
-            postmanProvider: "local"
-        };
-    }
-    const { workspaces } = await wsRes.json();
-    const wsChoices = [
-        {
-            label: "<new workspace>",
-            id: null
-        },
-        ...workspaces.map((w)=>({
-                label: `${w.name} (${w.type})`,
-                id: w.id
-            }))
-    ];
-    const wsPicked = await (0, _prompt.pick)("\n  Postman workspace: ", wsChoices, (c)=>c.label);
-    let workspaceId;
-    if (!wsPicked || wsPicked.id === null) {
-        const { ask } = await Promise.resolve().then(()=>/*#__PURE__*/ _interop_require_wildcard(require("../../domain/prompt.js")));
-        const wsName = await ask(`  Workspace name: `);
-        const createRes = await fetch("https://api.getpostman.com/workspaces", {
-            method: "POST",
-            headers,
-            body: JSON.stringify({
-                workspace: {
-                    name: wsName,
-                    type: "personal"
-                }
-            })
-        });
-        const { workspace: ws } = await createRes.json();
-        workspaceId = ws.id;
-        console.log(`  ✓ Workspace created: ${wsName}`);
-    } else {
-        workspaceId = wsPicked.id;
-    }
-    return {
-        postmanProvider: "api",
-        apiKey,
-        workspaceId
-    };
-}
-async function buildHybridPostmanCollection(projectName, auth) {
-    const openapi = (0, _helloopenapi.buildHelloOpenApiDocument)(projectName);
-    const base = await (0, _openapitopostman.openApiToPostmanCollection)(openapi);
-    if (base.info._postman_id == null) {
-        base.info._postman_id = (0, _nodecrypto.randomUUID)();
-    }
-    return (0, _openapitopostman.applyPostmanAuthOverlay)(base, projectName, auth, {
-        callbacks: POSTMAN_CALLBACKS,
-        scopes: POSTMAN_SCOPES,
-        description: COLLECTION_DESCRIPTION
-    });
-}
-/** Read a previously scaffolded auth0ClientId so re-scaffold never blanks it. */ function readExistingSpaClientId(targetDir, projectName) {
-    const envPath = (0, _nodepath.join)(targetDir, "postman/environments", `${projectName}-Local.environment.yaml`);
-    if (!(0, _nodefs.existsSync)(envPath)) return undefined;
-    const text = (0, _nodefs.readFileSync)(envPath, "utf8");
-    const match = text.match(/key:\s*auth0ClientId\s*\n\s*value:\s*["']?([^"'\n]+)/);
-    const value = match?.[1]?.trim();
-    return value && value.length > 0 ? value : undefined;
-}
-/**
- * Resolve the Postman SPA client id. Never returns empty — preserves an existing
- * env value on Auth0 failure, otherwise throws so we do not write a blank env.
- */ function resolveSpaClientId(workspace) {
-    const appName = `${workspace.name} Postman`;
-    try {
-        const app = _auth0cli.ensureSpaApp(appName, [
-            ...POSTMAN_CALLBACKS
-        ]);
-        console.log(app.reused ? `  ✓ Reusing Auth0 SPA app for Postman PKCE (${app.client_id})` : `  ✓ Auth0 SPA app created for Postman PKCE (${app.client_id})`);
-        try {
-            _auth0cli.enableConnectionForClient(_auth0cli.DB_CONNECTION_NAME, app.client_id);
-            console.log(`  ✓ Enabled ${_auth0cli.DB_CONNECTION_NAME} on Postman SPA`);
-        } catch (err) {
-            console.error(`  ✗ Failed to enable DB connection on SPA: ${err instanceof Error ? err.message : err}`);
-        }
-        return app.client_id;
-    } catch (err) {
-        const existing = readExistingSpaClientId(workspace.targetDir, workspace.name);
-        if (existing) {
-            console.error(`  ✗ Failed to ensure Auth0 SPA app (${err instanceof Error ? err.message : err})`);
-            console.log(`  ✓ Keeping existing auth0ClientId from Postman environment (${existing})`);
-            return existing;
-        }
-        const detail = err instanceof Error ? err.message : String(err);
-        // Entity-limit messages are already actionable; avoid burying them.
-        if (_auth0cli.isAuth0EntityLimitError(err)) {
-            throw new Error(detail);
-        }
-        throw new Error(`Failed to ensure Auth0 SPA app for Postman — auth0ClientId would be empty: ${detail}`);
-    }
-}
-async function scaffold(workspace, options) {
-    if (options.postmanProvider === "none" || options.postmanProvider == null) return;
-    const authConfigModel = workspace.getModel(_const.WELL_KNOWN_FILES.AUTH_CONFIG);
-    const authCfg = authConfigModel?.config;
-    const spaClientId = authCfg?.issuerBaseUrl ? resolveSpaClientId(workspace) : undefined;
-    const auth0Env = authCfg?.issuerBaseUrl ? {
-        auth0Domain: authCfg.issuerBaseUrl.replace(/^https?:\/\//, ""),
-        auth0Audience: authCfg.audience,
-        auth0ClientId: spaClientId
-    } : undefined;
-    const projectName = workspace.name;
-    const envName = `${projectName} Local`;
-    const collection = await buildHybridPostmanCollection(projectName, auth0Env);
-    const localFiles = (0, _localview.buildLocalViewFilesFromCollection)(collection, projectName, auth0Env, {
-        callbacks: POSTMAN_CALLBACKS,
-        scopes: POSTMAN_SCOPES
-    });
-    const envYaml = (0, _localview.buildEnvironmentYaml)(envName, auth0Env, {
-        callbacks: POSTMAN_CALLBACKS,
-        scopes: POSTMAN_SCOPES
-    });
-    workspace.addFile({
-        files: ()=>[
-                {
-                    filePath: ".postman/resources.yaml",
-                    content: [
-                        "# Open this project root in Postman (Files → Open folder), not the postman/ subfolder.",
-                        "# Postman fills workspace.id when you connect Local View.",
-                        "#",
-                        "# All resources under postman/ are registered automatically.",
-                        "# Route requests are generated from OpenAPI; Auth0 overlay is hand-authored.",
-                        ""
-                    ].join("\n")
-                },
-                {
-                    filePath: `postman/environments/${projectName}-Local.environment.yaml`,
-                    content: envYaml
-                },
-                ...localFiles
-            ]
-    });
-    if (options.postmanProvider === "api" && options.apiKey) {
-        const headers = {
-            "X-Api-Key": options.apiKey,
-            "Content-Type": "application/json"
-        };
-        const colRes = await fetch(`https://api.getpostman.com/collections?workspace=${options.workspaceId}`, {
-            method: "POST",
-            headers,
-            body: JSON.stringify({
-                collection
-            })
-        });
-        if (colRes.ok) {
-            console.log("  ✓ Postman collection uploaded");
-        } else {
-            console.error("  ✗ Failed to upload Postman collection");
-        }
-        const envValues = [
-            {
-                key: "baseUrl",
-                value: "http://localhost:3000",
-                enabled: true
-            },
-            ...auth0Env?.auth0Domain ? [
-                {
-                    key: "auth0Domain",
-                    value: auth0Env.auth0Domain,
-                    enabled: true
-                },
-                {
-                    key: "auth0Audience",
-                    value: auth0Env.auth0Audience ?? "",
-                    enabled: true
-                },
-                {
-                    key: "auth0ClientId",
-                    value: auth0Env.auth0ClientId ?? "",
-                    enabled: true
-                }
-            ] : []
-        ];
-        const envRes = await fetch(`https://api.getpostman.com/environments?workspace=${options.workspaceId}`, {
-            method: "POST",
-            headers,
-            body: JSON.stringify({
-                environment: {
-                    name: envName,
-                    values: envValues
-                }
-            })
-        });
-        if (envRes.ok) {
-            console.log("  ✓ Postman environment uploaded");
-        } else {
-            console.error("  ✗ Failed to upload Postman environment");
-        }
-    }
-}
-const PostmanFeature = {
-    getOptions,
-    scaffold
-};

package/commonjs/src/webapi/models/api-package-json.model.js

@@ -1,58 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "ApiPackageJson", {
-    enumerable: true,
-    get: function() {
-        return ApiPackageJson;
-    }
-});
-const _const = require("../../models/const.js");
-const _packagejsonmodel = require("../../models/package-json.model.js");
-const _version = require("../../version.js");
-class ApiPackageJson {
-    workspaceName;
-    apiName;
-    key = _const.WELL_KNOWN_FILES.API_PACKAGE_JSON;
-    _dependencies;
-    _devDependencies = {};
-    constructor(workspaceName, apiName = "api"){
-        this.workspaceName = workspaceName;
-        this.apiName = apiName;
-        this._dependencies = {
-            "@decohere/http": _version.CREATE_VERSION,
-            "@decohere/crucible": _version.CREATE_VERSION
-        };
-    }
-    addDependency(name, version) {
-        this._dependencies[name] = version;
-        return this;
-    }
-    addDevDependency(name, version) {
-        this._devDependencies[name] = version;
-        return this;
-    }
-    files() {
-        const pkg = {
-            name: `@${this.workspaceName}/${this.apiName}`,
-            version: "0.0.1",
-            private: true,
-            type: "module",
-            main: "src/main.ts",
-            scripts: {
-                lint: "biome check --write ."
-            },
-            dependencies: (0, _packagejsonmodel.sortStringMap)(this._dependencies)
-        };
-        if (Object.keys(this._devDependencies).length > 0) {
-            pkg.devDependencies = (0, _packagejsonmodel.sortStringMap)(this._devDependencies);
-        }
-        return [
-            {
-                filePath: "package.json",
-                content: JSON.stringify(pkg, null, 2)
-            }
-        ];
-    }
-}

package/commonjs/src/webapi/models/auth-config.model.js

@@ -1,24 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "AuthConfigModel", {
-    enumerable: true,
-    get: function() {
-        return AuthConfigModel;
-    }
-});
-const _const = require("../../models/const.js");
-class AuthConfigModel {
-    config;
-    key = _const.WELL_KNOWN_FILES.AUTH_CONFIG;
-    constructor(config){
-        this.config = config;
-    }
-    setAdminUser(adminUser) {
-        this.config.adminUser = adminUser;
-    }
-    files() {
-        return [];
-    }
-}

package/commonjs/src/webapi/models/controller-source-file.model.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get ControllerMethod () {
-        return ControllerMethod;
-    },
-    get ControllerSourceFile () {
-        return ControllerSourceFile;
-    }
-});
-const _const = require("../../models/const.js");
-/** Tracks named imports from a single module path, split into values and types. */ class ImportGroup {
-    _values = [];
-    _types = [];
-    add(name, typeOnly = false) {
-        if (typeOnly) {
-            // Value import already present — value wins, skip
-            if (!this._values.includes(name) && !this._types.includes(name)) {
-                this._types.push(name);
-            }
-        } else {
-            // Promote: remove from types if it was previously type-only
-            const typeIdx = this._types.indexOf(name);
-            if (typeIdx !== -1) this._types.splice(typeIdx, 1);
-            if (!this._values.includes(name)) this._values.push(name);
-        }
-        return this;
-    }
-    render(from) {
-        const values = [
-            ...this._values
-        ].sort();
-        const types = [
-            ...this._types
-        ].sort().map((n)=>`type ${n}`);
-        return `import { ${[
-            ...values,
-            ...types
-        ].join(", ")} } from "${from}";`;
-    }
-}
-class ControllerMethod {
-    name;
-    _httpDecorator;
-    _params;
-    _extraDecorators = [];
-    _body;
-    _isAsync;
-    constructor(name, _httpDecorator, _params, isAsync, body){
-        this.name = name;
-        this._httpDecorator = _httpDecorator;
-        this._params = _params;
-        this._isAsync = isAsync;
-        this._body = body;
-    }
-    addDecorator(decorator) {
-        this._extraDecorators.push(decorator);
-        return this;
-    }
-    /** Replace the method body lines (used by features that extend generated behaviour). */ setBody(body) {
-        this._body = body;
-        return this;
-    }
-    setAsync(isAsync = true) {
-        this._isAsync = isAsync;
-        return this;
-    }
-    render() {
-        const lines = [];
-        for (const d of this._extraDecorators){
-            lines.push(`\t${d}`);
-        }
-        lines.push(`\t${this._httpDecorator}`);
-        const asyncKw = this._isAsync ? "async " : "";
-        lines.push(`\tpublic ${asyncKw}${this.name}(${this._params}) {`);
-        for (const line of this._body){
-            lines.push(`\t\t${line}`);
-        }
-        lines.push("\t}");
-        return lines;
-    }
-}
-class ControllerSourceFile {
-    key = _const.WELL_KNOWN_FILES.CONTROLLER_TS;
-    _cortexImports = new ImportGroup().add("Controller").add("Delete").add("Field").add("Get").add("Param").add("Post").add("Put").add("Query");
-    _extraImportGroups = new Map([
-        [
-            "@decohere/crucible/decorators",
-            new ImportGroup().add("inject")
-        ]
-    ]);
-    _classDecorators = [];
-    /** Explicit @inject(SampleService): using the class as a value keeps its import, which SWC can drop when the class is only a type (design:paramtypes then collapses to Object). */ _ctorParams = [
-        "@inject(SampleService) private readonly sample: SampleService"
-    ];
-    _methods = new Map([
-        [
-            "getAll",
-            new ControllerMethod("getAll", "@Get()", '@Query("filter") filter: string', true, [
-                "const greeting = await this.sample.getGreeting();",
-                "return { filter, message: greeting };"
-            ])
-        ],
-        [
-            "getOne",
-            new ControllerMethod("getOne", '@Get("/:id")', '@Param("id") id: string', false, [
-                "return { id, message: `Hello ${id}!` };"
-            ])
-        ],
-        [
-            "create",
-            new ControllerMethod("create", "@Post()", "body: HelloBody", false, [
-                "return { message: body.message };"
-            ])
-        ],
-        [
-            "update",
-            new ControllerMethod("update", '@Put("/:id")', '@Param("id") id: string, body: HelloBody', false, [
-                "return { id, message: body.message };"
-            ])
-        ],
-        [
-            "remove",
-            new ControllerMethod("remove", '@Delete("/:id")', '@Param("id") id: string', false, [
-                "return { id, deleted: true };"
-            ])
-        ]
-    ]);
-    /** Retrieve a method by name to mutate its decorators. */ getMethod(name) {
-        const m = this._methods.get(name);
-        if (m == null) throw new Error(`No method '${name}' on ControllerSourceFile`);
-        return m;
-    }
-    /** Add a class-level decorator (e.g. `@Authorize`). */ addDecorator(decorator) {
-        this._classDecorators.push(decorator);
-        return this;
-    }
-    /** Add a named import from `@decohere/http`. */ addCortexImport(name, typeOnly = false) {
-        this._cortexImports.add(name, typeOnly);
-        return this;
-    }
-    /** Add a named import from any other module. */ addImport(name, from, typeOnly = false) {
-        const group = this._extraImportGroups.get(from) ?? new ImportGroup();
-        group.add(name, typeOnly);
-        this._extraImportGroups.set(from, group);
-        return this;
-    }
-    /** Add a constructor parameter (e.g. an injected dependency). */ addConstructorParam(param) {
-        this._ctorParams.push(param);
-        return this;
-    }
-    files() {
-        const lines = [
-            this._cortexImports.render("@decohere/http"),
-            'import { SampleService } from "../services/sample.service.js";'
-        ];
-        for (const [from, group] of this._extraImportGroups){
-            lines.push(group.render(from));
-        }
-        lines.push("", "class HelloBody {", '\t@Field("body", "message")', "\tpublic message!: string;", "}", "");
-        for (const d of this._classDecorators){
-            lines.push(d);
-        }
-        lines.push('@Controller({ prefix: "/hello" })', "export class HelloController {", "");
-        lines.push("\tpublic constructor(");
-        for (const p of this._ctorParams){
-            lines.push(`\t\t${p},`);
-        }
-        lines.push("\t) {}");
-        lines.push("");
-        for (const method of this._methods.values()){
-            lines.push(...method.render(), "");
-        }
-        lines.push("}", "");
-        return [
-            {
-                filePath: "src/controllers/hello.controller.ts",
-                content: lines.join("\n")
-            }
-        ];
-    }
-}