@better-media/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 abenezeratnafu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS
+ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,39 @@
+# @better-media/core
+
+Core interfaces and types for the Better Media framework.
+
+## Overview
+
+This package defines the contracts that all adapters and plugins must implement. It has **zero dependencies** and provides the type definitions for:
+
+- **StorageAdapter**: Handles file read/write operations (S3, Filesystem, Memory).
+- **DatabaseAdapter**: Handles metadata persistence and retrieval.
+- **JobAdapter**: Handles background execution of pipeline tasks.
+- **PipelinePlugin**: Defines hooks and logic for media processing, validation, etc.
+- **PipelineContext**: The data structure passed through the pipeline.
+
+## Usage
+
+You typically only need this package if you are:
+
+1. **Building a custom adapter**: Implement `StorageAdapter`, `DatabaseAdapter`, or `JobAdapter`.
+2. **Building a custom plugin**: Implement the `PipelinePlugin` interface.
+3. **Type-checking your configuration**: Import types for your `BetterMediaConfig`.
+
+```ts
+import type { StorageAdapter, PipelinePlugin } from "@better-media/core";
+
+// Example: Minimal custom plugin
+export const myPlugin: PipelinePlugin = {
+  name: "my-plugin",
+  hooks: {
+    afterUpload: async (context) => {
+      console.log("File uploaded:", context.file.key);
+    },
+  },
+};
+```
+
+## Documentation
+
+For full documentation, visit [better-media.dev](https://better-media.dev/docs/core).