@pgpm/services 0.16.0

package/LICENSE

@@ -0,0 +1,22 @@
+The MIT License (MIT)
+
+Copyright (c) 2025 Dan Lynch <pyramation@gmail.com>
+Copyright (c) 2025 Constructive
+
+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, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/__tests__/__snapshots__/services.test.ts.snap

@@ -0,0 +1,147 @@
+// Jest Snapshot v1, https://jestjs.io/docs/snapshot-testing
+
+exports[`services functionality should handle complete meta workflow with services 1`] = `
+{
+  "hash": null,
+  "id": "[ID]",
+  "label": null,
+  "name": "my-meta-db",
+  "owner_id": "[ID]",
+  "private_schema_name": null,
+  "schema_hash": null,
+  "schema_name": null,
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 2`] = `
+{
+  "anon_role": "anonymous",
+  "database_id": "[ID]",
+  "dbname": "test-database",
+  "id": "[ID]",
+  "is_public": true,
+  "name": "public",
+  "role_name": "authenticated",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 3`] = `
+{
+  "anon_role": "administrator",
+  "database_id": "[ID]",
+  "dbname": "test-database",
+  "id": "[ID]",
+  "is_public": true,
+  "name": "admin",
+  "role_name": "administrator",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 4`] = `
+{
+  "apple_touch_icon": null,
+  "database_id": "[ID]",
+  "dbname": "test-database",
+  "description": "Website Description",
+  "favicon": null,
+  "id": "[ID]",
+  "logo": null,
+  "og_image": null,
+  "title": "Website Title",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 5`] = `
+{
+  "api_id": "[ID]",
+  "database_id": "[ID]",
+  "domain": "pgpm.io",
+  "id": "[ID]",
+  "site_id": null,
+  "subdomain": "api",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 6`] = `
+{
+  "api_id": null,
+  "database_id": "[ID]",
+  "domain": "pgpm.io",
+  "id": "[ID]",
+  "site_id": "[ID]",
+  "subdomain": "app",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 7`] = `
+{
+  "api_id": "[ID]",
+  "database_id": "[ID]",
+  "domain": "pgpm.io",
+  "id": "[ID]",
+  "site_id": null,
+  "subdomain": "admin",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 8`] = `
+{
+  "data": {
+    "supportEmail": "support@interweb.co",
+  },
+  "database_id": "[ID]",
+  "id": "[ID]",
+  "name": "legal-emails",
+  "site_id": "[ID]",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 9`] = `
+{
+  "api_id": "[ID]",
+  "data": {
+    "authenticate": "authenticate",
+    "authenticate_schema": "services_private",
+  },
+  "database_id": "[ID]",
+  "id": "[ID]",
+  "name": "rls_module",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 10`] = `
+{
+  "data": {
+    "auth_schema": "services_public",
+    "forgot_password": "forgot_password",
+    "reset_password": "reset_password",
+    "send_verification_email": "send_verification_email",
+    "set_password": "set_password",
+    "sign_in": "login",
+    "sign_up": "register",
+    "verify_email": "verify_email",
+  },
+  "database_id": "[ID]",
+  "id": "[ID]",
+  "name": "user_auth_module",
+  "site_id": "[ID]",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 11`] = `
+{
+  "api_id": "[ID]",
+  "database_id": "[ID]",
+  "id": "[ID]",
+  "schema_id": "[ID]",
+}
+`;
+
+exports[`services functionality should handle complete meta workflow with services 12`] = `
+{
+  "api_id": "[ID]",
+  "database_id": "[ID]",
+  "id": "[ID]",
+  "schema_id": "[ID]",
+}
+`;

package/__tests__/services.test.ts

@@ -0,0 +1,210 @@
+import { getConnections, PgTestClient, snapshot } from 'pgsql-test';
+
+let pg: PgTestClient;
+let teardown: () => Promise<void>;
+
+describe('services functionality', () => {
+  beforeAll(async () => {
+    ({ pg, teardown } = await getConnections());
+  });
+
+  afterAll(async () => {
+    await teardown();
+  });
+
+  beforeEach(async () => {
+    await pg.beforeEach();
+    await pg.any(`GRANT EXECUTE ON ALL FUNCTIONS IN SCHEMA public TO public`);
+  });
+
+  afterEach(async () => {
+    await pg.afterEach();
+  });
+
+  it('should handle complete meta workflow with services', async () => {
+    const objs: Record<string, any> = {
+      tables: {},
+      domains: {},
+      apis: {},
+      sites: {}
+    };
+
+    const owner_id = '07281002-1699-4762-57e3-ab1b92243120';
+
+    const snap = (obj: any) => {
+      expect(snapshot(obj)).toMatchSnapshot();
+    };
+
+    const snapWithNormalizedDbname = (obj: any) => {
+      const normalized = {
+        ...obj,
+        dbname: 'test-database'
+      };
+      expect(snapshot(normalized)).toMatchSnapshot();
+    };
+
+    // Step 1: Create database
+    const [database] = await pg.any(
+      `INSERT INTO metaschema_public.database (owner_id, name) 
+       VALUES ($1, $2) 
+       RETURNING *`,
+      [owner_id, 'my-meta-db']
+    );
+    objs.db = database;
+    const database_id = database.id;
+    expect(snapshot(database)).toMatchSnapshot();
+
+    // Step 2: Create APIs first (since domains reference them)
+    const [publicApi] = await pg.any(
+      `INSERT INTO services_public.apis (database_id, name, role_name, anon_role) 
+       VALUES ($1, $2, $3, $4) 
+       RETURNING *`,
+      [database_id, 'public', 'authenticated', 'anonymous']
+    );
+    objs.apis.public = publicApi;
+    snapWithNormalizedDbname(publicApi);
+
+    const [adminApi] = await pg.any(
+      `INSERT INTO services_public.apis (database_id, name, role_name, anon_role) 
+       VALUES ($1, $2, $3, $4) 
+       RETURNING *`,
+      [database_id, 'admin', 'administrator', 'administrator']
+    );
+    objs.apis.admin = adminApi;
+    snapWithNormalizedDbname(adminApi);
+
+    // Step 3: Create sites
+    const [appSite] = await pg.any(
+      `INSERT INTO services_public.sites (database_id, title, description) 
+       VALUES ($1, $2, $3) 
+       RETURNING *`,
+      [database_id, 'Website Title', 'Website Description']
+    );
+    objs.sites.app = appSite;
+    snapWithNormalizedDbname(appSite);
+
+    // Step 4: Register domains (linking to APIs and sites)
+    const [apiDomain] = await pg.any(
+      `INSERT INTO services_public.domains (database_id, api_id, domain, subdomain) 
+       VALUES ($1, $2, $3, $4) 
+       RETURNING *`,
+      [database_id, objs.apis.public.id, 'pgpm.io', 'api']
+    );
+    objs.domains.api = apiDomain;
+    expect(snapshot(apiDomain)).toMatchSnapshot();
+
+    const [appDomain] = await pg.any(
+      `INSERT INTO services_public.domains (database_id, site_id, domain, subdomain) 
+       VALUES ($1, $2, $3, $4) 
+       RETURNING *`,
+      [database_id, objs.sites.app.id, 'pgpm.io', 'app']
+    );
+    objs.domains.app = appDomain;
+    expect(snapshot(appDomain)).toMatchSnapshot();
+
+    const [adminDomain] = await pg.any(
+      `INSERT INTO services_public.domains (database_id, api_id, domain, subdomain) 
+       VALUES ($1, $2, $3, $4) 
+       RETURNING *`,
+      [database_id, objs.apis.admin.id, 'pgpm.io', 'admin']
+    );
+    objs.domains.admin = adminDomain;
+    expect(snapshot(adminDomain)).toMatchSnapshot();
+
+    const [baseDomain] = await pg.any(
+      `INSERT INTO services_public.domains (database_id, domain) 
+       VALUES ($1, $2) 
+       RETURNING *`,
+      [database_id, 'pgpm.io']
+    );
+    objs.domains.base = baseDomain;
+
+    // Step 5: Register modules
+    const [siteModule1] = await pg.any(
+      `INSERT INTO services_public.site_modules (database_id, site_id, name, data) 
+       VALUES ($1, $2, $3, $4::jsonb) 
+       RETURNING *`,
+      [database_id, objs.sites.app.id, 'legal-emails', JSON.stringify({
+        supportEmail: 'support@interweb.co'
+      })]
+    );
+    expect(snapshot(siteModule1)).toMatchSnapshot();
+
+    const [apiModule] = await pg.any(
+      `INSERT INTO services_public.api_modules (database_id, api_id, name, data) 
+       VALUES ($1, $2, $3, $4::jsonb) 
+       RETURNING *`,
+      [database_id, objs.apis.public.id, 'rls_module', JSON.stringify({
+        authenticate_schema: 'services_private',
+        authenticate: 'authenticate'
+      })]
+    );
+    expect(snapshot(apiModule)).toMatchSnapshot();
+
+    const [siteModule2] = await pg.any(
+      `INSERT INTO services_public.site_modules (database_id, site_id, name, data) 
+       VALUES ($1, $2, $3, $4::jsonb) 
+       RETURNING *`,
+      [database_id, objs.sites.app.id, 'user_auth_module', JSON.stringify({
+        auth_schema: 'services_public',
+        sign_in: 'login',
+        sign_up: 'register',
+        set_password: 'set_password',
+        reset_password: 'reset_password',
+        forgot_password: 'forgot_password',
+        send_verification_email: 'send_verification_email',
+        verify_email: 'verify_email'
+      })]
+    );
+    expect(snapshot(siteModule2)).toMatchSnapshot();
+
+    // Step 6: Schema associations
+    const [schema] = await pg.any(
+      `INSERT INTO metaschema_public.schema (database_id, schema_name, name) 
+       VALUES ($1, $2, $3) 
+       RETURNING *`,
+      [database_id, 'brand-public', 'public']
+    );
+
+    const [publicAssoc] = await pg.any(
+      `INSERT INTO services_public.api_schemata (database_id, schema_id, api_id) 
+       VALUES ($1, $2, $3) 
+       RETURNING *`,
+      [database_id, schema.id, objs.apis.public.id]
+    );
+    
+    const [adminAssoc] = await pg.any(
+      `INSERT INTO services_public.api_schemata (database_id, schema_id, api_id) 
+       VALUES ($1, $2, $3) 
+       RETURNING *`,
+      [database_id, schema.id, objs.apis.admin.id]
+    );
+    
+    snap(publicAssoc);
+    snap(adminAssoc);
+  });
+
+  it('should register domain independently', async () => {
+    const owner_id = '07281002-1699-4762-57e3-ab1b92243120';
+    
+    // Create database first
+    const [database] = await pg.any(
+      `INSERT INTO metaschema_public.database (owner_id, name) 
+       VALUES ($1, $2) 
+       RETURNING *`,
+      [owner_id, 'test-db-for-domain']
+    );
+    
+    // Then create domain
+    const [domain] = await pg.any(
+      `INSERT INTO services_public.domains (database_id, domain, subdomain) 
+       VALUES ($1, $2, $3) 
+       RETURNING *`,
+      [database.id, 'example.com', 'api']
+    );
+    
+    expect(domain.database_id).toBe(database.id);
+    expect(domain.domain).toBe('example.com');
+    expect(domain.subdomain).toBe('api');
+  });
+});

package/deploy/schemas/services_private/schema.sql

@@ -0,0 +1,14 @@
+-- Deploy schemas/services_private/schema to pg
+
+
+BEGIN;
+
+CREATE SCHEMA services_private;
+
+GRANT USAGE ON SCHEMA services_private TO authenticated;
+GRANT USAGE ON SCHEMA services_private TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA services_private GRANT ALL ON TABLES TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA services_private GRANT ALL ON SEQUENCES TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA services_private GRANT ALL ON FUNCTIONS TO administrator;
+
+COMMIT;

package/deploy/schemas/services_public/schema.sql

@@ -0,0 +1,15 @@
+-- Deploy schemas/services_public/schema to pg
+
+
+BEGIN;
+
+CREATE SCHEMA services_public;
+
+GRANT USAGE ON SCHEMA services_public TO authenticated;
+GRANT USAGE ON SCHEMA services_public TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA services_public GRANT ALL ON TABLES TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA services_public GRANT ALL ON SEQUENCES TO administrator;
+ALTER DEFAULT PRIVILEGES IN SCHEMA services_public GRANT ALL ON FUNCTIONS TO administrator;
+
+
+COMMIT;

package/deploy/schemas/services_public/tables/api_extensions/table.sql

@@ -0,0 +1,36 @@
+-- Deploy schemas/services_public/tables/api_extensions/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/apis/table 
+
+-- requires: schemas/metaschema_public/tables/database_extension/table 
+-- requires: schemas/metaschema_public/tables/extension/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+
+BEGIN;
+
+-- NOTE: not directly mapping to extensions on purpose, to make it simple for api usage
+
+CREATE TABLE services_public.api_extensions (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    schema_name text,
+    database_id uuid NOT NULL,
+    api_id uuid NOT NULL,
+
+    --
+
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+    CONSTRAINT api_fkey FOREIGN KEY (api_id) REFERENCES services_public.apis (id) ON DELETE CASCADE,
+
+    UNIQUE (schema_name, api_id)
+);
+
+-- WE DO WANT m2m!
+-- COMMENT ON CONSTRAINT db_fkey ON services_public.api_extensions IS E'@omit manyToMany';
+-- COMMENT ON CONSTRAINT api_fkey ON services_public.api_extensions IS E'@omit manyToMany';
+
+CREATE INDEX api_extension_database_id_idx ON services_public.api_extensions ( database_id );
+CREATE INDEX api_extension_api_id_idx ON services_public.api_extensions ( api_id );
+
+COMMIT;

package/deploy/schemas/services_public/tables/api_modules/table.sql

@@ -0,0 +1,30 @@
+-- Deploy schemas/services_public/tables/api_modules/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/apis/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.api_modules (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    api_id uuid NOT NULL,
+    name text NOT NULL,
+    data json NOT NULL,
+
+    --
+
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE
+
+);
+
+ALTER TABLE services_public.api_modules ADD CONSTRAINT api_modules_api_id_fkey FOREIGN KEY ( api_id ) REFERENCES services_public.apis ( id );
+COMMENT ON CONSTRAINT api_modules_api_id_fkey ON services_public.api_modules IS E'@omit manyToMany';
+CREATE INDEX api_modules_api_id_idx ON services_public.api_modules ( api_id );
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.api_modules IS E'@omit manyToMany';
+CREATE INDEX api_modules_database_id_idx ON services_public.api_modules ( database_id );
+
+
+COMMIT;

package/deploy/schemas/services_public/tables/api_schemata/table.sql

@@ -0,0 +1,30 @@
+-- Deploy schemas/services_public/tables/api_schemata/table to pg
+
+-- requires: schemas/services_public/schema
+
+BEGIN;
+
+CREATE TABLE services_public.api_schemata (
+  id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+  database_id uuid NOT NULL,
+  schema_id uuid NOT NULL,
+  api_id uuid NOT NULL,
+  
+  --
+
+  CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+  CONSTRAINT schema_fkey FOREIGN KEY (schema_id) REFERENCES metaschema_public.schema (id) ON DELETE CASCADE,
+  CONSTRAINT api_fkey FOREIGN KEY (api_id) REFERENCES services_public.apis (id) ON DELETE CASCADE,
+  unique(api_id, schema_id)
+);
+
+-- COMMENT ON CONSTRAINT schema_fkey ON services_public.api_schemata IS E'@omit manyToMany';
+-- COMMENT ON CONSTRAINT api_fkey ON services_public.api_schemata IS E'@omit manyToMany';
+COMMENT ON CONSTRAINT db_fkey ON services_public.api_schemata IS E'@omit manyToMany';
+
+
+CREATE INDEX api_schemata_database_id_idx ON services_public.api_schemata ( database_id );
+CREATE INDEX api_schemata_schema_id_idx ON services_public.api_schemata ( schema_id );
+CREATE INDEX api_schemata_api_id_idx ON services_public.api_schemata ( api_id );
+
+COMMIT;

package/deploy/schemas/services_public/tables/apis/table.sql

@@ -0,0 +1,26 @@
+-- Deploy schemas/services_public/tables/apis/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.apis (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    name text NOT NULL,
+    dbname text NOT NULL DEFAULT current_database(),
+    role_name text NOT NULL DEFAULT 'authenticated',
+    anon_role text NOT NULL DEFAULT 'anonymous',
+    is_public boolean NOT NULL DEFAULT true,
+
+    --
+
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+    UNIQUE(database_id, name)
+);
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.apis IS E'@omit manyToMany';
+CREATE INDEX apis_database_id_idx ON services_public.apis ( database_id );
+
+COMMIT;

package/deploy/schemas/services_public/tables/apps/table.sql

@@ -0,0 +1,34 @@
+-- Deploy schemas/services_public/tables/apps/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/sites/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.apps (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    site_id uuid NOT NULL,
+    name text,
+    app_image image,
+    app_store_link url,
+    app_store_id text,
+    app_id_prefix text,
+    play_store_link url,
+
+    --
+
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+    UNIQUE ( site_id )
+);
+
+ALTER TABLE services_public.apps ADD CONSTRAINT apps_site_id_fkey FOREIGN KEY ( site_id ) REFERENCES services_public.sites ( id );
+COMMENT ON CONSTRAINT apps_site_id_fkey ON services_public.apps IS E'@omit manyToMany';
+CREATE INDEX apps_site_id_idx ON services_public.apps ( site_id );
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.apps IS E'@omit manyToMany';
+CREATE INDEX apps_database_id_idx ON services_public.apps ( database_id );
+
+
+COMMIT;

package/deploy/schemas/services_public/tables/domains/table.sql

@@ -0,0 +1,41 @@
+-- Deploy schemas/services_public/tables/domains/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/apis/table 
+-- requires: schemas/services_public/tables/sites/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.domains (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    
+    api_id uuid,
+    site_id uuid,
+
+    subdomain hostname,
+    domain hostname,
+
+    --
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+    CONSTRAINT api_fkey FOREIGN KEY (api_id) REFERENCES services_public.apis (id) ON DELETE CASCADE,
+    CONSTRAINT site_fkey FOREIGN KEY (site_id) REFERENCES services_public.sites (id) ON DELETE CASCADE,
+    CONSTRAINT one_route_chk CHECK (
+        (api_id IS NULL AND site_id IS NULL) OR
+        (api_id IS NULL AND site_id IS NOT NULL) OR
+        (api_id IS NOT NULL AND site_id IS NULL)
+    ),
+    UNIQUE ( subdomain, domain )
+);
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.domains IS E'@omit manyToMany';
+CREATE INDEX domains_database_id_idx ON services_public.domains ( database_id );
+
+COMMENT ON CONSTRAINT api_fkey ON services_public.domains IS E'@omit manyToMany';
+CREATE INDEX domains_api_id_idx ON services_public.domains ( api_id );
+
+COMMENT ON CONSTRAINT site_fkey ON services_public.domains IS E'@omit manyToMany';
+CREATE INDEX domains_site_id_idx ON services_public.domains ( site_id );
+
+COMMIT;

package/deploy/schemas/services_public/tables/site_metadata/table.sql

@@ -0,0 +1,33 @@
+-- Deploy schemas/services_public/tables/site_metadata/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/sites/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.site_metadata (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    site_id uuid NOT NULL,
+    title text,
+    description text,
+    og_image image,
+
+    --
+
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+
+    CHECK ( character_length(title) <= 120 ),
+    CHECK ( character_length(description) <= 120 )
+);
+
+
+ALTER TABLE services_public.site_metadata ADD CONSTRAINT site_metadata_site_id_fkey FOREIGN KEY ( site_id ) REFERENCES services_public.sites ( id );
+COMMENT ON CONSTRAINT site_metadata_site_id_fkey ON services_public.site_metadata IS E'@omit manyToMany';
+CREATE INDEX site_metadata_site_id_idx ON services_public.site_metadata ( site_id );
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.site_metadata IS E'@omit manyToMany';
+CREATE INDEX site_metadata_database_id_idx ON services_public.site_metadata ( database_id );
+
+COMMIT;

package/deploy/schemas/services_public/tables/site_modules/table.sql

@@ -0,0 +1,28 @@
+-- Deploy schemas/services_public/tables/site_modules/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/sites/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.site_modules (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    site_id uuid NOT NULL,
+    name text NOT NULL,
+    data json NOT NULL,
+
+    --
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE
+);
+
+ALTER TABLE services_public.site_modules ADD CONSTRAINT site_modules_site_id_fkey FOREIGN KEY ( site_id ) REFERENCES services_public.sites ( id );
+COMMENT ON CONSTRAINT site_modules_site_id_fkey ON services_public.site_modules IS E'@omit manyToMany';
+CREATE INDEX site_modules_site_id_idx ON services_public.site_modules ( site_id );
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.site_modules IS E'@omit manyToMany';
+CREATE INDEX site_modules_database_id_idx ON services_public.site_modules ( database_id );
+
+
+COMMIT;

package/deploy/schemas/services_public/tables/site_themes/table.sql

@@ -0,0 +1,27 @@
+-- Deploy schemas/services_public/tables/site_themes/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/services_public/tables/sites/table 
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.site_themes (
+    id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+    database_id uuid NOT NULL,
+    site_id uuid NOT NULL,
+    theme jsonb NOT NULL,
+
+    --
+
+    CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE
+);
+
+ALTER TABLE services_public.site_themes ADD CONSTRAINT site_themes_site_id_fkey FOREIGN KEY ( site_id ) REFERENCES services_public.sites ( id );
+COMMENT ON CONSTRAINT site_themes_site_id_fkey ON services_public.site_themes IS E'@omit manyToMany';
+CREATE INDEX site_themes_site_id_idx ON services_public.site_themes ( site_id );
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.site_themes IS E'@omit manyToMany';
+CREATE INDEX site_themes_database_id_idx ON services_public.site_themes ( database_id );
+
+COMMIT;

package/deploy/schemas/services_public/tables/sites/table.sql

@@ -0,0 +1,30 @@
+-- Deploy schemas/services_public/tables/sites/table to pg
+
+-- requires: schemas/services_public/schema
+-- requires: schemas/metaschema_public/tables/database/table 
+
+BEGIN;
+
+CREATE TABLE services_public.sites (
+  id uuid PRIMARY KEY DEFAULT uuid_generate_v4 (),
+  database_id uuid NOT NULL,
+  title text,
+  description text,
+  og_image image,
+  favicon attachment,
+  apple_touch_icon image,
+  logo image,
+  
+  -- do we need this?
+  dbname text NOT NULL DEFAULT current_database(),
+
+  --
+  CONSTRAINT db_fkey FOREIGN KEY (database_id) REFERENCES metaschema_public.database (id) ON DELETE CASCADE,
+  CONSTRAINT max_title CHECK ( character_length(title) <= 120 ),
+  CONSTRAINT max_descr CHECK ( character_length(description) <= 120 )
+);
+
+COMMENT ON CONSTRAINT db_fkey ON services_public.sites IS E'@omit manyToMany';
+CREATE INDEX sites_database_id_idx ON services_public.sites ( database_id );
+
+COMMIT;

package/jest.config.js

@@ -0,0 +1,15 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+
+  // Match both __tests__ and colocated test files
+  testMatch: ['**/?(*.)+(test|spec).{ts,tsx,js,jsx}'],
+
+  // Ignore build artifacts and type declarations
+  testPathIgnorePatterns: ['/dist/', '\\.d\\.ts$'],
+  modulePathIgnorePatterns: ['<rootDir>/dist/'],
+  watchPathIgnorePatterns: ['/dist/'],
+
+  moduleFileExtensions: ['ts', 'tsx', 'js', 'jsx', 'json', 'node'],
+};

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@pgpm/services",
+  "version": "0.16.0",
+  "description": "Services schemas for module registration and service configuration",
+  "author": "Dan Lynch <pyramation@gmail.com>",
+  "contributors": [
+    "Constructive <developers@constructive.io>"
+  ],
+  "keywords": [
+    "postgresql",
+    "pgpm",
+    "services",
+    "modules"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "bundle": "pgpm package",
+    "test": "jest",
+    "test:watch": "jest --watch"
+  },
+  "dependencies": {
+    "@pgpm/metaschema-schema": "0.16.0",
+    "@pgpm/verify": "0.16.0"
+  },
+  "devDependencies": {
+    "pgpm": "^1.3.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/constructive-io/constructive-db"
+  },
+  "homepage": "https://github.com/constructive-io/constructive-db",
+  "bugs": {
+    "url": "https://github.com/constructive-io/constructive-db/issues"
+  },
+  "gitHead": "3b2260bf7640d7194f237d556c7e5033bc7a9405"
+}

package/pgpm.plan

@@ -0,0 +1,16 @@
+%syntax-version=1.0.0
+%project=services
+%uri=services
+  
+schemas/services_private/schema 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_private/schema
+schemas/services_public/schema 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/schema
+schemas/services_public/tables/apis/table [schemas/services_public/schema metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/apis/table
+schemas/services_public/tables/api_extensions/table [schemas/services_public/schema schemas/services_public/tables/apis/table metaschema-schema:schemas/metaschema_public/tables/database_extension/table metaschema-schema:schemas/metaschema_public/tables/extension/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/api_extensions/table
+schemas/services_public/tables/api_modules/table [schemas/services_public/schema schemas/services_public/tables/apis/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/api_modules/table
+schemas/services_public/tables/api_schemata/table [schemas/services_public/schema] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/api_schemata/table
+schemas/services_public/tables/sites/table [schemas/services_public/schema metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/sites/table
+schemas/services_public/tables/apps/table [schemas/services_public/schema schemas/services_public/tables/sites/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/apps/table
+schemas/services_public/tables/domains/table [schemas/services_public/schema schemas/services_public/tables/apis/table schemas/services_public/tables/sites/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/domains/table
+schemas/services_public/tables/site_metadata/table [schemas/services_public/schema schemas/services_public/tables/sites/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/site_metadata/table
+schemas/services_public/tables/site_modules/table [schemas/services_public/schema schemas/services_public/tables/sites/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/site_modules/table
+schemas/services_public/tables/site_themes/table [schemas/services_public/schema schemas/services_public/tables/sites/table metaschema-schema:schemas/metaschema_public/tables/database/table] 2017-08-11T08:11:51Z skitch <skitch@5b0c196eeb62> # add schemas/services_public/tables/site_themes/table

package/revert/schemas/services_private/schema.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_private/schema from pg
+
+BEGIN;
+
+DROP SCHEMA services_private;
+
+COMMIT;

package/revert/schemas/services_public/schema.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/schema from pg
+
+BEGIN;
+
+DROP SCHEMA services_public;
+
+COMMIT;

package/revert/schemas/services_public/tables/api_extensions/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/api_extensions/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.api_extensions;
+
+COMMIT;

package/revert/schemas/services_public/tables/api_modules/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/api_modules/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.api_modules;
+
+COMMIT;

package/revert/schemas/services_public/tables/api_schemata/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/api_schemata/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.api_schemata;
+
+COMMIT;

package/revert/schemas/services_public/tables/apis/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/apis/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.apis;
+
+COMMIT;

package/revert/schemas/services_public/tables/apps/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/apps/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.apps;
+
+COMMIT;

package/revert/schemas/services_public/tables/domains/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/domains/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.domains;
+
+COMMIT;

package/revert/schemas/services_public/tables/site_metadata/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/site_metadata/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.site_metadata;
+
+COMMIT;

package/revert/schemas/services_public/tables/site_modules/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/site_modules/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.site_modules;
+
+COMMIT;

package/revert/schemas/services_public/tables/site_themes/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/site_themes/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.site_themes;
+
+COMMIT;

package/revert/schemas/services_public/tables/sites/table.sql

@@ -0,0 +1,7 @@
+-- Revert schemas/services_public/tables/sites/table from pg
+
+BEGIN;
+
+DROP TABLE services_public.sites;
+
+COMMIT;

package/services.control

@@ -0,0 +1,7 @@
+# services extension
+comment = 'services extension - schemas for module registration and service configuration'
+default_version = '0.1.0'
+module_pathname = '$libdir/services'
+requires = 'plpgsql,metaschema-schema,pgpm-verify'
+relocatable = false
+superuser = false