@powerlines/plugin-hey-api 0.1.70 → 0.1.72

package/dist/_virtual/rolldown_runtime.cjs

@@ -1 +1,29 @@
-var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,i,o,s)=>{if(i&&typeof i==`object`||typeof i==`function`)for(var c=r(i),l=0,u=c.length,d;l<u;l++)d=c[l],!a.call(e,d)&&d!==o&&t(e,d,{get:(e=>i[e]).bind(null,d),enumerable:!(s=n(i,d))||s.enumerable});return e},s=(n,r,a)=>(a=n==null?{}:e(i(n)),o(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n));exports.__toESM=s;
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+
+exports.__toESM = __toESM;

package/dist/helpers/create-operation-id.cjs

@@ -1 +1,16 @@
-const e=require(`../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/string-format/camel-case`);function n(e){return(0,t.camelCase)(e.replace(/\b(?:a|from|to|the|given|of|an)\b/gi,``).replace(`Get list`,`list`))}exports.createOperationId=n;
+const require_rolldown_runtime = require('../_virtual/rolldown_runtime.cjs');
+let __stryke_string_format_camel_case = require("@stryke/string-format/camel-case");
+
+//#region src/helpers/create-operation-id.ts
+/**
+* Create an Operation Id from a summary string
+*
+* @param summary - The summary string from the specification
+* @returns The generated operation ID
+*/
+function createOperationId(summary) {
+	return (0, __stryke_string_format_camel_case.camelCase)(summary.replace(/\b(?:a|from|to|the|given|of|an)\b/gi, "").replace("Get list", "list"));
+}
+
+//#endregion
+exports.createOperationId = createOperationId;

package/dist/helpers/create-operation-id.mjs

@@ -1 +1,15 @@
-import{camelCase as e}from"@stryke/string-format/camel-case";function t(t){return e(t.replace(/\b(?:a|from|to|the|given|of|an)\b/gi,``).replace(`Get list`,`list`))}export{t as createOperationId};
+import { camelCase } from "@stryke/string-format/camel-case";
+
+//#region src/helpers/create-operation-id.ts
+/**
+* Create an Operation Id from a summary string
+*
+* @param summary - The summary string from the specification
+* @returns The generated operation ID
+*/
+function createOperationId(summary) {
+	return camelCase(summary.replace(/\b(?:a|from|to|the|given|of|an)\b/gi, "").replace("Get list", "list"));
+}
+
+//#endregion
+export { createOperationId };

package/dist/helpers/index.cjs

@@ -1 +1,3 @@
-const e=require(`./create-operation-id.cjs`);exports.createOperationId=e.createOperationId;
+const require_helpers_create_operation_id = require('./create-operation-id.cjs');
+
+exports.createOperationId = require_helpers_create_operation_id.createOperationId;

package/dist/helpers/index.mjs

@@ -1 +1,3 @@
-import{createOperationId as e}from"./create-operation-id.mjs";export{e as createOperationId};
+import { createOperationId } from "./create-operation-id.mjs";
+
+export { createOperationId };

package/dist/index.cjs

@@ -1 +1,92 @@
-Object.defineProperty(exports,`__esModule`,{value:!0});const e=require(`./_virtual/rolldown_runtime.cjs`),t=require(`./powerlines/src/plugin-utils/paths.cjs`),n=require(`./helpers/create-operation-id.cjs`);require(`./helpers/index.cjs`);let r=require(`@hey-api/openapi-ts`),i=require(`@stryke/path/join-paths`),a=require(`@stryke/type-checks/is-set-object`),o=require(`@stryke/type-checks/is-set-string`),s=require(`defu`);s=e.__toESM(s);const c=(e={})=>({name:`hey-api`,config(){return{heyApi:{plugins:[{name:`@hey-api/typescript`,exportFromIndex:!1},{name:`@hey-api/sdk`,instance:`PrismaClient`,exportFromIndex:!1,auth:!1},{name:`@hey-api/client-fetch`,throwOnError:!0}],...(0,s.default)(e,{schema:(0,i.joinPaths)(this.workspaceConfig.workspaceRoot,this.config.projectRoot,`schema.yaml`),output:{path:(0,i.joinPaths)(`{builtinPath}`,`api`)},logs:this.envPaths.log})}}},async configResolved(){if(this.config.heyApi.output??={},this.config.heyApi.output.path=t.replacePathTokens(this,this.config.heyApi.output.path),!this.config.heyApi.schema)throw Error("The `schema` option is required by the Hey API plugin.");if((0,o.isSetString)(this.config.heyApi.schema)){let e=await this.fetch(this.config.heyApi.schema);this.config.heyApi.schema=await e.json()}if((0,a.isSetObject)(this.config.heyApi.schema)&&this.config.heyApi.schema.paths){let e=this.config.heyApi.schema;for(let t of Object.values(e.paths))if(!(!t||`$ref`in t))for(let e of[`get`,`put`,`post`,`delete`,`options`,`head`,`patch`,`trace`]){let r=t[e];(0,o.isSetString)(r?.summary)&&(r.operationId=n.createOperationId(r.summary))}}},async prepare(){await(0,r.createClient)({...this.config.heyApi,input:this.config.heyApi.schema})}});var l=c;exports.createOperationId=n.createOperationId,exports.default=l,exports.plugin=c;
+Object.defineProperty(exports, '__esModule', { value: true });
+const require_rolldown_runtime = require('./_virtual/rolldown_runtime.cjs');
+const require_paths = require('./powerlines/src/plugin-utils/paths.cjs');
+const require_helpers_create_operation_id = require('./helpers/create-operation-id.cjs');
+require('./helpers/index.cjs');
+let __hey_api_openapi_ts = require("@hey-api/openapi-ts");
+let __stryke_path_join_paths = require("@stryke/path/join-paths");
+let __stryke_type_checks_is_set_object = require("@stryke/type-checks/is-set-object");
+let __stryke_type_checks_is_set_string = require("@stryke/type-checks/is-set-string");
+let defu = require("defu");
+defu = require_rolldown_runtime.__toESM(defu);
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to integrate Hey API for code generation.
+*
+* @see https://heyapi.dev/
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "hey-api",
+		config() {
+			return { heyApi: {
+				plugins: [
+					{
+						name: "@hey-api/typescript",
+						exportFromIndex: false
+					},
+					{
+						name: "@hey-api/sdk",
+						instance: "PrismaClient",
+						exportFromIndex: false,
+						auth: false
+					},
+					{
+						name: "@hey-api/client-fetch",
+						throwOnError: true
+					}
+				],
+				...(0, defu.default)(options, {
+					schema: (0, __stryke_path_join_paths.joinPaths)(this.workspaceConfig.workspaceRoot, this.config.projectRoot, "schema.yaml"),
+					output: { path: (0, __stryke_path_join_paths.joinPaths)("{builtinPath}", "api") },
+					logs: this.envPaths.log
+				})
+			} };
+		},
+		async configResolved() {
+			this.config.heyApi.output ??= {};
+			this.config.heyApi.output.path = require_paths.replacePathTokens(this, this.config.heyApi.output.path);
+			if (!this.config.heyApi.schema) throw new Error("The `schema` option is required by the Hey API plugin.");
+			if ((0, __stryke_type_checks_is_set_string.isSetString)(this.config.heyApi.schema)) {
+				const result = await this.fetch(this.config.heyApi.schema);
+				this.config.heyApi.schema = await result.json();
+			}
+			if ((0, __stryke_type_checks_is_set_object.isSetObject)(this.config.heyApi.schema) && this.config.heyApi.schema.paths) {
+				const schema = this.config.heyApi.schema;
+				for (const pathItem of Object.values(schema.paths)) {
+					if (!pathItem || "$ref" in pathItem) continue;
+					for (const method of [
+						"get",
+						"put",
+						"post",
+						"delete",
+						"options",
+						"head",
+						"patch",
+						"trace"
+					]) {
+						const operation = pathItem[method];
+						if (!(0, __stryke_type_checks_is_set_string.isSetString)(operation?.summary)) continue;
+						operation.operationId = require_helpers_create_operation_id.createOperationId(operation.summary);
+					}
+				}
+			}
+		},
+		async prepare() {
+			await (0, __hey_api_openapi_ts.createClient)({
+				...this.config.heyApi,
+				input: this.config.heyApi.schema
+			});
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+exports.createOperationId = require_helpers_create_operation_id.createOperationId;
+exports.default = src_default;
+exports.plugin = plugin;

package/dist/index.mjs

@@ -1 +1,87 @@
-import{replacePathTokens as e}from"./powerlines/src/plugin-utils/paths.mjs";import{createOperationId as t}from"./helpers/create-operation-id.mjs";import"./helpers/index.mjs";import{createClient as n}from"@hey-api/openapi-ts";import{joinPaths as r}from"@stryke/path/join-paths";import{isSetObject as i}from"@stryke/type-checks/is-set-object";import{isSetString as a}from"@stryke/type-checks/is-set-string";import o from"defu";const s=(s={})=>({name:`hey-api`,config(){return{heyApi:{plugins:[{name:`@hey-api/typescript`,exportFromIndex:!1},{name:`@hey-api/sdk`,instance:`PrismaClient`,exportFromIndex:!1,auth:!1},{name:`@hey-api/client-fetch`,throwOnError:!0}],...o(s,{schema:r(this.workspaceConfig.workspaceRoot,this.config.projectRoot,`schema.yaml`),output:{path:r(`{builtinPath}`,`api`)},logs:this.envPaths.log})}}},async configResolved(){if(this.config.heyApi.output??={},this.config.heyApi.output.path=e(this,this.config.heyApi.output.path),!this.config.heyApi.schema)throw Error("The `schema` option is required by the Hey API plugin.");if(a(this.config.heyApi.schema)){let e=await this.fetch(this.config.heyApi.schema);this.config.heyApi.schema=await e.json()}if(i(this.config.heyApi.schema)&&this.config.heyApi.schema.paths){let e=this.config.heyApi.schema;for(let n of Object.values(e.paths))if(!(!n||`$ref`in n))for(let e of[`get`,`put`,`post`,`delete`,`options`,`head`,`patch`,`trace`]){let r=n[e];a(r?.summary)&&(r.operationId=t(r.summary))}}},async prepare(){await n({...this.config.heyApi,input:this.config.heyApi.schema})}});var c=s;export{t as createOperationId,c as default,s as plugin};
+import { replacePathTokens } from "./powerlines/src/plugin-utils/paths.mjs";
+import { createOperationId } from "./helpers/create-operation-id.mjs";
+import "./helpers/index.mjs";
+import { createClient } from "@hey-api/openapi-ts";
+import { joinPaths } from "@stryke/path/join-paths";
+import { isSetObject } from "@stryke/type-checks/is-set-object";
+import { isSetString } from "@stryke/type-checks/is-set-string";
+import defu from "defu";
+
+//#region src/index.ts
+/**
+* A Powerlines plugin to integrate Hey API for code generation.
+*
+* @see https://heyapi.dev/
+*
+* @param options - The plugin options.
+* @returns A Powerlines plugin instance.
+*/
+const plugin = (options = {}) => {
+	return {
+		name: "hey-api",
+		config() {
+			return { heyApi: {
+				plugins: [
+					{
+						name: "@hey-api/typescript",
+						exportFromIndex: false
+					},
+					{
+						name: "@hey-api/sdk",
+						instance: "PrismaClient",
+						exportFromIndex: false,
+						auth: false
+					},
+					{
+						name: "@hey-api/client-fetch",
+						throwOnError: true
+					}
+				],
+				...defu(options, {
+					schema: joinPaths(this.workspaceConfig.workspaceRoot, this.config.projectRoot, "schema.yaml"),
+					output: { path: joinPaths("{builtinPath}", "api") },
+					logs: this.envPaths.log
+				})
+			} };
+		},
+		async configResolved() {
+			this.config.heyApi.output ??= {};
+			this.config.heyApi.output.path = replacePathTokens(this, this.config.heyApi.output.path);
+			if (!this.config.heyApi.schema) throw new Error("The `schema` option is required by the Hey API plugin.");
+			if (isSetString(this.config.heyApi.schema)) {
+				const result = await this.fetch(this.config.heyApi.schema);
+				this.config.heyApi.schema = await result.json();
+			}
+			if (isSetObject(this.config.heyApi.schema) && this.config.heyApi.schema.paths) {
+				const schema = this.config.heyApi.schema;
+				for (const pathItem of Object.values(schema.paths)) {
+					if (!pathItem || "$ref" in pathItem) continue;
+					for (const method of [
+						"get",
+						"put",
+						"post",
+						"delete",
+						"options",
+						"head",
+						"patch",
+						"trace"
+					]) {
+						const operation = pathItem[method];
+						if (!isSetString(operation?.summary)) continue;
+						operation.operationId = createOperationId(operation.summary);
+					}
+				}
+			}
+		},
+		async prepare() {
+			await createClient({
+				...this.config.heyApi,
+				input: this.config.heyApi.schema
+			});
+		}
+	};
+};
+var src_default = plugin;
+
+//#endregion
+export { createOperationId, src_default as default, plugin };

package/dist/powerlines/src/plugin-utils/paths.cjs

@@ -1 +1,36 @@
-const e=require(`../../../_virtual/rolldown_runtime.cjs`);let t=require(`@stryke/path/replace`);function n(e,n){return n&&n.replaceAll(`{workspaceRoot}`,e.workspaceConfig.workspaceRoot).replaceAll(`{root}`,e.config.projectRoot).replaceAll(`{projectRoot}`,e.config.projectRoot).replaceAll(`{sourceRoot}`,e.config.sourceRoot).replaceAll(`{powerlinesPath}`,e.powerlinesPath).replaceAll(`{cachePath}`,e.cachePath).replaceAll(`{dataPath}`,e.dataPath).replaceAll(`{logPath}`,e.envPaths.log).replaceAll(`{tempPath}`,e.envPaths.temp).replaceAll(`{configPath}`,e.envPaths.config).replaceAll(`{outputPath}`,e.config.output.outputPath).replaceAll(`{buildPath}`,e.config.output.buildPath).replaceAll(`{artifactsPath}`,(0,t.replacePath)(e.artifactsPath,e.workspaceConfig.workspaceRoot)).replaceAll(`{builtinPath}`,(0,t.replacePath)(e.builtinsPath,e.workspaceConfig.workspaceRoot)).replaceAll(`{entryPath}`,(0,t.replacePath)(e.entryPath,e.workspaceConfig.workspaceRoot))}exports.replacePathTokens=n;
+const require_rolldown_runtime = require('../../../_virtual/rolldown_runtime.cjs');
+let __stryke_path_replace = require("@stryke/path/replace");
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", (0, __stryke_path_replace.replacePath)(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", (0, __stryke_path_replace.replacePath)(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", (0, __stryke_path_replace.replacePath)(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+exports.replacePathTokens = replacePathTokens;

package/dist/powerlines/src/plugin-utils/paths.mjs

@@ -1 +1,35 @@
-import{replacePath as e}from"@stryke/path/replace";function t(t,n){return n&&n.replaceAll(`{workspaceRoot}`,t.workspaceConfig.workspaceRoot).replaceAll(`{root}`,t.config.projectRoot).replaceAll(`{projectRoot}`,t.config.projectRoot).replaceAll(`{sourceRoot}`,t.config.sourceRoot).replaceAll(`{powerlinesPath}`,t.powerlinesPath).replaceAll(`{cachePath}`,t.cachePath).replaceAll(`{dataPath}`,t.dataPath).replaceAll(`{logPath}`,t.envPaths.log).replaceAll(`{tempPath}`,t.envPaths.temp).replaceAll(`{configPath}`,t.envPaths.config).replaceAll(`{outputPath}`,t.config.output.outputPath).replaceAll(`{buildPath}`,t.config.output.buildPath).replaceAll(`{artifactsPath}`,e(t.artifactsPath,t.workspaceConfig.workspaceRoot)).replaceAll(`{builtinPath}`,e(t.builtinsPath,t.workspaceConfig.workspaceRoot)).replaceAll(`{entryPath}`,e(t.entryPath,t.workspaceConfig.workspaceRoot))}export{t as replacePathTokens};
+import { replacePath } from "@stryke/path/replace";
+
+//#region ../powerlines/src/plugin-utils/paths.ts
+/**
+* Replaces tokens in the given path string with their corresponding values from the context.
+*
+* @remarks
+* The following tokens are supported:
+* - `{workspaceRoot}` - The root directory of the workspace.
+* - `{root}` - The root directory of the project (same as `{projectRoot}`).
+* - `{projectRoot}` - The root directory of the project (same as `{root}`).
+* - `{sourceRoot}` - The source root directory of the project (usually `./src`).
+* - `{powerlinesPath}` - The directory where Powerlines is installed.
+* - `{cachePath}` - The environment's directory for cached files.
+* - `{dataPath}` - The environment's directory for data files.
+* - `{logPath}` - The environment's directory for log files.
+* - `{tempPath}` - The environment's directory for temporary files.
+* - `{configPath}` - The environment's directory for configuration files.
+* - `{outputPath}` - The configured output directory for the project.
+* - `{buildPath}` - The configured distribution directory for the project.
+* - `{artifactsPath}` - The configured directory for build artifacts.
+* - `{builtinPath}` - The configured directory for generated built-in plugins.
+* - `{entryPath}` - The configured directory for generated entry files.
+*
+* @param context - The context containing the values for the path tokens.
+* @param path - The path string with tokens to replace.
+* @returns The path string with tokens replaced by their corresponding values from the context.
+*/
+function replacePathTokens(context, path) {
+	if (!path) return path;
+	return path.replaceAll("{workspaceRoot}", context.workspaceConfig.workspaceRoot).replaceAll("{root}", context.config.projectRoot).replaceAll("{projectRoot}", context.config.projectRoot).replaceAll("{sourceRoot}", context.config.sourceRoot).replaceAll("{powerlinesPath}", context.powerlinesPath).replaceAll("{cachePath}", context.cachePath).replaceAll("{dataPath}", context.dataPath).replaceAll("{logPath}", context.envPaths.log).replaceAll("{tempPath}", context.envPaths.temp).replaceAll("{configPath}", context.envPaths.config).replaceAll("{outputPath}", context.config.output.outputPath).replaceAll("{buildPath}", context.config.output.buildPath).replaceAll("{artifactsPath}", replacePath(context.artifactsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{builtinPath}", replacePath(context.builtinsPath, context.workspaceConfig.workspaceRoot)).replaceAll("{entryPath}", replacePath(context.entryPath, context.workspaceConfig.workspaceRoot));
+}
+
+//#endregion
+export { replacePathTokens };

package/dist/powerlines/src/types/context.d.cts

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,6 +342,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

package/dist/powerlines/src/types/context.d.mts

@@ -78,10 +78,18 @@ interface ParseOptions extends ParserOptions {
    */
   allowReturnOutsideFunction?: boolean;
 }
+interface EmitOptions extends WriteOptions {
+  /**
+   * If true, will emit the file using {@link UnpluginBuildContext.emitFile | the bundler's emit function}.
+   */
+  emitWithBundler?: boolean;
+  needsCodeReference?: Parameters<UnpluginBuildContext["emitFile"]>[0]["needsCodeReference"];
+  originalFileName?: Parameters<UnpluginBuildContext["emitFile"]>[0]["originalFileName"];
+}
 /**
  * Options for emitting entry virtual files
  */
-type EmitEntryOptions = WriteOptions & Omit<ResolvedEntryTypeDefinition, "file">;
+type EmitEntryOptions = EmitOptions & Omit<ResolvedEntryTypeDefinition, "file">;
 /**
  * The unresolved Powerlines context.
  *
@@ -292,6 +300,22 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * The Powerlines builtin virtual files
    */
   getBuiltins: () => Promise<VirtualFile[]>;
+  /**
+   * Resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emit: (code: string, path: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the file
+   * @param path - The path to write the file to
+   * @param options - Additional options for writing the file
+   */
+  emitSync: (code: string, path: string, options?: EmitOptions) => void;
   /**
    * Resolves a builtin virtual file and writes it to the VFS if it does not already exist
    *
@@ -300,7 +324,16 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param path - An optional path to write the builtin file to
    * @param options - Additional options for writing the builtin file
    */
-  emitBuiltin: (code: string, id: string, path?: string, options?: WriteOptions) => Promise<void>;
+  emitBuiltin: (code: string, id: string, path?: string, options?: EmitOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a builtin virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the builtin file
+   * @param id - The unique identifier of the builtin file
+   * @param path - An optional path to write the builtin file to
+   * @param options - Additional options for writing the builtin file
+   */
+  emitBuiltinSync: (code: string, id: string, path?: string, options?: EmitOptions) => void;
   /**
    * Resolves a entry virtual file and writes it to the VFS if it does not already exist
    *
@@ -309,6 +342,14 @@ interface UnresolvedContext<TResolvedConfig extends ResolvedConfig = ResolvedCon
    * @param options - Additional options for writing the entry file
    */
   emitEntry: (code: string, path: string, options?: EmitEntryOptions) => Promise<void>;
+  /**
+   * Synchronously resolves a entry virtual file and writes it to the VFS if it does not already exist
+   *
+   * @param code - The source code of the entry file
+   * @param path - An optional path to write the entry file to
+   * @param options - Additional options for writing the entry file
+   */
+  emitEntrySync: (code: string, path: string, options?: EmitEntryOptions) => void;
   /**
    * A function to update the context fields using a new user configuration options
    */

package/dist/powerlines/src/types/fs.d.cts

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

package/dist/powerlines/src/types/fs.d.mts

@@ -13,6 +13,13 @@ interface StorageAdapter {
    * A name identifying the storage adapter type.
    */
   name: string;
+  /**
+   * The storage preset for the adapter.
+   *
+   * @remarks
+   * This can be used as an alternate way to identify the type of storage being used.
+   */
+  preset?: StoragePreset | null;
   /**
    * Checks if a key exists in the storage.
    *
@@ -207,6 +214,13 @@ interface WriteOptions {
    * @defaultValue false
    */
   skipFormat?: boolean;
+  /**
+   * The storage preset or adapter name for the output file.
+   *
+   * @remarks
+   * If not specified, the output mode will be determined by the provided `output.mode` value.
+   */
+  storage?: StoragePreset | string;
   /**
    * Additional metadata for the file.
    */

package/dist/types/index.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/dist/types/plugin.mjs

@@ -1 +1 @@
-export{};
+export {  };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerlines/plugin-hey-api",
-  "version": "0.1.70",
+  "version": "0.1.72",
   "type": "module",
   "description": "A Powerlines plugin to generate project code using Hey API.",
   "repository": {
@@ -146,19 +146,19 @@
   "keywords": ["hey-api", "powerlines", "storm-software", "powerlines-plugin"],
   "dependencies": {
     "@hey-api/openapi-ts": "^0.88.2",
-    "@stryke/path": "^0.24.0",
-    "@stryke/string-format": "^0.12.29",
-    "@stryke/type-checks": "^0.5.14",
-    "@stryke/types": "^0.10.28",
+    "@stryke/path": "^0.24.1",
+    "@stryke/string-format": "^0.12.30",
+    "@stryke/type-checks": "^0.5.15",
+    "@stryke/types": "^0.10.29",
     "defu": "^6.1.4",
     "jiti": "^2.6.1",
-    "powerlines": "^0.36.21"
+    "powerlines": "^0.36.23"
   },
   "devDependencies": {
-    "@powerlines/nx": "^0.11.47",
-    "@powerlines/plugin-plugin": "^0.12.68",
+    "@powerlines/nx": "^0.11.49",
+    "@powerlines/plugin-plugin": "^0.12.70",
     "@types/node": "^24.10.4"
   },
   "publishConfig": { "access": "public" },
-  "gitHead": "b16324cf857ea5743fd7ad06e18607b1ba32abe0"
+  "gitHead": "be47e546b48b9a82e460b5c5d4f02fb66e821f18"
 }