@distilled.cloud/planetscale 0.0.0 → 0.2.3

package/lib/operations/workflowSwitchReplicas.js

@@ -0,0 +1,157 @@
+import * as Schema from "effect/Schema";
+import { API } from "../client";
+import * as T from "../traits";
+import { Forbidden, NotFound } from "../errors";
+// Input Schema
+export const WorkflowSwitchReplicasInput = 
+/*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
+    organization: Schema.String.pipe(T.PathParam()),
+    database: Schema.String.pipe(T.PathParam()),
+    number: Schema.Number.pipe(T.PathParam()),
+}).pipe(T.Http({
+    method: "PATCH",
+    path: "/organizations/{organization}/databases/{database}/workflows/{number}/switch-replicas",
+}));
+// Output Schema
+export const WorkflowSwitchReplicasOutput = 
+/*@__PURE__*/ /*#__PURE__*/ Schema.Struct({
+    id: Schema.String,
+    name: Schema.String,
+    number: Schema.Number,
+    state: Schema.Literals([
+        "pending",
+        "copying",
+        "running",
+        "stopped",
+        "verifying_data",
+        "verified_data",
+        "switching_replicas",
+        "switched_replicas",
+        "switching_primaries",
+        "switched_primaries",
+        "reversing_traffic",
+        "reversing_traffic_for_cancel",
+        "cutting_over",
+        "cutover",
+        "reversed_cutover",
+        "completed",
+        "cancelling",
+        "cancelled",
+        "error",
+    ]),
+    created_at: Schema.String,
+    updated_at: Schema.String,
+    started_at: Schema.String,
+    completed_at: Schema.String,
+    cancelled_at: Schema.String,
+    reversed_at: Schema.String,
+    retried_at: Schema.String,
+    data_copy_completed_at: Schema.String,
+    cutover_at: Schema.String,
+    replicas_switched: Schema.Boolean,
+    primaries_switched: Schema.Boolean,
+    switch_replicas_at: Schema.String,
+    switch_primaries_at: Schema.String,
+    verify_data_at: Schema.String,
+    workflow_type: Schema.Literals(["move_tables"]),
+    workflow_subtype: Schema.String,
+    defer_secondary_keys: Schema.Boolean,
+    on_ddl: Schema.Literals(["IGNORE", "STOP", "EXEC", "EXEC_IGNORE"]),
+    workflow_errors: Schema.String,
+    may_retry: Schema.Boolean,
+    may_restart: Schema.Boolean,
+    verified_data_stale: Schema.Boolean,
+    sequence_tables_applied: Schema.Boolean,
+    actor: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    verify_data_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    reversed_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    switch_replicas_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    switch_primaries_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    cancelled_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    completed_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    retried_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    cutover_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    reversed_cutover_by: Schema.Struct({
+        id: Schema.String,
+        display_name: Schema.String,
+        avatar_url: Schema.String,
+    }),
+    branch: Schema.Struct({
+        id: Schema.String,
+        name: Schema.String,
+        created_at: Schema.String,
+        updated_at: Schema.String,
+        deleted_at: Schema.String,
+    }),
+    source_keyspace: Schema.Struct({
+        id: Schema.String,
+        name: Schema.String,
+        created_at: Schema.String,
+        updated_at: Schema.String,
+        deleted_at: Schema.String,
+    }),
+    target_keyspace: Schema.Struct({
+        id: Schema.String,
+        name: Schema.String,
+        created_at: Schema.String,
+        updated_at: Schema.String,
+        deleted_at: Schema.String,
+    }),
+    global_keyspace: Schema.Struct({
+        id: Schema.String,
+        name: Schema.String,
+        created_at: Schema.String,
+        updated_at: Schema.String,
+        deleted_at: Schema.String,
+    }),
+});
+// The operation
+/**
+ * Switch replica traffic
+ *
+ * @param organization - The name of the organization the workflow belongs to
+ * @param database - The name of the database the workflow belongs to
+ * @param number - The sequence number of the workflow
+ */
+export const workflowSwitchReplicas = /*@__PURE__*/ /*#__PURE__*/ API.make(() => ({
+    inputSchema: WorkflowSwitchReplicasInput,
+    outputSchema: WorkflowSwitchReplicasOutput,
+    errors: [Forbidden, NotFound],
+}));
+//# sourceMappingURL=workflowSwitchReplicas.js.map

package/lib/operations/workflowSwitchReplicas.js.map

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

package/lib/retry.d.ts

@@ -0,0 +1,24 @@
+/**
+ * PlanetScale retry configuration.
+ *
+ * Re-exports shared retry utilities and provides a PlanetScale-specific Retry service.
+ */
+import * as Effect from "effect/Effect";
+import * as ServiceMap from "effect/ServiceMap";
+export { type Options, type Factory, type Policy, makeDefault, jittered, capped, throttlingOptions, transientOptions, } from "@distilled.cloud/core/retry";
+import type { Policy } from "@distilled.cloud/core/retry";
+declare const Retry_base: ServiceMap.ServiceClass<Retry, "PlanetScaleRetry", Policy>;
+/**
+ * Context tag for configuring retry behavior of PlanetScale API calls.
+ */
+export declare class Retry extends Retry_base {
+}
+/**
+ * Provides a custom retry policy to all PlanetScale API calls.
+ */
+export declare const policy: (optionsOrFactory: Policy) => <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+/**
+ * Disables all automatic retries.
+ */
+export declare const none: <A, E, R>(self: Effect.Effect<A, E, R>) => Effect.Effect<A, E, Exclude<R, Retry>>;
+//# sourceMappingURL=retry.d.ts.map

package/lib/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,MAAM,EACX,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,6BAA6B,CAAC;;AAE1D;;GAEG;AACH,qBAAa,KAAM,SAAQ,UAE1B;CAAG;AAEJ;;GAEG;AACH,eAAO,MAAM,MAAM,iHACqC,CAAC;AAEzD;;GAEG;AACH,eAAO,MAAM,IAAI,mFAEhB,CAAC"}

package/lib/retry.js

@@ -0,0 +1,23 @@
+/**
+ * PlanetScale retry configuration.
+ *
+ * Re-exports shared retry utilities and provides a PlanetScale-specific Retry service.
+ */
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ServiceMap from "effect/ServiceMap";
+export { makeDefault, jittered, capped, throttlingOptions, transientOptions, } from "@distilled.cloud/core/retry";
+/**
+ * Context tag for configuring retry behavior of PlanetScale API calls.
+ */
+export class Retry extends ServiceMap.Service()("PlanetScaleRetry") {
+}
+/**
+ * Provides a custom retry policy to all PlanetScale API calls.
+ */
+export const policy = (optionsOrFactory) => Effect.provide(Layer.succeed(Retry, optionsOrFactory));
+/**
+ * Disables all automatic retries.
+ */
+export const none = Effect.provide(Layer.succeed(Retry, { while: () => false }));
+//# sourceMappingURL=retry.js.map

package/lib/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","sourceRoot":"","sources":["../src/retry.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,KAAK,UAAU,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAIL,WAAW,EACX,QAAQ,EACR,MAAM,EACN,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AAGrC;;GAEG;AACH,MAAM,OAAO,KAAM,SAAQ,UAAU,CAAC,OAAO,EAAiB,CAC5D,kBAAkB,CACnB;CAAG;AAEJ;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,gBAAwB,EAAE,EAAE,CACjD,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,OAAO,CAChC,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC,CAC7C,CAAC"}

package/lib/sensitive.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Re-export sensitive data schemas from sdk-core.
+ */
+export * from "@distilled.cloud/core/sensitive";
+//# sourceMappingURL=sensitive.d.ts.map

package/lib/sensitive.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive.d.ts","sourceRoot":"","sources":["../src/sensitive.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iCAAiC,CAAC"}

package/lib/sensitive.js

@@ -0,0 +1,5 @@
+/**
+ * Re-export sensitive data schemas from sdk-core.
+ */
+export * from "@distilled.cloud/core/sensitive";
+//# sourceMappingURL=sensitive.js.map

package/lib/sensitive.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sensitive.js","sourceRoot":"","sources":["../src/sensitive.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,cAAc,iCAAiC,CAAC"}

package/lib/traits.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Re-export the shared traits system from sdk-core.
+ *
+ * PlanetScale uses the shared HTTP traits directly.
+ * Import from this module for SDK-consistent imports:
+ *
+ * @example
+ * ```ts
+ * import * as T from "@distilled.cloud/planetscale/traits";
+ * ```
+ */
+export * from "@distilled.cloud/core/traits";
+//# sourceMappingURL=traits.d.ts.map

package/lib/traits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.d.ts","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,8BAA8B,CAAC"}

package/lib/traits.js

@@ -0,0 +1,13 @@
+/**
+ * Re-export the shared traits system from sdk-core.
+ *
+ * PlanetScale uses the shared HTTP traits directly.
+ * Import from this module for SDK-consistent imports:
+ *
+ * @example
+ * ```ts
+ * import * as T from "@distilled.cloud/planetscale/traits";
+ * ```
+ */
+export * from "@distilled.cloud/core/traits";
+//# sourceMappingURL=traits.js.map

package/lib/traits.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"traits.js","sourceRoot":"","sources":["../src/traits.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,cAAc,8BAA8B,CAAC"}

package/package.json

@@ -1,13 +1,88 @@
 {
   "name": "@distilled.cloud/planetscale",
-  "version": "0.0.0",
-  "module": "index.ts",
+  "version": "0.2.3",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/alchemy-run/distilled",
+    "directory": "packages/planetscale"
+  },
   "type": "module",
-  "private": false,
+  "sideEffects": false,
+  "module": "src/index.ts",
+  "files": [
+    "lib",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "bun": "./src/index.ts",
+      "default": "./lib/index.js"
+    },
+    "./Category": {
+      "types": "./lib/category.d.ts",
+      "bun": "./src/category.ts",
+      "default": "./lib/category.js"
+    },
+    "./Client": {
+      "types": "./lib/client.d.ts",
+      "bun": "./src/client.ts",
+      "default": "./lib/client.js"
+    },
+    "./Credentials": {
+      "types": "./lib/credentials.d.ts",
+      "bun": "./src/credentials.ts",
+      "default": "./lib/credentials.js"
+    },
+    "./Errors": {
+      "types": "./lib/errors.d.ts",
+      "bun": "./src/errors.ts",
+      "default": "./lib/errors.js"
+    },
+    "./Operations": {
+      "types": "./lib/operations/index.d.ts",
+      "bun": "./src/operations/index.ts",
+      "default": "./lib/operations/index.js"
+    },
+    "./Retry": {
+      "types": "./lib/retry.d.ts",
+      "bun": "./src/retry.ts",
+      "default": "./lib/retry.js"
+    },
+    "./Sensitive": {
+      "types": "./lib/sensitive.d.ts",
+      "bun": "./src/sensitive.ts",
+      "default": "./lib/sensitive.js"
+    },
+    "./Traits": {
+      "types": "./lib/traits.d.ts",
+      "bun": "./src/traits.ts",
+      "default": "./lib/traits.js"
+    }
+  },
+  "scripts": {
+    "typecheck": "tsgo",
+    "build": "tsgo -b",
+    "fmt": "oxfmt --write src",
+    "lint": "oxlint --fix src",
+    "check": "tsgo && oxlint src && oxfmt --check src",
+    "test": "bunx vitest run test",
+    "publish:npm": "bun run build && bun publish --access public",
+    "generate": "bun run scripts/generate.ts && oxfmt --write src && oxlint --fix src",
+    "specs:fetch": "git submodule update --force --init --recursive specs/distilled-spec-planetscale && git -C specs/distilled-spec-planetscale checkout -- .",
+    "specs:update": "git -C specs/distilled-spec-planetscale fetch && git -C specs/distilled-spec-planetscale checkout main && git -C specs/distilled-spec-planetscale pull"
+  },
+  "dependencies": {
+    "@distilled.cloud/core": "0.2.0-alpha",
+    "effect": "4.0.0-beta.30"
+  },
   "devDependencies": {
-    "@types/bun": "latest"
+    "@types/bun": "^1.3.0",
+    "@types/node": "^25.3.5",
+    "dotenv": "^16.5.0",
+    "vitest": "^3.2.3"
   },
   "peerDependencies": {
-    "typescript": "^5"
+    "effect": "4.0.0-beta.30"
   }
 }

package/src/category.ts

@@ -0,0 +1,12 @@
+/**
+ * Re-export the shared category system from sdk-core.
+ *
+ * PlanetScale uses the shared category system directly.
+ * Import from this module for SDK-consistent imports:
+ *
+ * @example
+ * ```ts
+ * import * as Category from "@distilled.cloud/planetscale/category";
+ * ```
+ */
+export * from "@distilled.cloud/core/category";

package/src/client.ts

@@ -0,0 +1,60 @@
+/**
+ * PlanetScale API Client.
+ *
+ * Wraps the shared REST client from sdk-core with PlanetScale-specific
+ * error matching and credential handling.
+ */
+import * as Effect from "effect/Effect";
+import * as Schema from "effect/Schema";
+import { makeAPI } from "@distilled.cloud/core/client";
+import {
+  HTTP_STATUS_MAP,
+  UnknownPlanetScaleError,
+  PlanetScaleParseError,
+} from "./errors.ts";
+
+// Re-export for backwards compatibility (tests import UnknownPlanetScaleError from client)
+export { UnknownPlanetScaleError } from "./errors.ts";
+import { Credentials } from "./credentials.ts";
+
+// API Error Response Schema
+const ApiErrorResponse = Schema.Struct({
+  code: Schema.String,
+  message: Schema.optional(Schema.String),
+});
+
+/**
+ * Match a PlanetScale API error response to the appropriate error class.
+ */
+const matchError = (
+  status: number,
+  errorBody: unknown,
+): Effect.Effect<never, unknown> => {
+  try {
+    const parsed = Schema.decodeUnknownSync(ApiErrorResponse)(errorBody);
+    const ErrorClass = (HTTP_STATUS_MAP as any)[status];
+    if (ErrorClass) {
+      return Effect.fail(new ErrorClass({ message: parsed.message ?? "" }));
+    }
+    return Effect.fail(
+      new UnknownPlanetScaleError({
+        code: parsed.code,
+        message: parsed.message,
+        body: errorBody,
+      }),
+    );
+  } catch {
+    return Effect.fail(new UnknownPlanetScaleError({ body: errorBody }));
+  }
+};
+
+/**
+ * PlanetScale API client.
+ */
+export const API = makeAPI({
+  credentials: Credentials as any,
+  getBaseUrl: (creds: any) => creds.apiBaseUrl,
+  getAuthHeaders: (creds: any) => ({ Authorization: creds.token }),
+  matchError,
+  ParseError: PlanetScaleParseError as any,
+});

package/src/credentials.ts

@@ -0,0 +1,38 @@
+import * as Effect from "effect/Effect";
+import * as Layer from "effect/Layer";
+import * as ServiceMap from "effect/ServiceMap";
+import { ConfigError } from "@distilled.cloud/core/errors";
+
+export const DEFAULT_API_BASE_URL = "https://api.planetscale.com/v1";
+
+export interface Config {
+  readonly token: string;
+  readonly organization: string;
+  readonly apiBaseUrl: string;
+}
+
+export class Credentials extends ServiceMap.Service<Credentials, Config>()(
+  "PlanetScaleCredentials",
+) {}
+
+export const CredentialsFromEnv = Layer.effect(
+  Credentials,
+  Effect.gen(function* () {
+    const token = process.env.PLANETSCALE_API_TOKEN;
+    const organization = process.env.PLANETSCALE_ORGANIZATION;
+
+    if (!token) {
+      return yield* new ConfigError({
+        message: "PLANETSCALE_API_TOKEN environment variable is required",
+      });
+    }
+
+    if (!organization) {
+      return yield* new ConfigError({
+        message: "PLANETSCALE_ORGANIZATION environment variable is required",
+      });
+    }
+
+    return { token, organization, apiBaseUrl: DEFAULT_API_BASE_URL };
+  }),
+);

package/src/errors.ts

@@ -0,0 +1,52 @@
+/**
+ * PlanetScale-specific error types.
+ *
+ * Re-exports common HTTP errors from sdk-core and adds PlanetScale-specific
+ * error matching and API error types.
+ */
+export {
+  BadGateway,
+  BadRequest,
+  Conflict,
+  ConfigError,
+  Forbidden,
+  GatewayTimeout,
+  InternalServerError,
+  NotFound,
+  ServiceUnavailable,
+  TooManyRequests,
+  Unauthorized,
+  UnprocessableEntity,
+  HTTP_STATUS_MAP,
+  DEFAULT_ERRORS,
+  API_ERRORS,
+} from "@distilled.cloud/core/errors";
+export type { DefaultErrors } from "@distilled.cloud/core/errors";
+
+import * as Schema from "effect/Schema";
+import * as Category from "@distilled.cloud/core/category";
+
+/**
+ * PlanetScale API error code mapping.
+ * Maps API error response codes to HTTP error classes.
+ */
+export { HTTP_STATUS_MAP as ERROR_CODE_MAP } from "@distilled.cloud/core/errors";
+
+// Unknown PlanetScale error - returned when an error code is not recognized
+export class UnknownPlanetScaleError extends Schema.TaggedErrorClass<UnknownPlanetScaleError>()(
+  "UnknownPlanetScaleError",
+  {
+    code: Schema.optional(Schema.String),
+    message: Schema.optional(Schema.String),
+    body: Schema.Unknown,
+  },
+).pipe(Category.withServerError) {}
+
+// Schema parse error wrapper
+export class PlanetScaleParseError extends Schema.TaggedErrorClass<PlanetScaleParseError>()(
+  "PlanetScaleParseError",
+  {
+    body: Schema.Unknown,
+    cause: Schema.Unknown,
+  },
+).pipe(Category.withParseError) {}

package/src/index.ts

@@ -0,0 +1,15 @@
+/**
+ * PlanetScale SDK for Effect
+ *
+ * @example
+ * ```ts
+ * import * as PlanetScale from "@distilled.cloud/planetscale";
+ * ```
+ */
+export * from "./credentials.ts";
+export * as Category from "./category.ts";
+export * as T from "./traits.ts";
+export * as Retry from "./retry.ts";
+export { API } from "./client.ts";
+export * from "./errors.ts";
+export { SensitiveString, SensitiveNullableString } from "./sensitive.ts";