@owlmeans/resource 0.1.6 → 0.1.8

package/README.md

@@ -92,3 +92,20 @@ interface ResourceMaker<R extends ResourceRecord, T extends Resource<R> = Resour
 - [`@owlmeans/mongo-resource`](../mongo-resource) — MongoDB implementation
 - [`@owlmeans/redis-resource`](../redis-resource) — Redis implementation
 - [`@owlmeans/state`](../state) — in-memory implementation for client state
+
+<!-- owlmeans:agent-guidance:start -->
+## Agent guidance
+
+This package ships embedded Claude Code skills and GitHub Copilot instructions under
+`agent-meta/`. After installing your `@owlmeans/*` packages, run the OwlMeans
+agent-skills installer to place them into your project's native locations
+(`.claude/skills/` and `.github/instructions/`):
+
+```sh
+npx @owlmeans/agent-skills
+```
+
+The embedded files are version-matched to this package release. Do not edit them
+directly — they are regenerated on each publish. To contribute guidance edits,
+open a PR against the source monorepo.
+<!-- owlmeans:agent-guidance:end -->

package/agent-meta/instructions/resource.instructions.md

@@ -0,0 +1,33 @@
+---
+description: "How to use @owlmeans/resource — generic resource abstraction (CRUD over a collection of records) used by mongo-resource, redis-resource, state, storage-resource. Use when implementing a custom resource."
+applyTo: "**/*.ts, **/*.tsx"
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/resource
+
+**Layer:** Core
+**Install:** `"@owlmeans/resource": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `Resource<T>` types | Generic resource interface (get/list/create/update/delete) |
+| Errors | Typed resource errors (NotFound, AlreadyExists, etc.) |
+| Constants | Default resource aliases |
+| Service helpers | Wrap a resource as a context service |
+
+## Usage
+
+```typescript
+import type { Resource } from '@owlmeans/resource'
+
+interface Project { id: string; name: string; entityId: string }
+const projects = ctx.getResource<Resource<Project>>('projects')
+const { items } = await projects.list({ entityId: 'abc' })
+```
+
+## Depends On
+
+- `@owlmeans/error`, `@owlmeans/i18n`

package/agent-meta/manifest.json

@@ -0,0 +1,23 @@
+{
+  "schemaVersion": 1,
+  "package": "@owlmeans/resource",
+  "version": "0.1.8",
+  "generatedAt": "2026-06-11T16:30:27.164Z",
+  "canonicalRepo": "https://github.com/owlmeans/common",
+  "entries": [
+    {
+      "kind": "skill",
+      "name": "resource",
+      "category": "package-specific",
+      "file": "skills/resource/SKILL.md",
+      "canonicalPath": ".claude/skills/resource/SKILL.md"
+    },
+    {
+      "kind": "instruction",
+      "name": "resource",
+      "category": "package-specific",
+      "file": "instructions/resource.instructions.md",
+      "canonicalPath": ".github/instructions/resource.instructions.md"
+    }
+  ]
+}

package/agent-meta/skills/resource/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: resource
+description: How to use @owlmeans/resource — generic resource abstraction (CRUD over a collection of records) used by mongo-resource, redis-resource, state, storage-resource, etc. Auto-invoked when importing from this package or implementing a custom resource type.
+user-invocable: false
+---
+<!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
+
+# @owlmeans/resource
+
+**Layer:** Core
+**Install:** `"@owlmeans/resource": "^0.1.8"` in `dependencies`
+
+## Key Exports
+
+| Export | Description |
+|--------|-------------|
+| `Resource<T>` types | Generic resource interface (get/list/create/update/delete) |
+| Errors | Typed resource errors (NotFound, AlreadyExists, etc.) |
+| Constants | Default resource aliases, operation names |
+| Service helpers | Wrap a resource as a context service |
+
+## Usage
+
+A resource is a typed CRUD-over-records abstraction. Concrete implementations come from `@owlmeans/mongo-resource`, `@owlmeans/redis-resource`, `@owlmeans/state`, etc. Consumers register a resource with the context and access it via `ctx.getResource<T>(alias)`.
+
+```typescript
+import type { Resource } from '@owlmeans/resource'
+
+interface Project { id: string; name: string; entityId: string }
+const projects = ctx.getResource<Resource<Project>>('projects')
+const { items } = await projects.list({ entityId: 'abc' })
+```
+
+## Depends On
+
+- `@owlmeans/error` — for typed errors
+- `@owlmeans/i18n` — error messages

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/resource",
-  "version": "0.1.6",
+  "version": "0.1.8",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -22,8 +22,8 @@
   },
   "dependencies": {
     "@noble/hashes": "^1.5.0",
-    "@owlmeans/context": "^0.1.6",
-    "@owlmeans/error": "^0.1.6",
+    "@owlmeans/context": "^0.1.8",
+    "@owlmeans/error": "^0.1.8",
     "@scure/base": "^1.1.9"
   },
   "peerDependencies": {