Skill: Create Service

Name: create-service
Rating: 87
Author: devitools

Generate the application service for a Ybyra domain entity.

What This Skill Creates

code

src/application/{domain}/
  {domain}Service.ts   ← ServiceContract implementation

Template

ts-no-check

import { createService } from "@ybyra/core";
import type { PersistenceContract } from "@ybyra/core";
import { {Domain}Schema } from "../../domain/{domain}";

export function create{Domain}Service(driver: PersistenceContract) {
  return {
    ...createService({Domain}Schema, driver),
    // Custom methods beyond CRUD:
    // async customMethod(param: string) { ... }
  };
}

Rules

•createService(Schema, driver) provides standard CRUD: list, find, create, update, remove
•The driver parameter is a PersistenceContract — the actual storage backend
•Spread createService() to inherit all CRUD, then add custom methods
•Factory pattern: the function receives the driver and returns the service object

Driver Setup by Platform

Web (localStorage)

ts-no-check

import { createWebDriver } from "@ybyra/persistence/web";
const driver = createWebDriver();

React Native (SQLite)

ts-no-check

import { createLocalDriver } from "@ybyra/persistence";
const driver = createLocalDriver();

API (custom)

ts-no-check

import type { PersistenceContract } from "@ybyra/core";

const driver: PersistenceContract = {
  async list(domain, options) { /* fetch from API */ },
  async find(domain, id) { /* GET /api/{domain}/{id} */ },
  async create(domain, data) { /* POST /api/{domain} */ },
  async update(domain, id, data) { /* PUT /api/{domain}/{id} */ },
  async remove(domain, id) { /* DELETE /api/{domain}/{id} */ },
};

Setup File Pattern

Each application creates a setup file that wires service → handlers → hooks:

ts-no-check

// src/setup.ts or src/demo.ts
import { createWebDriver } from "@ybyra/persistence/web";
import { create{Domain}Service } from "./application/{domain}/{domain}Service";
import { create{Domain}Handlers } from "./domain/{domain}";
import { create{Domain}Hooks } from "./domain/{domain}";

const driver = createWebDriver();
export const {domain}Service = create{Domain}Service(driver);
export const {domain}Handlers = create{Domain}Handlers({domain}Service);
export const {domain}Hooks = create{Domain}Hooks({domain}Service);