blink 0.1.54 → 0.1.55

package/dist/build/index.d.cts

@@ -0,0 +1,107 @@
+import * as esbuild from "esbuild";
+
+//#region src/build/types.d.ts
+interface BuildLog {
+  readonly message: string;
+  readonly file?: string;
+}
+type BuildResult = {
+  readonly entry: string;
+  readonly outdir: string;
+  readonly warnings: BuildLog[];
+  /**
+   * duration is the duration of the build in milliseconds.
+   */
+  readonly duration: number;
+} | {
+  readonly error: BuildLog;
+};
+/**
+ * BuildContext is context passed to the build function.
+ *
+ * It is the implementors responsibility to handle `watch`
+ * and to appropriately call `onStart` and `onEnd`.
+ */
+interface BuildContext {
+  readonly entry: string;
+  readonly outdir: string;
+  readonly cwd: string;
+  readonly dev?: boolean;
+  readonly watch?: boolean;
+  readonly signal?: AbortSignal;
+  readonly onStart: () => void;
+  readonly onResult: (result: BuildResult) => void;
+}
+//#endregion
+//#region src/build/esbuild.d.ts
+declare function buildWithEsbuild(options?: esbuild.BuildOptions): (context: BuildContext) => Promise<void>;
+//#endregion
+//#region src/build/index.d.ts
+interface Config {
+  /**
+   * entry is the path to the entry point of the agent.
+   * Defaults to `src/agent.ts` or `agent.ts` in the current working directory.
+   */
+  entry?: string;
+  /**
+   * outdir is the directory to write the build output to.
+   * Defaults to `.blink/build` in the current working directory.
+   */
+  outdir?: string;
+  /**
+   * build is invoked when the build starts.
+   * This is triggered by `blink dev` or `blink build`.
+   *
+   * By default, this uses the `buildWithEsbuild` function.
+   *
+   * @param context - The build context.
+   * @returns
+   * @example
+   * ```ts
+   * import { defineConfig } from "blink/build";
+   *
+   * export default defineConfig({
+   *   entry: "src/agent.ts",
+   *   outdir: "dist",
+   *   build: ({ entry, outdir, watch, onStart, onEnd }) => {
+   *     await onStart();
+   *     // ... perform build ...
+   *     await onEnd({
+   *       entry: "dist/agent.js",
+   *       outdir: "dist",
+   *       warnings: [],
+   *     });
+   *   }
+   * })
+   * ```
+   */
+  build?: (context: BuildContext) => Promise<void>;
+}
+type ResolvedConfig = Required<Config>;
+/**
+ * defineConfig is a helper function for typing the config object.
+ *
+ * @param config - The config object.
+ * @returns The config object.
+ * @example
+ * ```ts
+ * import { defineConfig } from "blink/build";
+ *
+ * export default defineConfig({
+ *   entry: "src/agent.ts",
+ *   outdir: "dist",
+ *   build: ({ entry, outdir, onBuildStart, onBuildEnd }) => {
+ *
+ *   }
+ * })
+ */
+declare function defineConfig(config?: Config): Config;
+/**
+ * resolveConfig resolves the Blink config for a given directory.
+ *
+ * @param directory - The directory to resolve the config for.
+ * @returns The resolved config.
+ */
+declare function resolveConfig(directory: string): ResolvedConfig;
+//#endregion
+export { BuildContext, BuildLog, BuildResult, Config, ResolvedConfig, buildWithEsbuild, defineConfig, resolveConfig };

package/dist/build/index.d.ts

@@ -0,0 +1,107 @@
+import * as esbuild from "esbuild";
+
+//#region src/build/types.d.ts
+interface BuildLog {
+  readonly message: string;
+  readonly file?: string;
+}
+type BuildResult = {
+  readonly entry: string;
+  readonly outdir: string;
+  readonly warnings: BuildLog[];
+  /**
+   * duration is the duration of the build in milliseconds.
+   */
+  readonly duration: number;
+} | {
+  readonly error: BuildLog;
+};
+/**
+ * BuildContext is context passed to the build function.
+ *
+ * It is the implementors responsibility to handle `watch`
+ * and to appropriately call `onStart` and `onEnd`.
+ */
+interface BuildContext {
+  readonly entry: string;
+  readonly outdir: string;
+  readonly cwd: string;
+  readonly dev?: boolean;
+  readonly watch?: boolean;
+  readonly signal?: AbortSignal;
+  readonly onStart: () => void;
+  readonly onResult: (result: BuildResult) => void;
+}
+//#endregion
+//#region src/build/esbuild.d.ts
+declare function buildWithEsbuild(options?: esbuild.BuildOptions): (context: BuildContext) => Promise<void>;
+//#endregion
+//#region src/build/index.d.ts
+interface Config {
+  /**
+   * entry is the path to the entry point of the agent.
+   * Defaults to `src/agent.ts` or `agent.ts` in the current working directory.
+   */
+  entry?: string;
+  /**
+   * outdir is the directory to write the build output to.
+   * Defaults to `.blink/build` in the current working directory.
+   */
+  outdir?: string;
+  /**
+   * build is invoked when the build starts.
+   * This is triggered by `blink dev` or `blink build`.
+   *
+   * By default, this uses the `buildWithEsbuild` function.
+   *
+   * @param context - The build context.
+   * @returns
+   * @example
+   * ```ts
+   * import { defineConfig } from "blink/build";
+   *
+   * export default defineConfig({
+   *   entry: "src/agent.ts",
+   *   outdir: "dist",
+   *   build: ({ entry, outdir, watch, onStart, onEnd }) => {
+   *     await onStart();
+   *     // ... perform build ...
+   *     await onEnd({
+   *       entry: "dist/agent.js",
+   *       outdir: "dist",
+   *       warnings: [],
+   *     });
+   *   }
+   * })
+   * ```
+   */
+  build?: (context: BuildContext) => Promise<void>;
+}
+type ResolvedConfig = Required<Config>;
+/**
+ * defineConfig is a helper function for typing the config object.
+ *
+ * @param config - The config object.
+ * @returns The config object.
+ * @example
+ * ```ts
+ * import { defineConfig } from "blink/build";
+ *
+ * export default defineConfig({
+ *   entry: "src/agent.ts",
+ *   outdir: "dist",
+ *   build: ({ entry, outdir, onBuildStart, onBuildEnd }) => {
+ *
+ *   }
+ * })
+ */
+declare function defineConfig(config?: Config): Config;
+/**
+ * resolveConfig resolves the Blink config for a given directory.
+ *
+ * @param directory - The directory to resolve the config for.
+ * @returns The resolved config.
+ */
+declare function resolveConfig(directory: string): ResolvedConfig;
+//#endregion
+export { BuildContext, BuildLog, BuildResult, Config, ResolvedConfig, buildWithEsbuild, defineConfig, resolveConfig };

package/dist/build/index.js

@@ -0,0 +1,7 @@
+import{__require as e}from"../chunk-___ucjiX.js";import t from"path";import{existsSync as n}from"fs";import{builtinModules as r}from"module";import{mkdir as i,writeFile as a}from"fs/promises";function o(e){return async n=>{let o=await import(`esbuild`),s=await o.context({entryPoints:[n.entry],outdir:n.outdir,bundle:!0,write:!1,logLevel:`silent`,format:`esm`,platform:`node`,target:`node22`,sourcemap:!1,mainFields:[`module`,`main`],conditions:[`import`,`module`],plugins:[{name:`blink-esm-require-to-import`,setup(e){e.onEnd(t=>{e.initialOptions.format!==`esm`||e.initialOptions.platform!==`node`||t.outputFiles?.forEach(e=>{if(e.path.endsWith(`.js`)||e.path.endsWith(`.mjs`)){let t=Buffer.from(e.contents).toString(`utf-8`),n=new Map,i=RegExp(`\\b__require\\("(${r.join(`|`)})"\\)`,`gm`);if(t=t.replace(i,(e,t)=>{let r=`__import_${t.toUpperCase().replace(/-/g,`_`)}`;return n.set(t,r),r}),n.size>0){let e=Array.from(n.entries()).map(([e,t])=>`import ${t} from "${e}";`).join(`
+`);t=e+`
+
+`+t}e.contents=Buffer.from(t,`utf-8`)}})})}},{name:`blink-dev-server`,setup(e){let r;e.onStart(()=>{n.onStart(),r=performance.now()}),e.onEnd(async e=>{await i(n.outdir,{recursive:!0});let o=e.outputFiles?.map(e=>({path:e.path,contents:e.contents}))??[];o.push({path:t.resolve(n.outdir,`package.json`),contents:Buffer.from(JSON.stringify({type:`module`},null,2),`utf-8`)});for(let e of o)await a(e.path,e.contents);e.errors.length>0?n.onResult({error:{message:e.errors.map(e=>`${e.text} (${e.location?.file})`).join(`
+`)}}):n.onResult({entry:t.resolve(n.outdir,t.basename(n.entry).replace(`.ts`,`.js`)),duration:performance.now()-r,outdir:n.outdir,warnings:e.warnings.map(e=>({message:e.text,file:e.location?.file}))}),n.watch||(s.dispose(),s.cancel())})}}],...e});await s.watch()}}function s(e){return e??{}}function c(r){let i=[`blink.config.ts`],a;for(let o of i){let i=t.resolve(r,o);if(n(i)){let t=e(i);if(t.default){a={...t.default};break}}}if(a||={},!a.entry){let e=[`src/agent.ts`,`src/agent.js`,`agent.ts`,`agent.js`];for(let i of e){let e=t.resolve(r,i);if(n(e)){a.entry=e;break}}if(!a.entry)throw Error(`Agent entrypoint not found.
+        
+Try creating "agent.ts" or specify "entry" in a blink.config.ts file.`)}return a.outdir||=t.resolve(r,`.blink/build`),a.build||=o(),a}export{o as buildWithEsbuild,s as defineConfig,c as resolveConfig};

package/dist/chunk-___ucjiX.js

@@ -0,0 +1 @@
+import{createRequire as e}from"node:module";var t=Object.create,n=Object.defineProperty,r=Object.getOwnPropertyDescriptor,i=Object.getOwnPropertyNames,a=Object.getPrototypeOf,o=Object.prototype.hasOwnProperty,s=(e,t)=>()=>(e&&(t=e(e=0)),t),c=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),l=(e,t)=>{for(var r in t)n(e,r,{get:t[r],enumerable:!0})},u=(e,t,a,s)=>{if(t&&typeof t==`object`||typeof t==`function`)for(var c=i(t),l=0,u=c.length,d;l<u;l++)d=c[l],!o.call(e,d)&&d!==a&&n(e,d,{get:(e=>t[e]).bind(null,d),enumerable:!(s=r(t,d))||s.enumerable});return e},d=(e,r,i)=>(i=e==null?{}:t(a(e)),u(r||!e||!e.__esModule?n(i,`default`,{value:e,enumerable:!0}):i,e)),f=e=>u(n({},`__esModule`,{value:!0}),e),p=e(import.meta.url);export{c as __commonJSMin,s as __esmMin,l as __export,p as __require,f as __toCommonJS,d as __toESM};

package/dist/chunk-hhQzssFb.cjs

@@ -0,0 +1 @@
+var e=Object.create,t=Object.defineProperty,n=Object.getOwnPropertyDescriptor,r=Object.getOwnPropertyNames,i=Object.getPrototypeOf,a=Object.prototype.hasOwnProperty,o=(e,t)=>()=>(e&&(t=e(e=0)),t),s=(e,t)=>()=>(t||e((t={exports:{}}).exports,t),t.exports),c=(e,n)=>{for(var r in n)t(e,r,{get:n[r],enumerable:!0})},l=(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},u=(n,r,a)=>(a=n==null?{}:e(i(n)),l(r||!n||!n.__esModule?t(a,`default`,{value:n,enumerable:!0}):a,n)),d=e=>l(t({},`__esModule`,{value:!0}),e);Object.defineProperty(exports,`__commonJSMin`,{enumerable:!0,get:function(){return s}}),Object.defineProperty(exports,`__esmMin`,{enumerable:!0,get:function(){return o}}),Object.defineProperty(exports,`__export`,{enumerable:!0,get:function(){return c}}),Object.defineProperty(exports,`__toCommonJS`,{enumerable:!0,get:function(){return d}}),Object.defineProperty(exports,`__toESM`,{enumerable:!0,get:function(){return u}});