alchemy-s3-access 0.1.0-alpha.0

package/LICENSE

@@ -0,0 +1,17 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+Copyright 2026 alchemy-k3s contributors
+
+Licensed under the Apache License, Version 2.0 (the "License");
+you may not use this file except in compliance with the License.
+You may obtain a copy of the License at
+
+    http://www.apache.org/licenses/LICENSE-2.0
+
+Unless required by applicable law or agreed to in writing, software
+distributed under the License is distributed on an "AS IS" BASIS,
+WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+See the License for the specific language governing permissions and
+limitations under the License.

package/README.md

@@ -0,0 +1,22 @@
+# alchemy-s3-access
+
+A provider-neutral contract for passing scoped S3-compatible bucket access
+between Alchemy packages.
+
+```ts
+const access: S3BucketAccess = {
+  endpoint: "https://s3.example.com",
+  region: "eu-central-1",
+  bucket: "cluster-backups",
+  accessKeyId: "scoped-access-key",
+  secretAccessKey: Redacted.make(secret),
+};
+```
+
+The producing provider owns bucket lifecycle and issues a separate scoped
+credential per consumer. Consumers own prefixes and retention policy. This
+package owns neither and has no AWS, Cloudflare, Fly, Prisma, Hetzner, or
+Kubernetes dependency.
+
+Temporary credentials can include a Redacted `sessionToken`; MinIO and similar
+services can set `forcePathStyle`.

package/dist/index.d.mts

@@ -0,0 +1,14 @@
+import * as Redacted from "effect/Redacted";
+//#region src/index.d.ts
+/** Provider-issued access to exactly one S3-compatible bucket. */
+interface S3BucketAccess {
+  endpoint: string;
+  region: string;
+  bucket: string;
+  accessKeyId: string;
+  secretAccessKey: Redacted.Redacted<string>;
+  sessionToken?: Redacted.Redacted<string>;
+  forcePathStyle?: boolean;
+}
+//#endregion
+export { S3BucketAccess };

package/dist/index.mjs

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

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "alchemy-s3-access",
+  "version": "0.1.0-alpha.0",
+  "description": "Provider-neutral S3 access contract for Alchemy integrations",
+  "license": "Apache-2.0",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.mts",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "engines": {
+    "node": ">=22"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toolbar23/alchemy-k3s.git",
+    "directory": "packages/s3-access"
+  },
+  "homepage": "https://github.com/toolbar23/alchemy-k3s#readme",
+  "bugs": "https://github.com/toolbar23/alchemy-k3s/issues",
+  "keywords": [
+    "alchemy",
+    "s3",
+    "storage",
+    "iac"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "tsdown",
+    "prepack": "npm run build"
+  },
+  "peerDependencies": {
+    "effect": ">=4.0.0-rc.110 <5"
+  }
+}