alchemy 2.0.0-beta.81 → 2.0.0-beta.83

package/src/GCP/Dataplex/DataTaxonomy.ts

@@ -1,307 +0,0 @@
-import * as dataplex from "@distilled.cloud/gcp/dataplex_v1";
-import * as Effect from "effect/Effect";
-import * as Schedule from "effect/Schedule";
-import { Unowned } from "../../AdoptPolicy.ts";
-import { isResolved } from "../../Diff.ts";
-import * as Provider from "../../Provider.ts";
-import { Resource } from "../../Resource.ts";
-import { tagRecord } from "../../Tags.ts";
-import { GcpEnvironment } from "../Environment.ts";
-import { createInternalLabels, diffLabels, hasAlchemyLabels, toLabels } from "../Labels.ts";
-import type { Providers } from "../Providers.ts";
-import {
-  DataplexNotResolved,
-  collectPages,
-  hasAlchemyLabelMap,
-  listAtLocation,
-  normalizeLocation,
-  parentOf,
-  parseName,
-  replaceOnIdentity,
-  retryQuota,
-  toPhysicalId,
-  userLabels,
-  waitForOperation,
-  waitUntilExists,
-  waitUntilGone,
-} from "./internal.ts";
-
-export type DataTaxonomyProps = {
-  /**
-   * Data taxonomy id (the `{dataTaxonomy}` segment of
-   * `projects/{project}/locations/{location}/dataTaxonomies/{dataTaxonomy}`).
-   * If omitted, a unique name is generated from the stack, stage, and
-   * logical id. Must be 1-63 characters, start with a letter, and match
-   * `[a-z]([a-z0-9-]*[a-z0-9])?`. Immutable — changing it replaces the
-   * taxonomy.
-   */
-  dataTaxonomyId?: string;
-  /**
-   * Region (`us-central1`, `us-east1`, …). Immutable — changing it
-   * replaces the taxonomy. `US-CENTRAL1` is accepted and normalized to
-   * `us-central1`.
-   * @default the stack's GCP region (`GCP.Region`, else the profile region, else `us-central1`)
-   */
-  location?: string;
-  /**
-   * Human-readable description.
-   */
-  description?: string;
-  /**
-   * User-friendly display name.
-   */
-  displayName?: string;
-  /**
-   * User labels. Alchemy ownership labels are merged in automatically.
-   */
-  labels?: Record<string, string>;
-};
-
-export type DataTaxonomy = Resource<
-  "GCP.Dataplex.DataTaxonomy",
-  DataTaxonomyProps,
-  {
-    /** Full resource name. */
-    name: string;
-    /** Data taxonomy id (last path segment). */
-    dataTaxonomyId: string;
-    /** Project id. */
-    project: string;
-    /** Location id. */
-    location: string;
-    /** User-provided description. */
-    description: string | undefined;
-    /** User-friendly display name. */
-    displayName: string | undefined;
-    /** User labels (Alchemy ownership labels stripped). */
-    labels: Record<string, string>;
-    /** Number of attributes in the taxonomy. */
-    attributeCount: number | undefined;
-    /** Number of classes in the taxonomy. */
-    classCount: number | undefined;
-    /** Server etag. */
-    etag: string | undefined;
-    /** System-generated uid. */
-    uid: string | undefined;
-    /** RFC3339 creation timestamp. */
-    createTime: string | undefined;
-    /** RFC3339 last-update timestamp. */
-    updateTime: string | undefined;
-  },
-  never,
-  Providers
->;
-
-/**
- * A Dataplex Data Taxonomy — a hierarchical grouping of DataAttributes
- * (for example PII classes).
- *
- * Changing `dataTaxonomyId` or `location` replaces the taxonomy.
- * Description, display name, and labels update in place.
- *
- * ### Creating a Data Taxonomy
- * **Example:** Generated name
- * ```typescript
- * const taxonomy = yield* GCP.Dataplex.DataTaxonomy("Pii", {});
- * ```
- *
- * **Example:** Explicit id and labels
- * ```typescript
- * const taxonomy = yield* GCP.Dataplex.DataTaxonomy("Pii", {
- *   dataTaxonomyId: "sensitive-data",
- *   displayName: "Sensitive data",
- *   labels: { env: "prod" },
- * });
- * ```
- *
- * ### Updating a Data Taxonomy
- * **Example:** Description and labels
- * ```typescript
- * // Same logical id as before; only the changed props differ.
- * const taxonomy = yield* GCP.Dataplex.DataTaxonomy("Pii", {
- *   dataTaxonomyId: "sensitive-data",
- *   description: "pii classes v2",
- *   labels: { env: "prod", team: "data" },
- * });
- * ```
- *
- * @resource
- * @category Dataplex
- */
-export const DataTaxonomy = Resource<DataTaxonomy>("GCP.Dataplex.DataTaxonomy");
-
-const resourceName = (project: string, location: string, dataTaxonomyId: string) =>
-  `projects/${project}/locations/${location}/dataTaxonomies/${dataTaxonomyId}`;
-
-const toAttrs = (taxonomy: dataplex.GoogleCloudDataplexV1DataTaxonomy, project: string) => {
-  const name = taxonomy.name ?? "";
-  const parsed = parseName(name, "dataTaxonomies");
-  return {
-    name,
-    dataTaxonomyId: parsed.id,
-    project: parsed.project || project,
-    location: parsed.location,
-    description: taxonomy.description,
-    displayName: taxonomy.displayName,
-    labels: userLabels(taxonomy.labels),
-    attributeCount: taxonomy.attributeCount,
-    classCount: taxonomy.classCount,
-    etag: taxonomy.etag,
-    uid: taxonomy.uid,
-    createTime: taxonomy.createTime,
-    updateTime: taxonomy.updateTime,
-  };
-};
-
-const getByName = (name: string) =>
-  retryQuota(dataplex.getProjectsLocationsDataTaxonomies({ name })).pipe(
-    Effect.catchTag("NotFound", () => Effect.succeed(undefined)),
-  );
-
-const listTaxonomies = (project: string, region: string) => {
-  const collect = (parent: string) =>
-    collectPages(
-      dataplex.listProjectsLocationsDataTaxonomies.pages({
-        parent,
-        pageSize: 1000,
-      }),
-      (page) => page.dataTaxonomies,
-    ).pipe(Effect.map((items) => items.filter((item) => hasAlchemyLabelMap(item.labels))));
-  return listAtLocation(project, region, collect);
-};
-
-export const DataTaxonomyProvider = () =>
-  Provider.succeed(DataTaxonomy, {
-    stables: ["name", "dataTaxonomyId", "project", "location", "createTime"],
-
-    diff: Effect.fn(function* ({ news, olds, output }) {
-      if (!isResolved(news)) return undefined;
-      const env = yield* GcpEnvironment.current;
-      return replaceOnIdentity({
-        previousId: olds?.dataTaxonomyId ?? output?.dataTaxonomyId,
-        nextId: news.dataTaxonomyId ?? olds?.dataTaxonomyId ?? output?.dataTaxonomyId,
-        previousLocation: normalizeLocation(olds?.location ?? output?.location, env.region),
-        nextLocation: normalizeLocation(
-          news.location ?? olds?.location ?? output?.location,
-          env.region,
-        ),
-      });
-    }),
-
-    read: Effect.fn(function* ({ id, olds, output }) {
-      const env = yield* GcpEnvironment.current;
-      const dataTaxonomyId = yield* toPhysicalId(
-        id,
-        olds?.dataTaxonomyId,
-        output?.dataTaxonomyId,
-        "taxonomy",
-      );
-      const location = normalizeLocation(olds?.location ?? output?.location, env.region);
-      const name = output?.name ?? resourceName(env.project, location, dataTaxonomyId);
-      const existing = yield* getByName(name);
-      if (existing === undefined) return undefined;
-      const attrs = toAttrs(existing, env.project);
-      return (yield* hasAlchemyLabels(id, tagRecord(existing.labels))) ? attrs : Unowned(attrs);
-    }),
-
-    list: () =>
-      Effect.gen(function* () {
-        const env = yield* GcpEnvironment.current;
-        const items = yield* listTaxonomies(env.project, env.region);
-        return items.map((item) => toAttrs(item, env.project));
-      }),
-
-    reconcile: Effect.fn(function* ({ id, news, output }) {
-      const env = yield* GcpEnvironment.current;
-      const dataTaxonomyId = yield* toPhysicalId(
-        id,
-        news.dataTaxonomyId,
-        output?.dataTaxonomyId,
-        "taxonomy",
-      );
-      const location = normalizeLocation(news.location ?? output?.location, env.region);
-      const name = resourceName(env.project, location, dataTaxonomyId);
-      const desiredLabels = {
-        ...toLabels(news.labels),
-        ...(yield* createInternalLabels(id)),
-      };
-
-      let current = yield* getByName(output?.name ?? name);
-
-      if (current === undefined) {
-        const created = yield* dataplex
-          .createProjectsLocationsDataTaxonomies({
-            parent: parentOf(env.project, location),
-            dataTaxonomyId,
-            body: {
-              description: news.description,
-              displayName: news.displayName,
-              labels: desiredLabels,
-            },
-          })
-          .pipe(
-            retryQuota,
-            Effect.catchTag("Conflict", () => Effect.succeed(undefined)),
-          );
-        if (created !== undefined) {
-          yield* waitForOperation(created);
-        }
-        current = yield* waitUntilExists(getByName(name), name);
-      }
-
-      if (current === undefined) {
-        return yield* new DataplexNotResolved({ name });
-      }
-
-      const observedLabels = tagRecord(current.labels);
-      const { upsert, removed } = diffLabels(observedLabels, desiredLabels);
-      const labelsChanged = upsert.length > 0 || removed.length > 0;
-      const descriptionChanged = (current.description ?? "") !== (news.description ?? "");
-      const displayNameChanged = (current.displayName ?? "") !== (news.displayName ?? "");
-
-      if (labelsChanged || descriptionChanged || displayNameChanged) {
-        const operation = yield* retryQuota(
-          dataplex.patchProjectsLocationsDataTaxonomies({
-            name: current.name ?? name,
-            updateMask: [
-              labelsChanged ? "labels" : undefined,
-              descriptionChanged ? "description" : undefined,
-              displayNameChanged ? "displayName" : undefined,
-            ]
-              .filter((field): field is string => field !== undefined)
-              .join(","),
-            body: {
-              name: current.name ?? name,
-              etag: current.etag,
-              labels: desiredLabels,
-              description: news.description,
-              displayName: news.displayName,
-            },
-          }),
-        );
-        yield* waitForOperation(operation);
-        current = yield* waitUntilExists(getByName(current.name ?? name), current.name ?? name);
-      }
-
-      return toAttrs(current, env.project);
-    }),
-
-    delete: Effect.fn(function* ({ output }) {
-      const operation = yield* dataplex
-        .deleteProjectsLocationsDataTaxonomies({
-          name: output.name,
-        })
-        .pipe(
-          Effect.retry({
-            while: (error) => error._tag === "Conflict" || error._tag === "TooManyRequests",
-            times: 8,
-            schedule: Schedule.spaced("2 seconds"),
-          }),
-          Effect.catchTag("NotFound", () => Effect.succeed(undefined)),
-        );
-      if (operation !== undefined) {
-        yield* waitForOperation(operation, { notFoundOk: true });
-      }
-      yield* waitUntilGone(getByName(output.name), output.name);
-    }),
-  });

package/src/GCP/WorkspaceEvents/TasksPushNotificationConfig.ts

@@ -1,276 +0,0 @@
-import * as we from "@distilled.cloud/gcp/workspaceevents_v1";
-import * as Data from "effect/Data";
-import * as Effect from "effect/Effect";
-import { Unowned } from "../../AdoptPolicy.ts";
-import { isResolved } from "../../Diff.ts";
-import * as Provider from "../../Provider.ts";
-import { Resource } from "../../Resource.ts";
-import { GcpEnvironment } from "../Environment.ts";
-import type { Providers } from "../Providers.ts";
-import {
-  configIdOf,
-  getConfig,
-  jsonEqual,
-  MAX_CONFIG_ID_LENGTH,
-  parentOfConfig,
-  toConfigName,
-  toPhysicalId,
-  toTaskName,
-} from "./internal.ts";
-
-export type AuthenticationInfo = {
-  /** Supported authentication schemes (`Basic`, `Bearer`, …). */
-  schemes?: string[];
-  /** Optional credentials sent with the notification. */
-  credentials?: string;
-};
-
-export type PushNotificationConfig = {
-  /** HTTPS URL that receives task updates. */
-  url?: string;
-  /** Authentication attached to each notification. */
-  authentication?: AuthenticationInfo;
-  /** Client token unique for this task or session. */
-  token?: string;
-  /** Client-assigned identifier for this push configuration. */
-  id?: string;
-};
-
-export type TasksPushNotificationConfigProps = {
-  /**
-   * Parent task (`tasks/{task}` or `{task}`). Immutable — changing it
-   * replaces the config.
-   */
-  task: string;
-  /**
-   * Config id (the `{config}` segment of
-   * `tasks/{task}/pushNotificationConfigs/{config}`). If omitted, a
-   * unique RFC1035 name is generated. Immutable — changing it replaces
-   * the config.
-   */
-  configId?: string;
-  /**
-   * HTTPS URL that receives task updates.
-   */
-  url: string;
-  /**
-   * Authentication attached to each notification.
-   */
-  authentication?: AuthenticationInfo;
-  /**
-   * Client token unique for this task or session, sent with every
-   * notification as given.
-   */
-  token?: string;
-  /**
-   * Optional tenant path parameter (experimental).
-   */
-  tenant?: string;
-};
-
-export type TasksPushNotificationConfig = Resource<
-  "GCP.WorkspaceEvents.TasksPushNotificationConfig",
-  TasksPushNotificationConfigProps,
-  {
-    /** Full resource name `tasks/{task}/pushNotificationConfigs/{config}`. */
-    name: string;
-    /** Config id (last path segment). */
-    configId: string;
-    /** Parent task resource name. */
-    task: string;
-    /** Project id used when the config was reconciled. */
-    project: string;
-    /** HTTPS URL that receives task updates. */
-    url: string | undefined;
-    /** Authentication attached to each notification. */
-    authentication: AuthenticationInfo | undefined;
-    /** Client token. */
-    token: string | undefined;
-    /** Client-assigned identifier. */
-    notificationId: string | undefined;
-    /** Optional tenant. */
-    tenant: string | undefined;
-  },
-  never,
-  Providers
->;
-
-/**
- * A push-notification config for a Workspace Events / A2A task.
- *
- * The API has no labels field and the token is sent to the receiver, so
- * Alchemy writes no ownership marker: it tracks the config by name (a
- * generated config id embeds the stack, stage, and logical id). Task and config id
- * are identity — changing either replaces the config. There is no patch
- * method; changing the URL, token, or authentication replaces the
- * config. Creating a config requires an existing task.
- *
- * ### Creating a Config
- * **Example:** HTTPS webhook for a task
- * ```typescript
- * const config = yield* GCP.WorkspaceEvents.TasksPushNotificationConfig(
- *   "Updates",
- *   {
- *     task: "tasks/TASK_ID",
- *     url: "https://example.com/workspace-events",
- *   },
- * );
- * ```
- *
- * **Example:** Bearer authentication
- * ```typescript
- * const config = yield* GCP.WorkspaceEvents.TasksPushNotificationConfig(
- *   "Updates",
- *   {
- *     task: "tasks/TASK_ID",
- *     url: "https://example.com/workspace-events",
- *     authentication: { schemes: ["Bearer"], credentials: "token" },
- *   },
- * );
- * ```
- *
- * @resource
- * @category WorkspaceEvents
- */
-export const TasksPushNotificationConfig = Resource<TasksPushNotificationConfig>(
-  "GCP.WorkspaceEvents.TasksPushNotificationConfig",
-);
-
-export class TasksPushNotificationConfigNotResolved extends Data.TaggedError(
-  "GCP.WorkspaceEvents.TasksPushNotificationConfigNotResolved",
-)<{
-  name: string;
-}> {}
-
-const authOf = (auth: we.AuthenticationInfo | undefined): AuthenticationInfo | undefined => {
-  if (auth === undefined) return undefined;
-  return {
-    schemes: auth.schemes,
-    credentials: auth.credentials,
-  };
-};
-
-const toAttrs = (
-  config: we.TaskPushNotificationConfig,
-  project: string,
-  tenant: string | undefined,
-) => {
-  const name = config.name ?? "";
-  const push = config.pushNotificationConfig;
-  return {
-    name,
-    configId: configIdOf(name),
-    task: parentOfConfig(name),
-    project,
-    url: push?.url,
-    authentication: authOf(push?.authentication),
-    token: push?.token,
-    notificationId: push?.id,
-    tenant,
-  };
-};
-
-export const TasksPushNotificationConfigProvider = () =>
-  Provider.succeed(TasksPushNotificationConfig, {
-    stables: ["name", "configId", "task", "project"],
-
-    diff: Effect.fn(function* ({ news, olds, output }) {
-      if (!isResolved(news)) return undefined;
-      const previousTask = olds?.task ?? output?.task;
-      const nextTask = toTaskName(news.task);
-      const previousId = olds?.configId ?? output?.configId;
-      const identityChanged =
-        (previousTask !== undefined && toTaskName(previousTask) !== nextTask) ||
-        (previousId !== undefined && news.configId !== undefined && news.configId !== previousId);
-      const previousUrl = olds?.url ?? output?.url;
-      const previousToken = olds?.token ?? output?.token;
-      const previousAuth = olds?.authentication ?? output?.authentication;
-      const payloadChanged =
-        (previousUrl !== undefined && news.url !== previousUrl) ||
-        (news.token !== undefined && previousToken !== undefined && news.token !== previousToken) ||
-        (news.authentication !== undefined &&
-          previousAuth !== undefined &&
-          !jsonEqual(news.authentication, previousAuth));
-      if (!identityChanged && !payloadChanged) return undefined;
-      const samePhysical =
-        previousTask !== undefined &&
-        toTaskName(previousTask) === nextTask &&
-        previousId !== undefined &&
-        (news.configId === undefined || news.configId === previousId);
-      return {
-        action: "replace" as const,
-        deleteFirst: samePhysical,
-      };
-    }),
-
-    read: Effect.fn(function* ({ id, olds, output }) {
-      const env = yield* GcpEnvironment.current;
-      const task = toTaskName(olds?.task ?? output?.task ?? "");
-      const configId = yield* toPhysicalId(
-        id,
-        olds?.configId,
-        output?.configId,
-        "config",
-        MAX_CONFIG_ID_LENGTH,
-      );
-      const name = output?.name ?? toConfigName(task, configId);
-      const existing = yield* getConfig(name, olds?.tenant ?? output?.tenant);
-      if (existing === undefined) return undefined;
-      const attrs = toAttrs(existing, env.project, olds?.tenant ?? output?.tenant);
-      // Only an explicit config id found without state is ambiguous.
-      return output === undefined && olds?.configId !== undefined ? Unowned(attrs) : attrs;
-    }),
-
-    reconcile: Effect.fn(function* ({ id, news, output }) {
-      const env = yield* GcpEnvironment.current;
-      const task = toTaskName(news.task);
-      const configId = yield* toPhysicalId(
-        id,
-        news.configId,
-        output?.configId,
-        "config",
-        MAX_CONFIG_ID_LENGTH,
-      );
-      const name = output?.name ?? toConfigName(task, configId);
-      const token = news.token;
-
-      let current = yield* getConfig(name, news.tenant);
-
-      if (current === undefined) {
-        const created = yield* we
-          .createTasksPushNotificationConfigs({
-            parent: task,
-            configId,
-            tenant: news.tenant,
-            body: {
-              name,
-              pushNotificationConfig: {
-                url: news.url,
-                authentication: news.authentication,
-                token,
-                id: configId,
-              },
-            },
-          })
-          .pipe(Effect.catchTag("Conflict", () => getConfig(name, news.tenant)));
-        current = created ?? (yield* getConfig(name, news.tenant));
-      }
-
-      if (current === undefined) {
-        return yield* new TasksPushNotificationConfigNotResolved({ name });
-      }
-
-      return toAttrs(current, env.project, news.tenant);
-    }),
-
-    delete: Effect.fn(function* ({ output }) {
-      const name = output.name || toConfigName(output.task, output.configId);
-      if (name.length === 0) return;
-      yield* we
-        .deleteTasksPushNotificationConfigs({
-          name,
-          tenant: output.tenant,
-        })
-        .pipe(Effect.catchTag("NotFound", () => Effect.void));
-    }),
-  });

package/src/Util/gitignore-rules-to-globs.ts

@@ -1,80 +0,0 @@
-/**
- * Converts gitignore-style rules into glob patterns for tools like tinyglobby's {@link https://superchupu.dev/tinyglobby/documentation#ignore `ignore`} option.
- *
- * Gitignore and glob differ (ordering, negation, escapes). This maps the common cases:
- *
- * - Rules with no `/` match at any depth → \`**\/name\`, \`**\/name\/\*\/`
- * - A leading `/` anchors to the ignore file's directory (use the same `cwd` in tinyglobby) → `name`, `name/**`
- * - A `/` in the pattern (not only leading) uses path-aware matching → `a/b`, `a/b/**`
- * - A trailing `/` restricts to directories → adds `/**` as needed
- * - Lines starting with `!` (negation) are returned with a `!` prefix for use in **positive** glob
- *   lists; filter them out when passing only exclusion patterns to an `ignore` array
- *
- * Does not implement full gitignore escaping (e.g. `\\ ` for trailing space) or `**` edge cases
- * identical to git; escape handling can be added later if needed.
- */
-export function gitignoreRulesToGlobs(rules: ReadonlyArray<string>): string[] {
-  const out: string[] = [];
-  for (const raw of rules) {
-    const line = raw.trim();
-    if (line.length === 0 || line.startsWith("#")) {
-      continue;
-    }
-    let negated = false;
-    let rest = line;
-    if (rest.startsWith("!")) {
-      negated = true;
-      rest = rest.slice(1).trim();
-      if (rest.length === 0 || rest.startsWith("#")) {
-        continue;
-      }
-    }
-    let dirOnly = rest.endsWith("/");
-    if (dirOnly) {
-      rest = rest.slice(0, -1);
-    }
-    rest = rest.replace(/\\/g, "/");
-    if (rest.length === 0) {
-      continue;
-    }
-    const anchored = rest.startsWith("/");
-    if (anchored) {
-      rest = rest.slice(1);
-    }
-    if (rest.length === 0) {
-      continue;
-    }
-    const hasSlash = rest.includes("/");
-    const globs = ruleBodyToGlobs(rest, { anchored, hasSlash, dirOnly });
-    for (const g of globs) {
-      out.push(negated ? `!${g}` : g);
-    }
-  }
-  return out;
-}
-
-function ruleBodyToGlobs(
-  body: string,
-  opts: { anchored: boolean; hasSlash: boolean; dirOnly: boolean },
-): string[] {
-  const { anchored, hasSlash, dirOnly } = opts;
-  if (dirOnly) {
-    if (anchored) {
-      return [`${body}/**`];
-    }
-    if (hasSlash) {
-      return [`${body}/**`];
-    }
-    return [`**/${body}/**`];
-  }
-  if (anchored) {
-    if (hasSlash) {
-      return [body, `${body}/**`];
-    }
-    return [body, `${body}/**`];
-  }
-  if (hasSlash) {
-    return [body, `${body}/**`];
-  }
-  return [`**/${body}`, `**/${body}/**`];
-}