alchemy 0.1.8 → 0.1.9

package/lib/markdown/design.js

@@ -0,0 +1,92 @@
+import { tool } from "ai";
+import fs from "node:fs/promises";
+import path from "node:path";
+import { z } from "zod";
+import { dependenciesAsMessages, generateText, resolveModel, } from "../agent";
+import { Prompts } from "../agent/prompts";
+import { rm } from "../fs";
+import { extractMarkdown } from "../markdown/extract";
+import { Resource } from "../resource";
+export class Design extends Resource("design", async (ctx, props) => {
+    if (ctx.event === "delete") {
+        await rm(props.path);
+        return;
+    }
+    const model = await resolveModel(props.model ?? "gpt-4o");
+    const loadFile = tool({
+        description: "Load a relevant file into context",
+        parameters: z.object({
+            file: z.string(),
+        }),
+        execute: async ({ file }) => fs.readFile(file, "utf-8"),
+    });
+    let existingContent = undefined;
+    if (ctx.event === "update") {
+        if (props.path) {
+            try {
+                existingContent = await fs.readFile(props.path, "utf-8");
+            }
+            catch {
+                // File doesn't exist yet, continue with empty content
+            }
+        }
+        else {
+            existingContent = ctx.output.content;
+        }
+    }
+    console.log(ctx.event === "create" ? "Designing" : "Revising design", ":", props.path);
+    const result = await generateText({
+        model,
+        // tools: {
+        //   import: importFile,
+        // },
+        providerOptions: props.model === "o3-mini"
+            ? {
+                openai: {
+                    reasoningEffort: "high",
+                },
+            }
+            : undefined,
+        messages: [
+            {
+                role: "system",
+                content: Prompts.program,
+            },
+            ...dependenciesAsMessages(props.dependencies),
+            ...(existingContent
+                ? [
+                    {
+                        role: "user",
+                        content: `Here is the prior version of ${props.path}:\n${existingContent}`,
+                    },
+                    {
+                        role: "assistant",
+                        content: "Thanks, I'll make sure to consider this when producing the next revision.",
+                    },
+                ]
+                : []),
+            {
+                role: "user",
+                content: props.prompt,
+            },
+            {
+                role: "user",
+                content: [
+                    `Make sure to list each of the files that need to be implemented and`,
+                    "and to follow best practices in term of separation of concerns.",
+                    "Ideally, each component has its own dedicated file.",
+                    "Each file should be referenced using markdown links, e.g. [file.ts](./file.ts).",
+                ].join(" "),
+            },
+        ],
+    });
+    const content = extractMarkdown(result.text);
+    await fs.mkdir(path.dirname(props.path), { recursive: true });
+    await fs.writeFile(props.path, content);
+    return {
+        path: props.path,
+        content,
+    };
+}) {
+}
+//# sourceMappingURL=design.js.map

package/lib/markdown/design.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"design.js","sourceRoot":"","sources":["../../src/markdown/design.ts"],"names":[],"mappings":"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"}

package/lib/markdown/extract.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Extracts markdown content from a code block or returns the full content
+ * @param text Response text that may contain markdown code blocks
+ * @returns The markdown content from code block if found, otherwise returns the full text
+ */
+export declare function extractMarkdown(text: string): string;
+//# sourceMappingURL=extract.d.ts.map

package/lib/markdown/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/markdown/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAGpD"}

package/lib/markdown/extract.js

@@ -0,0 +1,10 @@
+/**
+ * Extracts markdown content from a code block or returns the full content
+ * @param text Response text that may contain markdown code blocks
+ * @returns The markdown content from code block if found, otherwise returns the full text
+ */
+export function extractMarkdown(text) {
+    const matches = text.match(/```md\n([\s\S]*?)```/);
+    return matches?.[1]?.trim() ?? text.trim();
+}
+//# sourceMappingURL=extract.js.map

package/lib/markdown/extract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.js","sourceRoot":"","sources":["../../src/markdown/extract.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC;IACnD,OAAO,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;AAC7C,CAAC"}

package/lib/markdown/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./design";
+export * from "./extract";
+export * from "./requirements";
+//# sourceMappingURL=index.d.ts.map

package/lib/markdown/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/lib/markdown/index.js

@@ -0,0 +1,4 @@
+export * from "./design";
+export * from "./extract";
+export * from "./requirements";
+//# sourceMappingURL=index.js.map

package/lib/markdown/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/markdown/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC"}

package/lib/markdown/requirements.d.ts

@@ -0,0 +1,79 @@
+import { z } from "zod";
+export declare const ReasoningEffort: z.ZodEnum<["low", "medium", "high"]>;
+export declare const RequirementsInput: z.ZodObject<{
+    /**
+     * The ID of the model to use for generating requirements documentation
+     * @default "gpt-4o"
+     */
+    modelId: z.ZodOptional<z.ZodUnion<[z.ZodEnum<["o3-mini", "o1", "o1-2024-12-17", "o1-mini", "o1-mini-2024-09-12", "o1-preview", "o1-preview-2024-09-12", "gpt-4o", "gpt-4o-2024-05-13", "gpt-4o-2024-08-06", "gpt-4o-2024-11-20", "gpt-4o-audio-preview", "gpt-4o-audio-preview-2024-10-01", "gpt-4o-audio-preview-2024-12-17", "gpt-4o-mini", "gpt-4o-mini-2024-07-18", "gpt-4-turbo", "gpt-4-turbo-2024-04-09", "gpt-4-turbo-preview", "gpt-4-0125-preview", "gpt-4-1106-preview", "gpt-4", "gpt-4-0613", "gpt-3.5-turbo-0125", "gpt-3.5-turbo", "gpt-3.5-turbo-1106"]>, z.ZodEnum<["claude-3-5-sonnet-latest", "claude-3-5-sonnet-20241022", "claude-3-5-sonnet-20240620", "claude-3-5-haiku-latest", "claude-3-5-haiku-20241022", "claude-3-opus", "claude-3-opus-20240229", "claude-3-sonnet", "claude-3-sonnet-20240229", "claude-3-haiku", "claude-3-haiku-20240307"]>]>>;
+    /**
+     * The effort to put into reasoning about the requirements
+     */
+    reasoningEffort: z.ZodOptional<z.ZodEnum<["low", "medium", "high"]>>;
+    /**
+     * List of requirements to document and analyze
+     */
+    requirements: z.ZodArray<z.ZodString, "many">;
+    /**
+     * List of dependencies for the requirements document
+     */
+    dependencies: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        content: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        content?: string | undefined;
+    }, {
+        path: string;
+        content?: string | undefined;
+    }>, "many">>;
+    /**
+     * Temperature setting for model generation (higher = more creative, lower = more focused)
+     * @default 0.7
+     */
+    temperature: z.ZodOptional<z.ZodNumber>;
+    /**
+     * File path where the requirements document should be written
+     */
+    file: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    requirements: string[];
+    temperature?: number | undefined;
+    file?: string | undefined;
+    reasoningEffort?: "high" | "low" | "medium" | undefined;
+    modelId?: "o3-mini" | "o1" | "o1-2024-12-17" | "o1-mini" | "o1-mini-2024-09-12" | "o1-preview" | "o1-preview-2024-09-12" | "gpt-4o" | "gpt-4o-2024-05-13" | "gpt-4o-2024-08-06" | "gpt-4o-2024-11-20" | "gpt-4o-audio-preview" | "gpt-4o-audio-preview-2024-10-01" | "gpt-4o-audio-preview-2024-12-17" | "gpt-4o-mini" | "gpt-4o-mini-2024-07-18" | "gpt-4-turbo" | "gpt-4-turbo-2024-04-09" | "gpt-4-turbo-preview" | "gpt-4-0125-preview" | "gpt-4-1106-preview" | "gpt-4" | "gpt-4-0613" | "gpt-3.5-turbo-0125" | "gpt-3.5-turbo" | "gpt-3.5-turbo-1106" | "claude-3-5-sonnet-latest" | "claude-3-5-sonnet-20241022" | "claude-3-5-sonnet-20240620" | "claude-3-5-haiku-latest" | "claude-3-5-haiku-20241022" | "claude-3-opus" | "claude-3-opus-20240229" | "claude-3-sonnet" | "claude-3-sonnet-20240229" | "claude-3-haiku" | "claude-3-haiku-20240307" | undefined;
+    dependencies?: {
+        path: string;
+        content?: string | undefined;
+    }[] | undefined;
+}, {
+    requirements: string[];
+    temperature?: number | undefined;
+    file?: string | undefined;
+    reasoningEffort?: "high" | "low" | "medium" | undefined;
+    modelId?: "o3-mini" | "o1" | "o1-2024-12-17" | "o1-mini" | "o1-mini-2024-09-12" | "o1-preview" | "o1-preview-2024-09-12" | "gpt-4o" | "gpt-4o-2024-05-13" | "gpt-4o-2024-08-06" | "gpt-4o-2024-11-20" | "gpt-4o-audio-preview" | "gpt-4o-audio-preview-2024-10-01" | "gpt-4o-audio-preview-2024-12-17" | "gpt-4o-mini" | "gpt-4o-mini-2024-07-18" | "gpt-4-turbo" | "gpt-4-turbo-2024-04-09" | "gpt-4-turbo-preview" | "gpt-4-0125-preview" | "gpt-4-1106-preview" | "gpt-4" | "gpt-4-0613" | "gpt-3.5-turbo-0125" | "gpt-3.5-turbo" | "gpt-3.5-turbo-1106" | "claude-3-5-sonnet-latest" | "claude-3-5-sonnet-20241022" | "claude-3-5-sonnet-20240620" | "claude-3-5-haiku-latest" | "claude-3-5-haiku-20241022" | "claude-3-opus" | "claude-3-opus-20240229" | "claude-3-sonnet" | "claude-3-sonnet-20240229" | "claude-3-haiku" | "claude-3-haiku-20240307" | undefined;
+    dependencies?: {
+        path: string;
+        content?: string | undefined;
+    }[] | undefined;
+}>;
+export declare const RequirementsOutput: z.ZodObject<{
+    /**
+     * Generated markdown document containing organized and analyzed requirements
+     */
+    content: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    content: string;
+}, {
+    content: string;
+}>;
+export interface RequirementsInput extends z.infer<typeof RequirementsInput> {
+}
+export type RequirementsOutput = z.infer<typeof RequirementsOutput>;
+declare const Requirements_base: import("../resource").Provider<"code::Requirements", [props: RequirementsInput], {
+    content: string;
+}>;
+export declare class Requirements extends Requirements_base {
+}
+export {};
+//# sourceMappingURL=requirements.d.ts.map

package/lib/markdown/requirements.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.d.ts","sourceRoot":"","sources":["../../src/markdown/requirements.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAWxB,eAAO,MAAM,eAAe,sCAAoC,CAAC;AAEjE,eAAO,MAAM,iBAAiB;IAC5B;;;OAGG;;IAGH;;OAEG;;IAGH;;OAEG;;IAGH;;OAEG;;;;;;;;;;;IAGH;;;OAGG;;IAGH;;OAEG;;;;;;;;;;;;;;;;;;;;;;EAEH,CAAC;AAEH,eAAO,MAAM,kBAAkB;IAC7B;;OAEG;;;;;;EAEH,CAAC;AAEH,MAAM,WAAW,iBAAkB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC;CAAG;AAC/E,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,kBAAkB,CAAC,CAAC;;;;AAEpE,qBAAa,YAAa,SAAQ,iBA2EjC;CAAG"}

package/lib/markdown/requirements.js

@@ -0,0 +1,105 @@
+import { mkdir, writeFile } from "fs/promises";
+import { dirname } from "path";
+import { z } from "zod";
+import { FileContext, ModelId, dependenciesAsMessages, generateText, resolveModel, } from "../agent";
+import { rm } from "../fs";
+import { Resource } from "../resource";
+export const ReasoningEffort = z.enum(["low", "medium", "high"]);
+export const RequirementsInput = z.object({
+    /**
+     * The ID of the model to use for generating requirements documentation
+     * @default "gpt-4o"
+     */
+    modelId: ModelId.optional(),
+    /**
+     * The effort to put into reasoning about the requirements
+     */
+    reasoningEffort: ReasoningEffort.optional(),
+    /**
+     * List of requirements to document and analyze
+     */
+    requirements: z.array(z.string()),
+    /**
+     * List of dependencies for the requirements document
+     */
+    dependencies: z.array(FileContext).optional(),
+    /**
+     * Temperature setting for model generation (higher = more creative, lower = more focused)
+     * @default 0.7
+     */
+    temperature: z.number().optional(),
+    /**
+     * File path where the requirements document should be written
+     */
+    file: z.string().optional(),
+});
+export const RequirementsOutput = z.object({
+    /**
+     * Generated markdown document containing organized and analyzed requirements
+     */
+    content: z.string(),
+});
+export class Requirements extends Resource("code::Requirements", async (ctx, props) => {
+    if (ctx.event === "delete") {
+        if (props.file) {
+            await rm(props.file);
+        }
+        return;
+    }
+    if (props.file) {
+        console.log(ctx.event === "create" ? "Designing" : "Revising", "requirements", props.file);
+    }
+    // Get the appropriate model based on the ID
+    const model = await resolveModel(props.modelId ?? "gpt-4o");
+    // Generate the requirements document
+    const { text } = await generateText({
+        model,
+        temperature: props.temperature ?? 0.7,
+        maxSteps: 3, // Allow multiple steps for potential tool usage
+        providerOptions: props.reasoningEffort
+            ? {
+                openai: {
+                    reasoningEffort: props.reasoningEffort,
+                },
+            }
+            : undefined,
+        tools: {
+        // scrapeWebPage,
+        },
+        messages: [
+            {
+                role: "system",
+                content: "You are a helpful assistant that creates markdown documents from requirements. You can use the scrapeWebPage tool to get additional requirements from relevant URLs if needed.",
+            },
+            ...dependenciesAsMessages(props.dependencies ?? []),
+            {
+                role: "user",
+                content: `Please analyze the following system requirements and create a comprehensive, unambiguous markdown document that covers all aspects:
+
+Requirements:
+${props.requirements.map((req) => `- ${req}`).join("\n")}
+
+Guidelines:
+1. Make explicit decisions for any ambiguous requirements - do not leave open questions
+2. Document the reasoning behind key decisions
+3. Be specific about technical choices and implementation details
+4. Avoid phrases like "could be", "might need", or "possibly requires" - be definitive
+5. Organize requirements into logical sections with clear dependencies and relationships
+
+Format the output in markdown with appropriate headers, lists, and sections, starting with the title as an H1 header.
+Include technical considerations and implementation details, ensuring every requirement has a clear, actionable specification.`,
+            },
+        ],
+    });
+    if (props.file) {
+        // Ensure the directory exists
+        await mkdir(dirname(props.file), { recursive: true });
+        // Write the requirements to the file
+        await writeFile(props.file, text);
+    }
+    return {
+        content: text,
+    };
+}) {
+}
+//# sourceMappingURL=requirements.js.map

package/lib/markdown/requirements.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requirements.js","sourceRoot":"","sources":["../../src/markdown/requirements.ts"],"names":[],"mappings":"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"}

package/lib/output.d.ts

@@ -0,0 +1,19 @@
+export type Eval<U> = U extends Output<infer V> ? Eval<V> : U;
+export declare function isOutput<T>(value: any): value is Output<T>;
+export type Outputs<P extends readonly any[]> = P extends [
+    infer First,
+    ...infer Rest
+] ? [Output<First>, ...Outputs<Rest>] : [];
+export type Output<T> = {
+    apply<U>(fn: (value: T) => U): Output<Eval<U>>;
+} & (T extends string ? {
+    [k in keyof typeof String.prototype]: Output<(typeof String.prototype)[k]>;
+} : T extends number ? {
+    [K in keyof typeof Number.prototype]: Output<(typeof Number.prototype)[K]>;
+} : T extends boolean ? {
+    [K in keyof typeof Boolean.prototype]: Output<(typeof Boolean.prototype)[K]>;
+} : T extends any[] ? Outputs<T> : {
+    [k in keyof T]: Output<T[k]>;
+});
+export declare const Output: new <T, U>(parent: Output<T>, fn: (value: T) => U) => Output<U>;
+//# sourceMappingURL=output.d.ts.map

package/lib/output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,SAAS,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AAE9D,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,CAI1D;AAED,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,SAAS,GAAG,EAAE,IAAI,CAAC,SAAS;IACxD,MAAM,KAAK;IACX,GAAG,MAAM,IAAI;CACd,GACG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,GACjC,EAAE,CAAC;AAEP,MAAM,MAAM,MAAM,CAAC,CAAC,IAAI;IACtB,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;CAChD,GAAG,CAAC,CAAC,SAAS,MAAM,GACjB;KACG,CAAC,IAAI,MAAM,OAAO,MAAM,CAAC,SAAS,GAAG,MAAM,CAC1C,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC7B;CACF,GACD,CAAC,SAAS,MAAM,GACd;KACG,CAAC,IAAI,MAAM,OAAO,MAAM,CAAC,SAAS,GAAG,MAAM,CAC1C,CAAC,OAAO,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC7B;CACF,GACD,CAAC,SAAS,OAAO,GACf;KACG,CAAC,IAAI,MAAM,OAAO,OAAO,CAAC,SAAS,GAAG,MAAM,CAC3C,CAAC,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAC9B;CACF,GACD,CAAC,SAAS,GAAG,EAAE,GACb,OAAO,CAAC,CAAC,CAAC,GACV;KACG,CAAC,IAAI,MAAM,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAC7B,CAAC,CAAC;AAEb,eAAO,MAAM,MAAM,EAUd,KAAK,CAAC,EAAE,CAAC,EACZ,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,EACjB,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,KAChB,MAAM,CAAC,CAAC,CAAC,CAAC"}

package/lib/output.js

@@ -0,0 +1,16 @@
+export function isOutput(value) {
+    return (value && typeof value === "object" && typeof value.apply === "function");
+}
+export const Output = class {
+    parent;
+    fn;
+    constructor(parent, fn) {
+        this.parent = parent;
+        this.fn = fn;
+    }
+    apply(fn) {
+        // @ts-expect-error - we know we are an "Output"
+        return new Output(this, fn);
+    }
+};
+//# sourceMappingURL=output.js.map

package/lib/output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"output.js","sourceRoot":"","sources":["../src/output.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,QAAQ,CAAI,KAAU;IACpC,OAAO,CACL,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,UAAU,CACxE,CAAC;AACJ,CAAC;AAmCD,MAAM,CAAC,MAAM,MAAM,GAAG;IAEF;IACA;IAFlB,YACkB,MAAiB,EACjB,EAAmB;QADnB,WAAM,GAAN,MAAM,CAAW;QACjB,OAAE,GAAF,EAAE,CAAiB;IAClC,CAAC;IAEG,KAAK,CAAI,EAAmB;QACjC,gDAAgD;QAChD,OAAO,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAC9B,CAAC;CAIW,CAAC"}

package/lib/resource.d.ts

@@ -0,0 +1,66 @@
+import { type ApplyOptions } from "./apply";
+import type { DestroyOptions } from "./destroy";
+import type { Inputs, Input as input } from "./input";
+import { Output } from "./output";
+import { Scope as IScope } from "./scope";
+import type { State, StateStore } from "./state";
+export type ResourceID = string;
+export type ResourceType = string;
+export declare const ResourceID: unique symbol;
+export declare const Provider: unique symbol;
+export declare const Input: unique symbol;
+export declare const Value: unique symbol;
+export declare const Apply: unique symbol;
+export declare const Provide: unique symbol;
+export declare const Scope: unique symbol;
+export declare const Options: unique symbol;
+export interface ProviderOptions {
+    /**
+     * If true, the resource will be updated even if the inputs have not changed.
+     */
+    alwaysUpdate: boolean;
+}
+export type Resource<In extends any[] = any[], Out = any> = {
+    [ResourceID]: string;
+    [Provider]: Provider<any, any[], any>;
+    [Input]: Inputs<In>;
+    [Value]?: Out;
+    [Apply]: <O>(value: Out) => O;
+    [Provide]: (value: Out) => void;
+    [Options]: ProviderOptions;
+} & Output<Out>;
+export interface BaseContext {
+    quiet: boolean;
+    stage: string;
+    resourceID: ResourceID;
+    scope: IScope;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, value: T): Promise<void>;
+    delete<T>(key: string): Promise<T | undefined>;
+    /**
+     * Indicate that this resource is being replaced.
+     * This will cause the resource to be deleted at the end of the stack's CREATE phase.
+     */
+    replace(): void;
+}
+export interface CreateContext extends BaseContext {
+    event: "create";
+}
+export interface UpdateContext<Outputs> extends BaseContext {
+    event: "update";
+    output: Outputs;
+}
+export interface DeleteContext<Outputs> extends BaseContext {
+    event: "delete";
+    output: Outputs;
+}
+export type Context<Outputs> = CreateContext | UpdateContext<Outputs> | DeleteContext<Outputs>;
+export type Provider<Type extends ResourceType = ResourceType, In extends any[] = any[], Out = any> = {
+    type: Type;
+    update(stage: string, resource: Resource, deps: Set<ResourceID>, inputs: Inputs<In>, stateStore: StateStore, options: ApplyOptions): Promise<Awaited<Out>>;
+    delete(stage: string, scope: IScope | undefined, resourceID: ResourceID, state: State, inputs: Inputs<In>, options: DestroyOptions): Promise<void>;
+} & (new (id: string, ...inputs: [...Inputs<In>, ...any[]]) => Resource<In, Out>);
+export declare function isResource(value: any): value is Resource;
+export declare function Resource<const Type extends ResourceType, Args extends any[], Out>(type: Type, options: Partial<ProviderOptions>, func: (ctx: Context<Out>, ...args: Args) => Promise<input<Out> | void> | input<Out> | void): Provider<Type, Args, Awaited<Out>>;
+export declare function Resource<const Type extends ResourceType, Args extends any[], Out>(type: Type, func: (ctx: Context<Out>, ...args: Args) => Promise<input<Out> | void> | input<Out> | void): Provider<Type, Args, Awaited<Out>>;
+//# sourceMappingURL=resource.d.ts.map

package/lib/resource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resource.d.ts","sourceRoot":"","sources":["../src/resource.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,YAAY,EAAS,MAAM,SAAS,CAAC;AACnD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,KAAK,IAAI,KAAK,EAAE,MAAM,SAAS,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,KAAK,IAAI,MAAM,EAAuB,MAAM,SAAS,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAEjD,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAChC,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC;AAElC,eAAO,MAAM,UAAU,eAA2B,CAAC;AACnD,eAAO,MAAM,QAAQ,eAAyB,CAAC;AAC/C,eAAO,MAAM,KAAK,eAAsB,CAAC;AACzC,eAAO,MAAM,KAAK,eAAsB,CAAC;AACzC,eAAO,MAAM,KAAK,eAAsB,CAAC;AACzC,eAAO,MAAM,OAAO,eAAwB,CAAC;AAC7C,eAAO,MAAM,KAAK,eAAsB,CAAC;AACzC,eAAO,MAAM,OAAO,eAAwB,CAAC;AAc7C,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,YAAY,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,MAAM,QAAQ,CAAC,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EAAE,GAAG,GAAG,GAAG,IAAI;IAC1D,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IACrB,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;IACtC,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;IACpB,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;IACd,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,KAAK,CAAC,CAAC;IAC9B,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAChC,CAAC,OAAO,CAAC,EAAE,eAAe,CAAC;CAC5B,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;AAEhB,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,CAAC;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC5C,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC;IAC/C;;;OAGG;IACH,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,MAAM,WAAW,aAAc,SAAQ,WAAW;IAChD,KAAK,EAAE,QAAQ,CAAC;CACjB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,CAAE,SAAQ,WAAW;IACzD,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa,CAAC,OAAO,CAAE,SAAQ,WAAW;IACzD,KAAK,EAAE,QAAQ,CAAC;IAChB,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,OAAO,CAAC,OAAO,IACvB,aAAa,GACb,aAAa,CAAC,OAAO,CAAC,GACtB,aAAa,CAAC,OAAO,CAAC,CAAC;AAE3B,MAAM,MAAM,QAAQ,CAClB,IAAI,SAAS,YAAY,GAAG,YAAY,EACxC,EAAE,SAAS,GAAG,EAAE,GAAG,GAAG,EAAE,EACxB,GAAG,GAAG,GAAG,IACP;IACF,IAAI,EAAE,IAAI,CAAC;IACX,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,GAAG,CAAC,UAAU,CAAC,EACrB,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAClB,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;IACzB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC,EAClB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,IAAI,CAAC,CAAC;CAClB,GAAG,CAAC,KACH,EAAE,EAAE,MAAM,EACV,GAAG,MAAM,EAAE,CAAC,GAAG,MAAM,CAAC,EAAE,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,KACjC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC,CAAC;AAExB,wBAAgB,UAAU,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,QAAQ,CAExD;AAED,wBAAgB,QAAQ,CACtB,KAAK,CAAC,IAAI,SAAS,YAAY,EAC/B,IAAI,SAAS,GAAG,EAAE,EAClB,GAAG,EAEH,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,OAAO,CAAC,eAAe,CAAC,EACjC,IAAI,EAAE,CACJ,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EACjB,GAAG,IAAI,EAAE,IAAI,KACV,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAClD,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC;AAEtC,wBAAgB,QAAQ,CACtB,KAAK,CAAC,IAAI,SAAS,YAAY,EAC/B,IAAI,SAAS,GAAG,EAAE,EAClB,GAAG,EAEH,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,CACJ,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,EACjB,GAAG,IAAI,EAAE,IAAI,KACV,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,IAAI,GAClD,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC"}