@hackfed/schemas 0.0.5 → 0.2.0

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview Stub file to make TypeScript recognize this as a module.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,4 @@
+/**
+ * @fileoverview Stub file to make TypeScript recognize this as a module.
+ */
+/* eslint-disable-next-line unicorn/no-empty-file -- stub */

package/dist/v1/base/inet6-number.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const Inet6NumberSchema: z.ZodString;
+export type Inet6Number = z.infer<typeof Inet6NumberSchema>;
+export declare const __schemas: z.ZodString[];

package/dist/v1/base/inet6-number.js

@@ -0,0 +1,11 @@
+import { z } from 'zod';
+export const Inet6NumberSchema = z
+    .string()
+    .regex(/^(((?:[0-9A-Fa-f]{1,4}))*((?::[0-9A-Fa-f]{1,4}))*::((?:[0-9A-Fa-f]{1,4}))*((?::[0-9A-Fa-f]{1,4}))*|((?:[0-9A-Fa-f]{1,4}))((?::[0-9A-Fa-f]{1,4})){7})(\/([1-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8])){0,1}$/)
+    .meta({
+    description: 'An IPv6 address in standard notation',
+    examples: ['fd79:7636:1f08:883d::008', '2001:db8::1', '::1', 'fe80::1/128'],
+    id: 'Inet6Number',
+    title: 'IPv6 Address',
+});
+export const __schemas = [Inet6NumberSchema];

package/dist/v1/base/organization-id.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const OrganizationIdSchema: z.ZodString;
+export type OrganizationId = z.infer<typeof OrganizationIdSchema>;
+export declare const __schemas: z.ZodString[];

package/dist/v1/base/organization-id.js

@@ -0,0 +1,13 @@
+import { z } from 'zod';
+export const OrganizationIdSchema = z
+    .string()
+    .regex(/^[a-z0-9]*$/)
+    .min(4)
+    .max(16)
+    .meta({
+    description: 'A unique identifier for an organization in the Hackfed registry',
+    examples: ['bksp', 'xkem'],
+    id: 'OrganizationId',
+    title: 'Organization ID',
+});
+export const __schemas = [OrganizationIdSchema];

package/dist/v1/base/resource-definition.d.ts

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+export declare const ResourceDefinitionSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    apiVersion: z.ZodLiteral<"hackfed/v1">;
+    kind: z.ZodLiteral<"Organization">;
+    metadata: z.ZodObject<{
+        orgId: z.ZodString;
+    }, z.core.$strip>;
+    spec: z.ZodObject<{}, z.core.$strip>;
+}, z.core.$strip>;
+export type ResourceDefinition = z.infer<typeof ResourceDefinitionSchema>;
+export declare const __schemas: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    apiVersion: z.ZodLiteral<"hackfed/v1">;
+    kind: z.ZodLiteral<"Organization">;
+    metadata: z.ZodObject<{
+        orgId: z.ZodString;
+    }, z.core.$strip>;
+    spec: z.ZodObject<{}, z.core.$strip>;
+}, z.core.$strip>[];

package/dist/v1/base/resource-definition.js

@@ -0,0 +1,20 @@
+import { z } from 'zod';
+import { OrganizationIdSchema } from './organization-id';
+export const ResourceDefinitionSchema = z
+    .object({
+    $schema: z.url().optional().describe('URL of the schema definition'),
+    apiVersion: z.literal('hackfed/v1').describe('API version identifier'),
+    kind: z.literal('Organization').describe('Resource type'),
+    metadata: z
+        .object({
+        orgId: OrganizationIdSchema.describe('Identifier of the organization owning this resource'),
+    })
+        .describe('Metadata about the organization'),
+    spec: z.object(),
+})
+    .meta({
+    description: 'Base schema for Hackfed resource definitions',
+    id: 'ResourceDefinition',
+    title: 'Resource Definition',
+});
+export const __schemas = [ResourceDefinitionSchema];

package/dist/v1/directory/telephony.d.ts

@@ -0,0 +1,72 @@
+import { z } from 'zod';
+export declare const DirectoryExchangeSchema: z.ZodObject<{
+    codecs: z.ZodArray<z.ZodEnum<{
+        opus: "opus";
+        g722: "g722";
+        ulaw: "ulaw";
+    }>>;
+    endpoint: z.ZodString;
+    id: z.ZodString;
+    prefixes: z.ZodArray<z.ZodE164>;
+    protocol: z.ZodEnum<{
+        iax2: "iax2";
+    }>;
+}, z.core.$strict>;
+export declare const DirectoryOrgSchema: z.ZodObject<{
+    exchanges: z.ZodArray<z.ZodObject<{
+        codecs: z.ZodArray<z.ZodEnum<{
+            opus: "opus";
+            g722: "g722";
+            ulaw: "ulaw";
+        }>>;
+        endpoint: z.ZodString;
+        id: z.ZodString;
+        prefixes: z.ZodArray<z.ZodE164>;
+        protocol: z.ZodEnum<{
+            iax2: "iax2";
+        }>;
+    }, z.core.$strict>>;
+    name: z.ZodString;
+    orgId: z.ZodString;
+}, z.core.$strict>;
+export declare const TelephonyDirectorySchema: z.ZodObject<{
+    orgs: z.ZodArray<z.ZodObject<{
+        exchanges: z.ZodArray<z.ZodObject<{
+            codecs: z.ZodArray<z.ZodEnum<{
+                opus: "opus";
+                g722: "g722";
+                ulaw: "ulaw";
+            }>>;
+            endpoint: z.ZodString;
+            id: z.ZodString;
+            prefixes: z.ZodArray<z.ZodE164>;
+            protocol: z.ZodEnum<{
+                iax2: "iax2";
+            }>;
+        }, z.core.$strict>>;
+        name: z.ZodString;
+        orgId: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strip>;
+export type TelephonyDirectory = z.infer<typeof TelephonyDirectorySchema>;
+export type DirectoryOrg = z.infer<typeof DirectoryOrgSchema>;
+export type DirectoryExchange = z.infer<typeof DirectoryExchangeSchema>;
+export declare const __schemas: z.ZodObject<{
+    orgs: z.ZodArray<z.ZodObject<{
+        exchanges: z.ZodArray<z.ZodObject<{
+            codecs: z.ZodArray<z.ZodEnum<{
+                opus: "opus";
+                g722: "g722";
+                ulaw: "ulaw";
+            }>>;
+            endpoint: z.ZodString;
+            id: z.ZodString;
+            prefixes: z.ZodArray<z.ZodE164>;
+            protocol: z.ZodEnum<{
+                iax2: "iax2";
+            }>;
+        }, z.core.$strict>>;
+        name: z.ZodString;
+        orgId: z.ZodString;
+    }, z.core.$strict>>;
+}, z.core.$strip>[];

package/dist/v1/directory/telephony.js

@@ -0,0 +1,39 @@
+import { z } from 'zod';
+import { OrganizationIdSchema } from '../base/organization-id';
+export const DirectoryExchangeSchema = z
+    .object({
+    codecs: z
+        .array(z.enum(['opus', 'g722', 'ulaw']))
+        .min(1)
+        .describe('Supported audio codecs'),
+    endpoint: z
+        .string()
+        .describe('Network address and port of the exchange (e.g., [IPv6]:port or IPv4:port)'),
+    id: z.string().describe('Unique exchange identifier within the organization'),
+    prefixes: z
+        .array(z.e164().describe('Telephony number prefix (e.g., country or area code)'))
+        .describe('Telephony number prefixes allocated to the organization for this exchange'),
+    protocol: z.enum(['iax2']).describe('Telephony protocol used by the exchange'),
+})
+    .strict();
+export const DirectoryOrgSchema = z
+    .object({
+    exchanges: z
+        .array(DirectoryExchangeSchema)
+        .describe('List of telephony exchanges for the organization'),
+    name: z.string().describe('Name of the organization'),
+    orgId: OrganizationIdSchema.describe('Unique identifier for the organization'),
+})
+    .strict();
+export const TelephonyDirectorySchema = z
+    .object({
+    orgs: z
+        .array(DirectoryOrgSchema)
+        .describe('List of organizations participating in Hackfed Telephony Network.'),
+})
+    .meta({
+    description: 'Aggregated telephony service information for Hackfed network members.',
+    id: 'TelephonyDirectory',
+    title: 'Hackfed Telephony Directory',
+});
+export const __schemas = [TelephonyDirectorySchema];

package/dist/v1/entity/organization.d.ts

@@ -0,0 +1,128 @@
+import { z } from 'zod';
+export declare const OrganizationSchema: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    apiVersion: z.ZodLiteral<"hackfed/v1">;
+    kind: z.ZodLiteral<"Organization">;
+    metadata: z.ZodObject<{
+        orgId: z.ZodString;
+    }, z.core.$strip>;
+    spec: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        services: z.ZodOptional<z.ZodObject<{
+            about: z.ZodOptional<z.ZodObject<{
+                contact: z.ZodOptional<z.ZodObject<{
+                    email: z.ZodOptional<z.ZodEmail>;
+                    website: z.ZodOptional<z.ZodURL>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            access: z.ZodOptional<z.ZodObject<{
+                maintainers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"github">;
+                    username: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    email: z.ZodEmail;
+                    type: z.ZodLiteral<"email">;
+                }, z.core.$strip>], "type">>>;
+            }, z.core.$strict>>;
+            nebula: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                certificates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                lighthouse: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodBoolean;
+                    endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>>;
+            telephony: z.ZodOptional<z.ZodObject<{
+                exchanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    address: z.ZodString;
+                    codecs: z.ZodArray<z.ZodEnum<{
+                        opus: "opus";
+                        g722: "g722";
+                        ulaw: "ulaw";
+                    }>>;
+                    id: z.ZodString;
+                    protocol: z.ZodEnum<{
+                        iax2: "iax2";
+                    }>;
+                }, z.core.$strict>>>;
+                phonebook: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    format: z.ZodEnum<{
+                        hackfed: "hackfed";
+                    }>;
+                    url: z.ZodURL;
+                }, z.core.$strict>>>;
+                prefixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    exchange: z.ZodString;
+                    id: z.ZodString;
+                    prefix: z.ZodE164;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+}, z.core.$strip>;
+export type Organization = z.infer<typeof OrganizationSchema>;
+export declare const __schemas: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodURL>;
+    apiVersion: z.ZodLiteral<"hackfed/v1">;
+    kind: z.ZodLiteral<"Organization">;
+    metadata: z.ZodObject<{
+        orgId: z.ZodString;
+    }, z.core.$strip>;
+    spec: z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        services: z.ZodOptional<z.ZodObject<{
+            about: z.ZodOptional<z.ZodObject<{
+                contact: z.ZodOptional<z.ZodObject<{
+                    email: z.ZodOptional<z.ZodEmail>;
+                    website: z.ZodOptional<z.ZodURL>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>;
+            access: z.ZodOptional<z.ZodObject<{
+                maintainers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"github">;
+                    username: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    email: z.ZodEmail;
+                    type: z.ZodLiteral<"email">;
+                }, z.core.$strip>], "type">>>;
+            }, z.core.$strict>>;
+            nebula: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                address: z.ZodString;
+                certificates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                lighthouse: z.ZodOptional<z.ZodObject<{
+                    enabled: z.ZodBoolean;
+                    endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                }, z.core.$strict>>;
+            }, z.core.$strict>>>;
+            telephony: z.ZodOptional<z.ZodObject<{
+                exchanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    address: z.ZodString;
+                    codecs: z.ZodArray<z.ZodEnum<{
+                        opus: "opus";
+                        g722: "g722";
+                        ulaw: "ulaw";
+                    }>>;
+                    id: z.ZodString;
+                    protocol: z.ZodEnum<{
+                        iax2: "iax2";
+                    }>;
+                }, z.core.$strict>>>;
+                phonebook: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    format: z.ZodEnum<{
+                        hackfed: "hackfed";
+                    }>;
+                    url: z.ZodURL;
+                }, z.core.$strict>>>;
+                prefixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    description: z.ZodOptional<z.ZodString>;
+                    exchange: z.ZodString;
+                    id: z.ZodString;
+                    prefix: z.ZodE164;
+                }, z.core.$strict>>>;
+            }, z.core.$strict>>;
+        }, z.core.$strip>>;
+    }, z.core.$strict>;
+}, z.core.$strip>[];

package/dist/v1/entity/organization.js

@@ -0,0 +1,36 @@
+import { z } from 'zod';
+import { OrganizationIdSchema } from '../base/organization-id';
+import { ResourceDefinitionSchema } from '../base/resource-definition';
+import { AboutServiceSchema } from '../service/about';
+import { AccessServiceSchema } from '../service/access';
+import { NebulaServiceSchema } from '../service/nebula';
+import { TelephonyServiceSchema } from '../service/telephony';
+export const OrganizationSchema = ResourceDefinitionSchema
+    .extend({
+    spec: z
+        .object({
+        id: OrganizationIdSchema.describe('Organization ID (must match metadata.orgId)'),
+        name: z
+            .string()
+            .min(4)
+            .max(64)
+            .describe('Human-readable organization name'),
+        services: z
+            .object({
+            about: AboutServiceSchema.optional(),
+            access: AccessServiceSchema.optional(),
+            nebula: NebulaServiceSchema.optional(),
+            telephony: TelephonyServiceSchema.optional(),
+        })
+            .describe('Services provided by the organization')
+            .optional(),
+    })
+        .strict()
+        .describe('Organization specification'),
+})
+    .meta({
+    description: 'Complete organization entity definition for Hackfed registry',
+    id: 'Organization',
+    title: 'Hackfed Organization',
+});
+export const __schemas = [OrganizationSchema];

package/dist/v1/index.d.ts

@@ -0,0 +1,9 @@
+export { type Inet6Number, Inet6NumberSchema } from './base/inet6-number';
+export { type OrganizationId, OrganizationIdSchema } from './base/organization-id';
+export { type ResourceDefinition, ResourceDefinitionSchema } from './base/resource-definition';
+export { type TelephonyDirectory, TelephonyDirectorySchema } from './directory/telephony';
+export { type Organization, OrganizationSchema } from './entity/organization';
+export { type AboutService, AboutServiceSchema } from './service/about';
+export { type AccessService, AccessServiceSchema } from './service/access';
+export { type NebulaService, NebulaServiceSchema } from './service/nebula';
+export { type TelephonyService, TelephonyServiceSchema } from './service/telephony';

package/dist/v1/index.js

@@ -0,0 +1,13 @@
+// Base
+export { Inet6NumberSchema } from './base/inet6-number';
+export { OrganizationIdSchema } from './base/organization-id';
+export { ResourceDefinitionSchema } from './base/resource-definition';
+// Directories
+export { TelephonyDirectorySchema } from './directory/telephony';
+// Entities
+export { OrganizationSchema } from './entity/organization';
+// Services
+export { AboutServiceSchema } from './service/about';
+export { AccessServiceSchema } from './service/access';
+export { NebulaServiceSchema } from './service/nebula';
+export { TelephonyServiceSchema } from './service/telephony';

package/dist/v1/service/about.d.ts

@@ -0,0 +1,14 @@
+import { z } from 'zod';
+export declare const AboutServiceSchema: z.ZodObject<{
+    contact: z.ZodOptional<z.ZodObject<{
+        email: z.ZodOptional<z.ZodEmail>;
+        website: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type AboutService = z.infer<typeof AboutServiceSchema>;
+export declare const __schemas: z.ZodObject<{
+    contact: z.ZodOptional<z.ZodObject<{
+        email: z.ZodOptional<z.ZodEmail>;
+        website: z.ZodOptional<z.ZodURL>;
+    }, z.core.$strict>>;
+}, z.core.$strict>[];

package/{src/schemas/v1/service/about.ts → dist/v1/service/about.js}

@@ -1,23 +1,19 @@
-import { z } from 'zod'
-
+import { z } from 'zod';
 export const AboutServiceSchema = z
-  .object({
+    .object({
     contact: z
-      .object({
+        .object({
         email: z.email().describe("Organization's contact email address").optional(),
         website: z.url().describe("Organization's website URL").optional(),
-      })
-      .strict()
-      .describe('Contact information for the organization')
-      .optional(),
-  })
-  .strict()
-  .meta({
+    })
+        .strict()
+        .describe('Contact information for the organization')
+        .optional(),
+})
+    .strict()
+    .meta({
     description: 'Contact information and general details about an organization',
     id: 'AboutService',
     title: 'Organization About Service',
-  })
-
-export type AboutService = z.infer<typeof AboutServiceSchema>
-
-export const __schemas = [AboutServiceSchema]
+});
+export const __schemas = [AboutServiceSchema];

package/dist/v1/service/access.d.ts

@@ -0,0 +1,38 @@
+import { z } from 'zod';
+export declare const GithubMaintainerSchema: z.ZodObject<{
+    type: z.ZodLiteral<"github">;
+    username: z.ZodString;
+}, z.core.$strip>;
+export declare const EmailMaintainerSchema: z.ZodObject<{
+    email: z.ZodEmail;
+    type: z.ZodLiteral<"email">;
+}, z.core.$strip>;
+export declare const MaintainerSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    type: z.ZodLiteral<"github">;
+    username: z.ZodString;
+}, z.core.$strip>, z.ZodObject<{
+    email: z.ZodEmail;
+    type: z.ZodLiteral<"email">;
+}, z.core.$strip>], "type">;
+export declare const AccessServiceSchema: z.ZodObject<{
+    maintainers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"github">;
+        username: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        email: z.ZodEmail;
+        type: z.ZodLiteral<"email">;
+    }, z.core.$strip>], "type">>>;
+}, z.core.$strict>;
+export type AccessService = z.infer<typeof AccessServiceSchema>;
+export type Maintainer = z.infer<typeof MaintainerSchema>;
+export type GithubMaintainer = z.infer<typeof GithubMaintainerSchema>;
+export type EmailMaintainer = z.infer<typeof EmailMaintainerSchema>;
+export declare const __schemas: z.ZodObject<{
+    maintainers: z.ZodOptional<z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"github">;
+        username: z.ZodString;
+    }, z.core.$strip>, z.ZodObject<{
+        email: z.ZodEmail;
+        type: z.ZodLiteral<"email">;
+    }, z.core.$strip>], "type">>>;
+}, z.core.$strict>[];

package/dist/v1/service/access.js

@@ -0,0 +1,32 @@
+import { z } from 'zod';
+export const GithubMaintainerSchema = z
+    .object({
+    type: z.literal('github'),
+    username: z.string().describe('Username for GitHub type maintainers'),
+})
+    .describe('Maintainer identified by GitHub username');
+export const EmailMaintainerSchema = z
+    .object({
+    email: z.email().describe('Email address for email type maintainers'),
+    type: z.literal('email'),
+})
+    .describe('Maintainer identified by email address');
+export const MaintainerSchema = z.discriminatedUnion('type', [
+    GithubMaintainerSchema,
+    EmailMaintainerSchema,
+]);
+export const AccessServiceSchema = z
+    .object({
+    maintainers: z
+        .array(MaintainerSchema)
+        .min(1)
+        .describe('List of organization maintainers')
+        .optional(),
+})
+    .strict()
+    .meta({
+    description: 'Access control and maintainer information for an organization',
+    id: 'AccessService',
+    title: 'Organization Access Service',
+});
+export const __schemas = [AccessServiceSchema];

package/dist/v1/service/nebula.d.ts

@@ -0,0 +1,27 @@
+import { z } from 'zod';
+export declare const NebulaNodeSchema: z.ZodObject<{
+    address: z.ZodString;
+    certificates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    lighthouse: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export declare const NebulaServiceSchema: z.ZodArray<z.ZodObject<{
+    address: z.ZodString;
+    certificates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    lighthouse: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>;
+export type NebulaService = z.infer<typeof NebulaServiceSchema>;
+export type NebulaNode = z.infer<typeof NebulaNodeSchema>;
+export declare const __schemas: z.ZodArray<z.ZodObject<{
+    address: z.ZodString;
+    certificates: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    lighthouse: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodBoolean;
+        endpoints: z.ZodOptional<z.ZodArray<z.ZodString>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>>[];

package/dist/v1/service/nebula.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { Inet6NumberSchema } from '../base/inet6-number';
+export const NebulaNodeSchema = z
+    .object({
+    address: Inet6NumberSchema.describe('IPv6 address of the Nebula node'),
+    certificates: z
+        .array(z
+        .string()
+        .regex(/^[a-f0-9]{64}$/)
+        .describe('SHA-256 certificate fingerprint in hexadecimal'))
+        .min(1)
+        .describe('List of certificate fingerprints for the node')
+        .optional(),
+    lighthouse: z
+        .object({
+        enabled: z.boolean().describe('Whether this node acts as a lighthouse'),
+        endpoints: z
+            .array(z.string().describe('Endpoint in format host:port'))
+            .min(1)
+            .describe('Public endpoints for lighthouse connectivity')
+            .optional(),
+    })
+        .strict()
+        .describe('Lighthouse configuration for the node')
+        .optional(),
+})
+    .strict();
+export const NebulaServiceSchema = z.array(NebulaNodeSchema).meta({
+    description: 'Nebula VPN network configuration for the organization',
+    id: 'NebulaService',
+    title: 'Organization Nebula Service',
+});
+export const __schemas = [NebulaServiceSchema];

package/dist/v1/service/telephony.d.ts

@@ -0,0 +1,81 @@
+import { z } from 'zod';
+export declare const ExchangeSchema: z.ZodObject<{
+    address: z.ZodString;
+    codecs: z.ZodArray<z.ZodEnum<{
+        opus: "opus";
+        g722: "g722";
+        ulaw: "ulaw";
+    }>>;
+    id: z.ZodString;
+    protocol: z.ZodEnum<{
+        iax2: "iax2";
+    }>;
+}, z.core.$strict>;
+export declare const PrefixSchema: z.ZodObject<{
+    description: z.ZodOptional<z.ZodString>;
+    exchange: z.ZodString;
+    id: z.ZodString;
+    prefix: z.ZodE164;
+}, z.core.$strict>;
+export declare const PhonebookSchema: z.ZodObject<{
+    format: z.ZodEnum<{
+        hackfed: "hackfed";
+    }>;
+    url: z.ZodURL;
+}, z.core.$strict>;
+export declare const TelephonyServiceSchema: z.ZodObject<{
+    exchanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        codecs: z.ZodArray<z.ZodEnum<{
+            opus: "opus";
+            g722: "g722";
+            ulaw: "ulaw";
+        }>>;
+        id: z.ZodString;
+        protocol: z.ZodEnum<{
+            iax2: "iax2";
+        }>;
+    }, z.core.$strict>>>;
+    phonebook: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        format: z.ZodEnum<{
+            hackfed: "hackfed";
+        }>;
+        url: z.ZodURL;
+    }, z.core.$strict>>>;
+    prefixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        exchange: z.ZodString;
+        id: z.ZodString;
+        prefix: z.ZodE164;
+    }, z.core.$strict>>>;
+}, z.core.$strict>;
+export type TelephonyService = z.infer<typeof TelephonyServiceSchema>;
+export type Exchange = z.infer<typeof ExchangeSchema>;
+export type Prefix = z.infer<typeof PrefixSchema>;
+export type Phonebook = z.infer<typeof PhonebookSchema>;
+export declare const __schemas: z.ZodObject<{
+    exchanges: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        address: z.ZodString;
+        codecs: z.ZodArray<z.ZodEnum<{
+            opus: "opus";
+            g722: "g722";
+            ulaw: "ulaw";
+        }>>;
+        id: z.ZodString;
+        protocol: z.ZodEnum<{
+            iax2: "iax2";
+        }>;
+    }, z.core.$strict>>>;
+    phonebook: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        format: z.ZodEnum<{
+            hackfed: "hackfed";
+        }>;
+        url: z.ZodURL;
+    }, z.core.$strict>>>;
+    prefixes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        description: z.ZodOptional<z.ZodString>;
+        exchange: z.ZodString;
+        id: z.ZodString;
+        prefix: z.ZodE164;
+    }, z.core.$strict>>>;
+}, z.core.$strict>[];

package/{src/schemas/v1/service/telephony.ts → dist/v1/service/telephony.js}

@@ -1,54 +1,44 @@
-import { z } from 'zod'
-
+import { z } from 'zod';
 export const ExchangeSchema = z
-  .object({
+    .object({
     address: z
-      .string()
-      .describe('Network address and port of the exchange (e.g., [IPv6]:port or IPv4:port)'),
+        .string()
+        .describe('Network address and port of the exchange (e.g., [IPv6]:port or IPv4:port)'),
     codecs: z
-      .array(z.enum(['opus', 'g722', 'ulaw']))
-      .min(1)
-      .describe('Supported audio codecs'),
+        .array(z.enum(['opus', 'g722', 'ulaw']))
+        .min(1)
+        .describe('Supported audio codecs'),
     id: z.string().describe('Unique identifier for the exchange'),
     protocol: z.enum(['iax2']).describe('Telephony protocol used by the exchange'),
-  })
-  .strict()
-
+})
+    .strict();
 export const PrefixSchema = z
-  .object({
+    .object({
     description: z.string().describe('Human-readable description of the prefix').optional(),
     exchange: z.string().describe('Reference to the exchange ID handling this prefix'),
     id: z.string().describe('Unique identifier for the prefix'),
     prefix: z.e164().describe('Numeric prefix for phone numbers'),
-  })
-  .strict()
-
+})
+    .strict();
 export const PhonebookSchema = z
-  .object({
+    .object({
     format: z.enum(['hackfed']).describe('Format of the phonebook data'),
     url: z.url().describe('URL to the phonebook resource'),
-  })
-  .strict()
-
+})
+    .strict();
 export const TelephonyServiceSchema = z
-  .object({
+    .object({
     exchanges: z.array(ExchangeSchema).describe('List of telephony exchanges').optional(),
     phonebook: z.array(PhonebookSchema).describe('Public phonebook URLs').optional(),
     prefixes: z
-      .array(PrefixSchema)
-      .describe('Telephony number prefixes allocated to the organization')
-      .optional(),
-  })
-  .strict()
-  .meta({
+        .array(PrefixSchema)
+        .describe('Telephony number prefixes allocated to the organization')
+        .optional(),
+})
+    .strict()
+    .meta({
     description: 'Telephony configuration including exchanges, prefixes, and phonebook',
     id: 'TelephonyService',
     title: 'Organization Telephony Service',
-  })
-
-export type TelephonyService = z.infer<typeof TelephonyServiceSchema>
-export type Exchange = z.infer<typeof ExchangeSchema>
-export type Prefix = z.infer<typeof PrefixSchema>
-export type Phonebook = z.infer<typeof PhonebookSchema>
-
-export const __schemas = [TelephonyServiceSchema]
+});
+export const __schemas = [TelephonyServiceSchema];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hackfed/schemas",
-  "version": "0.0.5",
+  "version": "0.2.0",
   "license": "MIT",
   "type": "module",
   "repository": {
@@ -8,10 +8,13 @@
     "url": "git+https://github.com/hackfed/schemas.git"
   },
   "exports": {
-    "./*": "./src/schemas/*"
+    "./v1": {
+      "import": "./dist/v1/index.js",
+      "types": "./dist/v1/index.d.ts"
+    }
   },
   "files": [
-    "src/schemas",
+    "dist",
     "LICENSE",
     "README"
   ],
@@ -22,6 +25,7 @@
     "change-case": "^5.4.4",
     "eslint": "^9.39.2",
     "glob": "^13.0.0",
+    "rimraf": "^6.1.2",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "zod": "4"
@@ -30,6 +34,8 @@
     "zod": "4"
   },
   "scripts": {
-    "generate": "tsx src/cmd/generate-json-schemas.ts"
+    "generate": "tsx src/cmd/generate-json-schemas.ts",
+    "build": "rimraf dist && tsc",
+    "lint": "tsc --noEmit && eslint ."
   }
 }

package/src/schemas/index.ts

@@ -1 +0,0 @@
-/* eslint-disable-next-line unicorn/no-empty-file -- this is a stub file. */

package/src/schemas/v1/base/inet6-number.ts

@@ -1,17 +0,0 @@
-import { z } from 'zod'
-
-export const Inet6NumberSchema = z
-  .string()
-  .regex(
-    /^(((?:[0-9A-Fa-f]{1,4}))*((?::[0-9A-Fa-f]{1,4}))*::((?:[0-9A-Fa-f]{1,4}))*((?::[0-9A-Fa-f]{1,4}))*|((?:[0-9A-Fa-f]{1,4}))((?::[0-9A-Fa-f]{1,4})){7})(\/([1-9]|[1-9][0-9]|1[0-1][0-9]|12[0-8])){0,1}$/
-  )
-  .meta({
-    description: 'An IPv6 address in standard notation',
-    examples: ['fd79:7636:1f08:883d::008', '2001:db8::1', '::1', 'fe80::1/128'],
-    id: 'Inet6Number',
-    title: 'IPv6 Address',
-  })
-
-export type Inet6Number = z.infer<typeof Inet6NumberSchema>
-
-export const __schemas = [Inet6NumberSchema]

package/src/schemas/v1/base/organization-id.ts

@@ -1,17 +0,0 @@
-import { z } from 'zod'
-
-export const OrganizationIdSchema = z
-  .string()
-  .regex(/^[a-z0-9]*$/)
-  .min(4)
-  .max(16)
-  .meta({
-    description: 'A unique identifier for an organization in the Hackfed registry',
-    examples: ['bksp', 'xkem'],
-    id: 'OrganizationId',
-    title: 'Organization ID',
-  })
-
-export type OrganizationId = z.infer<typeof OrganizationIdSchema>
-
-export const __schemas = [OrganizationIdSchema]

package/src/schemas/v1/directory/telephony.ts

@@ -1,48 +0,0 @@
-import { z } from 'zod'
-
-import { OrganizationIdSchema } from '../base/organization-id'
-
-export const DirectoryExchangeSchema = z
-  .object({
-    codecs: z
-      .array(z.enum(['opus', 'g722', 'ulaw']))
-      .min(1)
-      .describe('Supported audio codecs'),
-    endpoint: z
-      .string()
-      .describe('Network address and port of the exchange (e.g., [IPv6]:port or IPv4:port)'),
-    id: z.string().describe('Unique exchange identifier within the organization'),
-    prefixes: z
-      .array(z.e164().describe('Telephony number prefix (e.g., country or area code)'))
-      .describe('Telephony number prefixes allocated to the organization for this exchange'),
-    protocol: z.enum(['iax2']).describe('Telephony protocol used by the exchange'),
-  })
-  .strict()
-
-export const DirectoryOrgSchema = z
-  .object({
-    exchanges: z
-      .array(DirectoryExchangeSchema)
-      .describe('List of telephony exchanges for the organization'),
-    name: z.string().describe('Name of the organization'),
-    orgId: OrganizationIdSchema.describe('Unique identifier for the organization'),
-  })
-  .strict()
-
-export const TelephonyDirectorySchema = z
-  .object({
-    orgs: z
-      .array(DirectoryOrgSchema)
-      .describe('List of organizations participating in Hackfed Telephony Network.'),
-  })
-  .meta({
-    description: 'Aggregated telephony service information for Hackfed network members.',
-    id: 'TelephonyDirectory',
-    title: 'Hackfed Telephony Directory',
-  })
-
-export type TelephonyDirectory = z.infer<typeof TelephonyDirectorySchema>
-export type DirectoryOrg = z.infer<typeof DirectoryOrgSchema>
-export type DirectoryExchange = z.infer<typeof DirectoryExchangeSchema>
-
-export const __schemas = [TelephonyDirectorySchema]

package/src/schemas/v1/entity/organization.ts

@@ -1,47 +0,0 @@
-import { z } from 'zod'
-
-import { OrganizationIdSchema } from '../base/organization-id'
-import { AboutServiceSchema } from '../service/about'
-import { AccessServiceSchema } from '../service/access'
-import { NebulaServiceSchema } from '../service/nebula'
-import { TelephonyServiceSchema } from '../service/telephony'
-
-export const OrganizationSchema = z
-  .object({
-    apiVersion: z.literal('hackfed/v1').describe('API version identifier'),
-    kind: z.literal('Organization').describe('Resource type'),
-    metadata: z
-      .object({
-        orgId: OrganizationIdSchema.describe('Identifier of the organization owning this resource'),
-      })
-      .describe('Metadata about the organization'),
-    spec: z
-      .object({
-        id: OrganizationIdSchema.describe('Organization ID (must match metadata.orgId)'),
-        name: z
-          .string()
-          .min(4)
-          .max(64)
-          .describe('Human-readable organization name'),
-        services: z
-          .object({
-            about: AboutServiceSchema.optional(),
-            access: AccessServiceSchema.optional(),
-            nebula: NebulaServiceSchema.optional(),
-            telephony: TelephonyServiceSchema.optional(),
-          })
-          .describe('Services provided by the organization')
-          .optional(),
-      })
-      .strict()
-      .describe('Organization specification'),
-  })
-  .meta({
-    description: 'Complete organization entity definition for Hackfed registry',
-    id: 'Organization',
-    title: 'Hackfed Organization',
-  })
-
-export type Organization = z.infer<typeof OrganizationSchema>
-
-export const __schemas = [OrganizationSchema]

package/src/schemas/v1/service/access.ts

@@ -1,42 +0,0 @@
-import { z } from 'zod'
-
-export const GithubMaintainerSchema = z
-  .object({
-    type: z.literal('github'),
-    username: z.string().describe('Username for GitHub type maintainers'),
-  })
-  .describe('Maintainer identified by GitHub username')
-
-export const EmailMaintainerSchema = z
-  .object({
-    email: z.email().describe('Email address for email type maintainers'),
-    type: z.literal('email'),
-  })
-  .describe('Maintainer identified by email address')
-
-export const MaintainerSchema = z.discriminatedUnion('type', [
-  GithubMaintainerSchema,
-  EmailMaintainerSchema,
-])
-
-export const AccessServiceSchema = z
-  .object({
-    maintainers: z
-      .array(MaintainerSchema)
-      .min(1)
-      .describe('List of organization maintainers')
-      .optional(),
-  })
-  .strict()
-  .meta({
-    description: 'Access control and maintainer information for an organization',
-    id: 'AccessService',
-    title: 'Organization Access Service',
-  })
-
-export type AccessService = z.infer<typeof AccessServiceSchema>
-export type Maintainer = z.infer<typeof MaintainerSchema>
-export type GithubMaintainer = z.infer<typeof GithubMaintainerSchema>
-export type EmailMaintainer = z.infer<typeof EmailMaintainerSchema>
-
-export const __schemas = [AccessServiceSchema]

package/src/schemas/v1/service/nebula.ts

@@ -1,42 +0,0 @@
-import { z } from 'zod'
-
-import { Inet6NumberSchema } from '../base/inet6-number'
-
-export const NebulaNodeSchema = z
-  .object({
-    address: Inet6NumberSchema.describe('IPv6 address of the Nebula node'),
-    certificates: z
-      .array(
-        z
-          .string()
-          .regex(/^[a-f0-9]{64}$/)
-          .describe('SHA-256 certificate fingerprint in hexadecimal')
-      )
-      .min(1)
-      .describe('List of certificate fingerprints for the node')
-      .optional(),
-    lighthouse: z
-      .object({
-        enabled: z.boolean().describe('Whether this node acts as a lighthouse'),
-        endpoints: z
-          .array(z.string().describe('Endpoint in format host:port'))
-          .min(1)
-          .describe('Public endpoints for lighthouse connectivity')
-          .optional(),
-      })
-      .strict()
-      .describe('Lighthouse configuration for the node')
-      .optional(),
-  })
-  .strict()
-
-export const NebulaServiceSchema = z.array(NebulaNodeSchema).meta({
-  description: 'Nebula VPN network configuration for the organization',
-  id: 'NebulaService',
-  title: 'Organization Nebula Service',
-})
-
-export type NebulaService = z.infer<typeof NebulaServiceSchema>
-export type NebulaNode = z.infer<typeof NebulaNodeSchema>
-
-export const __schemas = [NebulaServiceSchema]