@objectstack/spec 0.1.0 → 0.1.2

package/dist/index.d.ts

@@ -1,10 +1,46 @@
 /**
- * ObjectStack Specification
+ * @objectstack/spec
  *
- * This module provides the core type definitions and interfaces for the ObjectStack ecosystem.
- * It defines the contract between backend (ObjectQL) parsers and frontend (ObjectUI) renderers.
+ * ObjectStack Protocol & Specification
  *
- * @packageDocumentation
+ * This package contains the core interfaces, schemas, and conventions for the ObjectStack ecosystem.
+ * All types and schemas are centralized here.
  */
-export * from './types';
+export * from './data/field.zod';
+export * from './data/object.zod';
+export * from './data/validation.zod';
+export * from './data/permission.zod';
+export * from './data/sharing.zod';
+export * from './data/workflow.zod';
+export * from './data/flow.zod';
+export * from './data/dataset.zod';
+export * from './data/query.zod';
+export * from './data/mapping.zod';
+export * from './data/trigger.zod';
+export * from './api/contract.zod';
+export * from './ai/agent.zod';
+export * from './ui/app.zod';
+export * from './ui/view.zod';
+export * from './ui/dashboard.zod';
+export * from './ui/report.zod';
+export * from './ui/action.zod';
+export * from './ui/page.zod';
+export * from './ui/widget.zod';
+export * from './ui/theme.zod';
+export * from './system/manifest.zod';
+export * from './system/datasource.zod';
+export * from './system/api.zod';
+export * from './system/identity.zod';
+export * from './system/policy.zod';
+export * from './system/role.zod';
+export * from './system/territory.zod';
+export * from './system/license.zod';
+export * from './system/webhook.zod';
+export * from './system/translation.zod';
+export * from './system/driver.zod';
+export * from './system/constants';
+export * from './system/types';
+export * from './system/discovery.zod';
+export * from './system/plugin.zod';
+export * from './system/driver.zod';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,oBAAoB,CAAC;AAGnC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,cAAc,CAAC;AAC7B,cAAc,eAAe,CAAC;AAC9B,cAAc,oBAAoB,CAAC;AACnC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAG/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -1,9 +1,66 @@
+"use strict";
 /**
- * ObjectStack Specification
+ * @objectstack/spec
  *
- * This module provides the core type definitions and interfaces for the ObjectStack ecosystem.
- * It defines the contract between backend (ObjectQL) parsers and frontend (ObjectUI) renderers.
+ * ObjectStack Protocol & Specification
  *
- * @packageDocumentation
+ * This package contains the core interfaces, schemas, and conventions for the ObjectStack ecosystem.
+ * All types and schemas are centralized here.
  */
-export * from './types';
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Data Protocol (Schema, Validation, Logic)
+__exportStar(require("./data/field.zod"), exports);
+__exportStar(require("./data/object.zod"), exports);
+__exportStar(require("./data/validation.zod"), exports);
+__exportStar(require("./data/permission.zod"), exports);
+__exportStar(require("./data/sharing.zod"), exports);
+__exportStar(require("./data/workflow.zod"), exports);
+__exportStar(require("./data/flow.zod"), exports);
+__exportStar(require("./data/dataset.zod"), exports);
+__exportStar(require("./data/query.zod"), exports);
+__exportStar(require("./data/mapping.zod"), exports);
+__exportStar(require("./data/trigger.zod"), exports);
+// API Protocol (Envelopes, Contracts)
+__exportStar(require("./api/contract.zod"), exports);
+// AI Protocol (Agent, RAG)
+__exportStar(require("./ai/agent.zod"), exports);
+// UI Protocol (Layout, Navigation, Interaction)
+__exportStar(require("./ui/app.zod"), exports);
+__exportStar(require("./ui/view.zod"), exports);
+__exportStar(require("./ui/dashboard.zod"), exports);
+__exportStar(require("./ui/report.zod"), exports);
+__exportStar(require("./ui/action.zod"), exports);
+__exportStar(require("./ui/page.zod"), exports);
+__exportStar(require("./ui/widget.zod"), exports);
+__exportStar(require("./ui/theme.zod"), exports);
+// System Protocol (Manifest, Runtime, Constants)
+__exportStar(require("./system/manifest.zod"), exports);
+__exportStar(require("./system/datasource.zod"), exports);
+__exportStar(require("./system/api.zod"), exports);
+__exportStar(require("./system/identity.zod"), exports);
+__exportStar(require("./system/policy.zod"), exports);
+__exportStar(require("./system/role.zod"), exports);
+__exportStar(require("./system/territory.zod"), exports);
+__exportStar(require("./system/license.zod"), exports);
+__exportStar(require("./system/webhook.zod"), exports);
+__exportStar(require("./system/translation.zod"), exports);
+__exportStar(require("./system/driver.zod"), exports); // Export Driver Protocol
+__exportStar(require("./system/constants"), exports);
+__exportStar(require("./system/types"), exports);
+__exportStar(require("./system/discovery.zod"), exports);
+__exportStar(require("./system/plugin.zod"), exports);
+__exportStar(require("./system/driver.zod"), exports);

package/dist/system/api.zod.d.ts

@@ -0,0 +1,294 @@
+import { z } from 'zod';
+/**
+ * HTTP Method Enum
+ */
+export declare const HttpMethod: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH"]>;
+/**
+ * Rate Limit Strategy
+ */
+export declare const RateLimitSchema: z.ZodObject<{
+    enabled: z.ZodDefault<z.ZodBoolean>;
+    windowMs: z.ZodDefault<z.ZodNumber>;
+    maxRequests: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    windowMs: number;
+    maxRequests: number;
+}, {
+    enabled?: boolean | undefined;
+    windowMs?: number | undefined;
+    maxRequests?: number | undefined;
+}>;
+/**
+ * API Mapping Schema
+ * Transform input/output data.
+ */
+export declare const ApiMappingSchema: z.ZodObject<{
+    source: z.ZodString;
+    target: z.ZodString;
+    transform: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    source: string;
+    target: string;
+    transform?: string | undefined;
+}, {
+    source: string;
+    target: string;
+    transform?: string | undefined;
+}>;
+/**
+ * API Endpoint Schema
+ * Defines an external facing API contract.
+ */
+export declare const ApiEndpointSchema: z.ZodObject<{
+    /** Identity */
+    name: z.ZodString;
+    path: z.ZodString;
+    method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH"]>;
+    /** Documentation */
+    summary: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    /** Execution Logic */
+    type: z.ZodEnum<["flow", "script", "object_operation", "proxy"]>;
+    target: z.ZodString;
+    /** Logic Config */
+    objectParams: z.ZodOptional<z.ZodObject<{
+        object: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodEnum<["find", "get", "create", "update", "delete"]>>;
+    }, "strip", z.ZodTypeAny, {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    }, {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    }>>;
+    /** Data Transformation */
+    inputMapping: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        transform: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }>, "many">>;
+    outputMapping: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        transform: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }>, "many">>;
+    /** Policies */
+    authRequired: z.ZodDefault<z.ZodBoolean>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        windowMs: z.ZodDefault<z.ZodNumber>;
+        maxRequests: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        windowMs: number;
+        maxRequests: number;
+    }, {
+        enabled?: boolean | undefined;
+        windowMs?: number | undefined;
+        maxRequests?: number | undefined;
+    }>>;
+    cacheTtl: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "script" | "flow" | "object_operation" | "proxy";
+    name: string;
+    target: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    authRequired: boolean;
+    summary?: string | undefined;
+    description?: string | undefined;
+    objectParams?: {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    } | undefined;
+    inputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    outputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    rateLimit?: {
+        enabled: boolean;
+        windowMs: number;
+        maxRequests: number;
+    } | undefined;
+    cacheTtl?: number | undefined;
+}, {
+    path: string;
+    type: "script" | "flow" | "object_operation" | "proxy";
+    name: string;
+    target: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    summary?: string | undefined;
+    description?: string | undefined;
+    objectParams?: {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    } | undefined;
+    inputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    outputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    authRequired?: boolean | undefined;
+    rateLimit?: {
+        enabled?: boolean | undefined;
+        windowMs?: number | undefined;
+        maxRequests?: number | undefined;
+    } | undefined;
+    cacheTtl?: number | undefined;
+}>;
+export declare const ApiEndpoint: z.ZodObject<{
+    /** Identity */
+    name: z.ZodString;
+    path: z.ZodString;
+    method: z.ZodEnum<["GET", "POST", "PUT", "DELETE", "PATCH"]>;
+    /** Documentation */
+    summary: z.ZodOptional<z.ZodString>;
+    description: z.ZodOptional<z.ZodString>;
+    /** Execution Logic */
+    type: z.ZodEnum<["flow", "script", "object_operation", "proxy"]>;
+    target: z.ZodString;
+    /** Logic Config */
+    objectParams: z.ZodOptional<z.ZodObject<{
+        object: z.ZodOptional<z.ZodString>;
+        operation: z.ZodOptional<z.ZodEnum<["find", "get", "create", "update", "delete"]>>;
+    }, "strip", z.ZodTypeAny, {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    }, {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    }>>;
+    /** Data Transformation */
+    inputMapping: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        transform: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }>, "many">>;
+    outputMapping: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        source: z.ZodString;
+        target: z.ZodString;
+        transform: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }, {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }>, "many">>;
+    /** Policies */
+    authRequired: z.ZodDefault<z.ZodBoolean>;
+    rateLimit: z.ZodOptional<z.ZodObject<{
+        enabled: z.ZodDefault<z.ZodBoolean>;
+        windowMs: z.ZodDefault<z.ZodNumber>;
+        maxRequests: z.ZodDefault<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        enabled: boolean;
+        windowMs: number;
+        maxRequests: number;
+    }, {
+        enabled?: boolean | undefined;
+        windowMs?: number | undefined;
+        maxRequests?: number | undefined;
+    }>>;
+    cacheTtl: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    type: "script" | "flow" | "object_operation" | "proxy";
+    name: string;
+    target: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    authRequired: boolean;
+    summary?: string | undefined;
+    description?: string | undefined;
+    objectParams?: {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    } | undefined;
+    inputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    outputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    rateLimit?: {
+        enabled: boolean;
+        windowMs: number;
+        maxRequests: number;
+    } | undefined;
+    cacheTtl?: number | undefined;
+}, {
+    path: string;
+    type: "script" | "flow" | "object_operation" | "proxy";
+    name: string;
+    target: string;
+    method: "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+    summary?: string | undefined;
+    description?: string | undefined;
+    objectParams?: {
+        object?: string | undefined;
+        operation?: "find" | "get" | "create" | "update" | "delete" | undefined;
+    } | undefined;
+    inputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    outputMapping?: {
+        source: string;
+        target: string;
+        transform?: string | undefined;
+    }[] | undefined;
+    authRequired?: boolean | undefined;
+    rateLimit?: {
+        enabled?: boolean | undefined;
+        windowMs?: number | undefined;
+        maxRequests?: number | undefined;
+    } | undefined;
+    cacheTtl?: number | undefined;
+}> & {
+    create: <T extends z.input<typeof ApiEndpointSchema>>(config: T) => T;
+};
+export type ApiEndpoint = z.infer<typeof ApiEndpointSchema>;
+//# sourceMappingURL=api.zod.d.ts.map

package/dist/system/api.zod.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.zod.d.ts","sourceRoot":"","sources":["../../src/system/api.zod.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;GAEG;AACH,eAAO,MAAM,UAAU,sDAAoD,CAAC;AAE5E;;GAEG;AACH,eAAO,MAAM,eAAe;;;;;;;;;;;;EAI1B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;EAI3B,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,iBAAiB;IAC5B,eAAe;;;;IAKf,oBAAoB;;;IAIpB,sBAAsB;;;IAItB,mBAAmB;;;;;;;;;;;IAMnB,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI1B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAIf,CAAC;AAEH,eAAO,MAAM,WAAW;IA7BtB,eAAe;;;;IAKf,oBAAoB;;;IAIpB,sBAAsB;;;IAItB,mBAAmB;;;;;;;;;;;IAMnB,0BAA0B;;;;;;;;;;;;;;;;;;;;;;;;;;;IAI1B,eAAe;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;aAON,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,UAAU,CAAC;CAC/D,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/dist/system/api.zod.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiEndpoint = exports.ApiEndpointSchema = exports.ApiMappingSchema = exports.RateLimitSchema = exports.HttpMethod = void 0;
+const zod_1 = require("zod");
+/**
+ * HTTP Method Enum
+ */
+exports.HttpMethod = zod_1.z.enum(['GET', 'POST', 'PUT', 'DELETE', 'PATCH']);
+/**
+ * Rate Limit Strategy
+ */
+exports.RateLimitSchema = zod_1.z.object({
+    enabled: zod_1.z.boolean().default(false),
+    windowMs: zod_1.z.number().default(60000).describe('Time window in milliseconds'),
+    maxRequests: zod_1.z.number().default(100).describe('Max requests per window'),
+});
+/**
+ * API Mapping Schema
+ * Transform input/output data.
+ */
+exports.ApiMappingSchema = zod_1.z.object({
+    source: zod_1.z.string().describe('Source field/path'),
+    target: zod_1.z.string().describe('Target field/path'),
+    transform: zod_1.z.string().optional().describe('Transformation function name'),
+});
+/**
+ * API Endpoint Schema
+ * Defines an external facing API contract.
+ */
+exports.ApiEndpointSchema = zod_1.z.object({
+    /** Identity */
+    name: zod_1.z.string().regex(/^[a-z_][a-z0-9_]*$/).describe('Unique endpoint ID'),
+    path: zod_1.z.string().regex(/^\//).describe('URL Path (e.g. /api/v1/customers)'),
+    method: exports.HttpMethod.describe('HTTP Method'),
+    /** Documentation */
+    summary: zod_1.z.string().optional(),
+    description: zod_1.z.string().optional(),
+    /** Execution Logic */
+    type: zod_1.z.enum(['flow', 'script', 'object_operation', 'proxy']).describe('Implementation type'),
+    target: zod_1.z.string().describe('Target Flow ID, Script Name, or Proxy URL'),
+    /** Logic Config */
+    objectParams: zod_1.z.object({
+        object: zod_1.z.string().optional(),
+        operation: zod_1.z.enum(['find', 'get', 'create', 'update', 'delete']).optional(),
+    }).optional().describe('For object_operation type'),
+    /** Data Transformation */
+    inputMapping: zod_1.z.array(exports.ApiMappingSchema).optional().describe('Map Request Body to Internal Params'),
+    outputMapping: zod_1.z.array(exports.ApiMappingSchema).optional().describe('Map Internal Result to Response Body'),
+    /** Policies */
+    authRequired: zod_1.z.boolean().default(true).describe('Require authentication'),
+    rateLimit: exports.RateLimitSchema.optional().describe('Rate limiting policy'),
+    cacheTtl: zod_1.z.number().optional().describe('Response cache TTL in seconds'),
+});
+exports.ApiEndpoint = Object.assign(exports.ApiEndpointSchema, {
+    create: (config) => config,
+});

package/dist/system/constants/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * ObjectStack Convention Constants
+ *
+ * This package defines the "Law of Location" - where things must be in ObjectStack packages.
+ * These paths are used by ObjectOS Runtime, ObjectStack CLI, and ObjectStudio IDE.
+ *
+ * Guiding Principle: "Strict Types, No Logic"
+ * This package has NO database connections, NO UI components, and NO runtime business logic.
+ */
+export * from './paths';
+//# sourceMappingURL=index.d.ts.map

package/dist/system/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/system/constants/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,SAAS,CAAC"}

package/dist/system/constants/index.js

@@ -0,0 +1,26 @@
+"use strict";
+/**
+ * ObjectStack Convention Constants
+ *
+ * This package defines the "Law of Location" - where things must be in ObjectStack packages.
+ * These paths are used by ObjectOS Runtime, ObjectStack CLI, and ObjectStudio IDE.
+ *
+ * Guiding Principle: "Strict Types, No Logic"
+ * This package has NO database connections, NO UI components, and NO runtime business logic.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./paths"), exports);

package/dist/system/constants/paths.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Package conventions and directory structure constants.
+ * These define the "Law of Location" - where things must be in ObjectStack packages.
+ *
+ * These paths are the source of truth used by:
+ * - ObjectOS Runtime (to locate package components)
+ * - ObjectStack CLI (to scaffold and validate packages)
+ * - ObjectStudio IDE (to provide intelligent navigation and validation)
+ */
+export declare const PKG_CONVENTIONS: {
+    /**
+     * Standard directories within ObjectStack packages.
+     * All packages MUST follow these conventions for the runtime to locate resources.
+     */
+    readonly DIRS: {
+        /**
+         * Location for schema definitions (Zod schemas, JSON schemas).
+         * Path: src/schemas
+         */
+        readonly SCHEMA: "src/schemas";
+        /**
+         * Location for server-side code and triggers.
+         * Path: src/server
+         */
+        readonly SERVER: "src/server";
+        /**
+         * Location for server-side trigger functions.
+         * Path: src/triggers
+         */
+        readonly TRIGGERS: "src/triggers";
+        /**
+         * Location for client-side code.
+         * Path: src/client
+         */
+        readonly CLIENT: "src/client";
+        /**
+         * Location for client-side page components.
+         * Path: src/client/pages
+         */
+        readonly PAGES: "src/client/pages";
+        /**
+         * Location for static assets (images, fonts, etc.).
+         * Path: assets
+         */
+        readonly ASSETS: "assets";
+    };
+    /**
+     * Standard file names within ObjectStack packages.
+     */
+    readonly FILES: {
+        /**
+         * Package manifest configuration file.
+         * File: objectstack.config.ts
+         */
+        readonly MANIFEST: "objectstack.config.ts";
+        /**
+         * Main entry point for the package.
+         * File: src/index.ts
+         */
+        readonly ENTRY: "src/index.ts";
+    };
+};
+/**
+ * Type helper to extract directory path values.
+ */
+export type PackageDirectory = typeof PKG_CONVENTIONS.DIRS[keyof typeof PKG_CONVENTIONS.DIRS];
+/**
+ * Type helper to extract file path values.
+ */
+export type PackageFile = typeof PKG_CONVENTIONS.FILES[keyof typeof PKG_CONVENTIONS.FILES];
+//# sourceMappingURL=paths.d.ts.map

package/dist/system/constants/paths.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"paths.d.ts","sourceRoot":"","sources":["../../../src/system/constants/paths.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,eAAe;IAC1B;;;OAGG;;QAED;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;QAGH;;;WAGG;;;IAIL;;OAEG;;QAED;;;WAGG;;QAGH;;;WAGG;;;CAGG,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,eAAe,CAAC,IAAI,CAAC,MAAM,OAAO,eAAe,CAAC,IAAI,CAAC,CAAC;AAE9F;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,eAAe,CAAC,KAAK,CAAC,MAAM,OAAO,eAAe,CAAC,KAAK,CAAC,CAAC"}

package/dist/system/constants/paths.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PKG_CONVENTIONS = void 0;
+/**
+ * Package conventions and directory structure constants.
+ * These define the "Law of Location" - where things must be in ObjectStack packages.
+ *
+ * These paths are the source of truth used by:
+ * - ObjectOS Runtime (to locate package components)
+ * - ObjectStack CLI (to scaffold and validate packages)
+ * - ObjectStudio IDE (to provide intelligent navigation and validation)
+ */
+exports.PKG_CONVENTIONS = {
+    /**
+     * Standard directories within ObjectStack packages.
+     * All packages MUST follow these conventions for the runtime to locate resources.
+     */
+    DIRS: {
+        /**
+         * Location for schema definitions (Zod schemas, JSON schemas).
+         * Path: src/schemas
+         */
+        SCHEMA: 'src/schemas',
+        /**
+         * Location for server-side code and triggers.
+         * Path: src/server
+         */
+        SERVER: 'src/server',
+        /**
+         * Location for server-side trigger functions.
+         * Path: src/triggers
+         */
+        TRIGGERS: 'src/triggers',
+        /**
+         * Location for client-side code.
+         * Path: src/client
+         */
+        CLIENT: 'src/client',
+        /**
+         * Location for client-side page components.
+         * Path: src/client/pages
+         */
+        PAGES: 'src/client/pages',
+        /**
+         * Location for static assets (images, fonts, etc.).
+         * Path: assets
+         */
+        ASSETS: 'assets',
+    },
+    /**
+     * Standard file names within ObjectStack packages.
+     */
+    FILES: {
+        /**
+         * Package manifest configuration file.
+         * File: objectstack.config.ts
+         */
+        MANIFEST: 'objectstack.config.ts',
+        /**
+         * Main entry point for the package.
+         * File: src/index.ts
+         */
+        ENTRY: 'src/index.ts',
+    },
+};